用途:重构超出 500 行限制或出现结构问题的 SKILL.md。适用情形包括:CI 强制 500 行上限被突破;单个步骤包含多个不相关操作;代码块超过 15 行;出现标准六段结构之外的临时章节;内容更新后行数超限;技能评审指出结构问题。
主要能力与必要用法:
- 先测量行数并定位膨胀来源:wc -l < skills/<skill-name>/SKILL.md;grep -n "^## |^### " skills/<skill-name>/SKILL.md。分类为可抽取、可拆分、可精简、结构性问题。
- 抽取 >15 行代码块到 references/EXAMPLES.md:mkdir -p skills/<skill-name>/references/,主文件保留 3-10 行片段,并加交叉引用 EXAMPLES.md。
- 拆分复合步骤:标题含 and、含多个 Expected/On failure、超过 30 行、子部分可独立跳过或换序,均视为复合步骤;拆分后重编号,每步保留自己的 Expected 与 On failure,建议总步骤 5-12 个。
- 校验:检查主文件是否 ≤500 行(理想 ≤400 行);用 grep 确认 When to Use、Inputs、Procedure、Validation、Common Pitfalls、Related Skills 六段齐全;确认每个步骤有 Expected 与 On failure;确认交叉引用锚点可解析。可用 git diff skills/<skill-name>/SKILL.md 恢复误删内容。
适用场景:维护技能库、CI 行数超限修复、代码块过多或步骤过粗的技能整理。
限制与注意事项:资料未提供运行时环境、依赖版本、自动化脚本清单等细节。务必避免过度抽取(否则主文件不可读)、锚点链接大小写不匹配、拆分后遗漏 Expected/On failure、步骤过碎(超过 15 步)、重命名 EXAMPLES.md 章节后未同步更新锚点。无法确定平台与版本要求。