skill-standardization — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited skill-standardization (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
scripts/ 下的 Python 脚本原子写入SKILL.md / _meta.json / CHANGELOG.mdaudit --verify 验证,非误报项必须全部修复,exit(0) 方可提交--classify ID --category engine_mistake/engine_cant_judge --reason "..."(如 --classify 42 --category engine_mistake --reason "BOM字符导致frontmatter未识别"),不得跳过或笼统说"无需处理"。WARN 就是真问题,不是"样式建议"——没有"可跳过"类别。.remaining_llm.json 时,LLM 必须立即读取并手动修复,然后重新审计直到 0 ERROR 0 WARN。禁止询问用户、禁止停止、禁止跳过audit 执行完毕,必须确认 .audit_report.html 已生成,且必须调用 present_files 工具打开报告让用户查看【模式=xxx】(如 【模式=refactor】)【模式=xxx】(即找不到匹配),必须回退重走步骤1,不得跳过、不得默认、不得猜【模式=xxx】 后,执行 CLI 命令时必须同时传入 `--mode xxx` 参数:--mode 值与当前子命令是否一致,不一致则 exit(1) 拒绝执行audit --mode refactor → ❌ 阻断refactor --mode refactor → ✅ 放行--mode → ❌ 阻断(exit 1),拒绝执行正向触发:
否定条件:
📚 渐进式加载:本技能采用渐进式 MD 体系,SKILL.md为入口(≤230行),详细内容拆分到references/*.md按需加载。
| 文件名 | 分类 | 包含内容 | 审计关联 |
|---|---|---|---|
references/LICENSE.md | 许可协议 | 开源许可证声明(MIT)。包含:MIT 许可证完整文本。 | R-26 |
references/antipatterns.md | 规范指南 | skill 编写中的常见反模式。包含:错误做法示例、正确做法示例、避坑指引。 | R-18 |
references/architecture.md | 架构设计 | skill-standardization 整体架构。包含:模块关系、数据流、核心设计决策。 | 无 |
references/blueprint_flow.md | 参考文档 | > 定义蓝皮书(Blueprint)、审计(Audit)、修复循环(Fix Loop)三者的关系与流程。 | 无 |
references/changelog.md | 版本管理 | 版本更新日志。包含:版本号、更新类型、修复项、升级说明。 | R-24 |
references/data_dir_map.md | 路径参考 | 数据目录路径对照表。包含:安装目录、标准化目录、备份目录及用途。 | 无 |
references/examples.md | 使用示例 | 各场景完整执行示例。包含:CLI 命令、执行过程、输出结果。 | R-25 C-17 |
references/faq.md | 常见问题 | 常见疑问与解答。包含:问题分类、原因分析、解决方案。 | R-19, R-25 C-19 |
references/guide.md | 使用指南 | 六种执行模式完整操作教程。包含:audit/create/update/refactor/bump/readonly 流程、参数说明、注意事项。 | 无 |
references/permissions.md | 权限与测试 | 权限扫描说明与测试结论。包含:风险等级、高权限操作说明、测试概览、计时统计。 | R-15, R-16 |
references/reference.md | 命令参考 | ⛔ 已废弃。完整命令参考请见 references/guide.md,审计规则见 references/rules.md。 | 无 |
references/rules.md | 审计规则 | R-01~R-26 审计规则定义。包含:检查逻辑、修复指引、设计背景。 | R-01~R-26 |
本技能能做什么、不能做什么,一目了然:
| 能力 | 说明 | 限制 |
|---|---|---|
| 审计现有 skill | R-01~R-26 全量检查,输出 PASS/WARN/FAIL 逐条明细及上下文行 | 仅检查 SKILL.md + _meta.json + scripts/ 文件结构和代码静态分析,不检查 Python 运行时行为 |
| 创建新 skill | 从模板生成标准骨架(SKILL.md / _meta.json / references/ / scripts/) | 只生成结构模板和占位符,功能代码需要手动填充 |
| 改造非标 skill | 自动迁移文件到正确位置、补充 permissions.md、修复格式问题 | 不处理跨技能依赖、不自动生成功能代码 |
| 批量审计 | audit-all 子命令扫描 skills/ 下多个 skill | 遍历 skills/ 下的所有一级子目录(不支持嵌套目录),每个子目录中的非技能目录需自行排除 |
| 自动修复 | --fix 自动修正 SKILL.md frontmatter / 版本号 / 数据目录 / 触发词 / 反模式 / FAQ / 写作规范等格式问题,覆盖 R-01~R-26 共 20+ 条规则 | 仅修复格式/结构/路径/生成类问题,不修复代码逻辑错误。<br>修复后需运行 --verify + --show-fix 两阶段验证确认 |
| 权限安全扫描 | 自动检测脚本中的文件删除/网络请求/subprocess 调用 | 扫描基于 AST 静态分析,无法检测动态代码执行的权限需求 |
触发本技能后立即可见的能力输出:读取目标 SKILL.md 中的 frontmatter/正文/references/scripts → 执行 R-01~R-26 规则审查 → 输出审查报告(含每条规则的 PASS/WARN/FAIL 状态 + 详细原因 + 附近代码上下文)。
以下命令均为 python -m scripts.skill_audit 的子命令,需传入 --mode 匹配自检闸门输出。
# 只读查询(不过门禁也可执行,但推荐走门禁)
python -m scripts.skill_audit rules --confirmed --mode readonly
python -m scripts.skill_audit create-template --confirmed --mode readonly
# 审计(仅检查)
python -m scripts.skill_audit audit <skill-dir> --confirmed --mode audit
# 审计+修复(只修有 fix key 的,不经过二次筛)
python -m scripts.skill_audit audit <skill-dir> --fix --confirmed --mode audit
# 审计验证(在 --classify 后确认双0)
python -m scripts.skill_audit audit <skill-dir> --verify --confirmed --mode audit
# 创建新技能
python -m scripts.skill_audit create <skill-dir> --desc "描述" --confirmed --mode create
# 轻量更新(指定变更文件)
python -m scripts.skill_audit update <skill-dir> --changed-files scripts/foo.py --confirmed --mode update
# 全流程改造
python -m scripts.skill_audit refactor <skill-dir> --confirmed --mode refactor
# 标记误报后继续
python -m scripts.skill_audit refactor <skill-dir> --continue --confirmed --mode refactor
# 版本号升级(三端同步,需双0确认)
python -m scripts.skill_audit bump <skill-dir> --desc "变更说明" --confirmed --mode bump→ 详见 渐进式文件索引表 获取完整交互示例
用户请求关键词 → 模式 → 入口命令
───────────────────────────────────────────────────
查看规则/查看模板 → readonly → rules / create-template
仅审查/看看/评估 → audit → audit
创建/生成/新建 → create → create
审计/检查/更新/部分修 → update → update(含备份)
改造/重构/标准化/大规模改 → refactor → refactor(含备份)
版本升级(单独调用) → bump → bump(需双0确认)【模式=xxx】(如 【模式=refactor】),输出后方可执行 CLI【模式=xxx】 前,禁止执行任何 CLI 命令。禁止询问用户。_run_audit_loop() 首次进入时检查 --classify 数据(含 --category),无数据则阻断audit <skill> --verify 查看 FAIL 详情audit <skill> --classify ID1,ID2 --category engine_mistake --reason "..." 标记误报(须带类别)refactor <skill> --continue --confirmed --mode refactor 继续--classify 数据时自动放行,进入修复循环--classify ID --category engine_mistake/engine_cant_judge --reason "..." 标记误报 误报类别:
engine_mistake — 引擎技术性错误(BOM/编码/注释误识别/概念图路径)
engine_cant_judge — 引擎语义不足,LLM确认后放行(__init__.py约定/格式模板域差异)
真问题 → 必须修复,不得标记为误判--classify 查看已标记列表· fix key 在 _llm_only_fix_keys 中(workflow_completeness/example_quality/capability_boundary/section_names)→ LLM 手动 · fix key 不在其中 → auto-fix · 无 fix key → LLM 手动
--verify 过滤已分类误报,展示剩余真问题--classify 中 C-{type} 格式的 IDcmd_bump,也可单独调用present_files 打开生成的 .audit_report.html本技能的数据文件(审查缓存、进度文件、备份、日志等)存放在:
../.standardization/skill-standardization/
├── data/
│ ├── <target-skill>/ # 被审计技能的数据
│ │ ├── .verify_fp.json # --classify 标记的误判详情
│ │ ├── .remaining_llm.json # LLM 手动修复项
│ │ └── outputs/
│ │ ├── .audit_report.html # HTML 审计报告
│ │ └── .verify_fix_map.json # --verify 输出的修复指引映射
├── backup/
│ └── <skill>_<timestamp>.bak # auto-fix 操作前的单文件备份
└── ...安装目录 skills/skill-standardization/ 只保留 SKILL.md 和 scripts/,数据文件不越位。~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.