.md 文件禁止使用 Write/Edit 工具更新 — 必须用 scripts/ 下的 Python 脚本原子写入
SKILL.md / _meta.json / CHANGELOG.md
audit --verify 验证，非误报项必须全部修复，exit(0) 方可提交
--fix 自动修正后 — 将 fix_details 转化为可读 changelog 并用 safe_io 写入
当用户提出以下类型请求时，应触发本技能：
自然语言（推荐）：
技术关键词：
不触发（以下情况不应触发本技能）：
本技能能做什么、不能做什么，一目了然：
| 能力 | 说明 | 限制 |
|------|------|------|
| 审计现有 skill | R-01~R-25 全量检查，输出 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-25 共 20+ 条规则 | 仅修复格式/结构/路径/生成类问题，不修复代码逻辑错误。
修复后需运行 --verify + --show-fix 两阶段验证确认 |
| 权限安全扫描 | 自动检测脚本中的文件删除/网络请求/subprocess 调用 | 扫描基于 AST 静态分析，无法检测动态代码执行的权限需求 |
> 触发本技能后立即可见的能力输出：读取目标 SKILL.md 中的 frontmatter/正文/references/scripts → 执行 R-01~R-25 规则审查 → 输出审查报告（含每条规则的 PASS/WARN/FAIL 状态 + 详细原因 + 附近代码上下文）。
> 📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。
| 文件名 | 位置 | 说明 |
|--------|------|------|
| references/antipatterns.md | 反模式（Anti-Patterns） | > 本文件收录 skill 编写过程中的常见反模式，帮助 AI 和开发者避开典型坑点。 |
| references/architecture.md | 架构设计 | > 本文件描述 skill-standardization v2 的整体架构、模块关系和数据流。 |
| references/changelog.md | changelog | - 修复 _load_body_spec 路径错误（spec/→scripts/spec/），导致 fix_sectio |
| references/data_dir_map.md | skill-standardization 数据目录路径引用对照表 | 1. 安装目录（skills/ 或 skills/installed/）—— |
| references/examples.md | 示例集合 — skill-standardization v2 | 本文件包含 skill-standardization v2 各种使用场景的完整示例。 |
| references/faq.md | 常见问题（FAQ） | > 本文件收集 skill-standardization v2 使用过程中的常见疑问和解答。 |
| references/guide.md | 使用指南 — skill-standardization v2 | 本指南提供 skill-standardization v2 三种执行模式的详细操作教程。 |
| references/permissions.md | 权限说明 | 权限扫描风险等级：CRITICAL |
| references/reference.md | API / 命令参考 | > 本文件为 skill-standardization v2 的完整命令参考手册。 |
| references/rules.md | 改写/更新铁律（AI 执行前必须遵守） | > 本文件为 skill-standardization v2.13.0 的铁律条款，AI 更新任何 skill 前必须 |
本技能有五个模式，各自对应不同的命令和流程。执行前必须按以下规则识别用户意图，不可跳过此步骤直接执行。
| 用户请求包含 | → 模式 | → 执行命令 |
|-------------|--------|-----------|
| 仅审查/仅检查/看结果/不要改任何东西 | audit | python -m scripts.skill_audit audit |
| 创建/生成/创建/把 xxx做成skill | create | python -m scripts.skill_builder create |
| 审计/检查/审查/评估/更新/修复/升级/跑一遍规范/做个体检 | update | python -m scripts.skill_audit audit |
| 改造/重构/迁移/大改/标准化/规范化 | refactor | python -m scripts.skill_audit refactor |
| 升版本/版本号更新（内部流程自动触发，非用户主动请求） | bump | python -m scripts.skill_audit bump |
--fix 自动修复 — 自动修正可修复项（frontmatter/版本号/数据目录/反模式/FAQ 等 20+ 条规则）
--verify 验证 — 输出编号 FAIL 条目 [#ID]，每条含独立问题描述
--show-fix ID1,ID2 — 筛选真问题后获取对应修复指引
→ 修复指引获取：python -m scripts.skill_audit audit
create 模式（创建新技能——从零开始生成骨架）：
python -m scripts.skill_builder create --desc "描述"
update 模式（轻量更新——技能结构已标准，只需审计修复）：
python -m scripts.skill_audit audit --fix
refactor 模式（全量改造——技能非标准/结构混乱/需要迁移）：
python -m scripts.skill_audit refactor
python -m scripts.skill_audit audit /path/to/target-skill --confirmed
# → PASS (25/25 通过)
python -m scripts.skill_audit audit /path/to/target-skill --fix --confirmed
# → 修正后 PASS
python -m scripts.skill_audit refactor /path/to/target-skill --confirmed
# → 1/7 蓝皮书 → 2/7 备份 → 3/7 审计 → 4/7 修复 → 5/7 验证 → 6/7 bump → 7/7 清理
本技能的数据文件（审查缓存、进度文件、备份、日志等）存放在：
../.standardization/skill-standardization/
> 安装目录 skills/skill-standardization/ 只保留 SKILL.md 和 scripts/，数据文件不越位。
共 81 个版本