用途
skill-maintenance 用于构建和修复 AI 智能体技能（SKILL.md）。技能的实际使用者是无人复核的智能体，因此该工具要求每次改动都以自动化检查通为完成标准，而不依赖人工阅读。
主要能力
- 脚手架生成：通过 new-skill.mjs 创建新技能，包含六段式结构、参考文档、可运行的检查脚本及叠加自测，并预留待填占位符。
- 描述与路由：规定描述不超过 300 字符（建议 250），以第三人称动词开头，含“Use when”与“Not for”，并借助路由评测（离线排名或 Claude Code 实测）判断技能边界是否清晰。
- 自测检查：要求每个检查器针对它自己的 --help 中列出的每条规则，各有一个 bad-* 用例和好用例，以覆盖用例（共享基础 + mutation.json）形式编写，避免“只通过过”的无效检查。
- 校验脚本：提供 validate-skill.mjs、check-skill.mjs、check-skill-set.mjs、check-routing.mjs 等工具，分别校验单个技能、完整技能、技能集合重叠与预算、路由命中。
- 契约与布局：检查器通过 resolveLayout()、walkRepo() 和 contracts/<name>.json 读取应用信息，不硬编码路径；设备需显式命名。
- 版本事实管理：每个版本敏感事实须带“verified on”日期与复验命令。
使用方式
在仓库根目录运行 node ${CLAUDE_SKILL_DIR}/scripts/check-routing.mjs . --prompt "<任务>" 查看当前哪个技能胜出；用 new-skill.mjs 生成脚手架；填写 references/、templates/ 等；编写描述并加入路由评测；依次运行 validate-skill.mjs、技能自身的 selftest.mjs、check-skill.mjs，修复所有 FAIL 直至三项均输出 RESULT: PASS。最后运行 check-skill-set.mjs 与 check-routing.mjs 检查整体集合。
适用场景
创建新技能、修改现有技能描述、编写或修正检查脚本、维护技能库（共享文件同步、目录、全量自测）、排查技能无法加载或触发的问题。
限制
规则均为启发式，存在检查器看不到的审查项（如正文指向仓库文档、参考未带来源日期、跳过项规则 id 非字面量）。模板须在真实应用中通过 tsc、ESLint、Jest。不得编辑同步或生成文件，须改规范副本。脚本在无项目技能的仓库中输出 NOT APPLICABLE。具体命令、参数与更多细节以官方说明为准；资料未提供的功能与收费信息暂未提供。