SkillScaffolder#

Trigger#

• /skill-scaffolder
• 用户要求起草 / 设计 / scaffold / 新建一个 skill
• 用户有 idea 要落成 skill

7 步流程（一次性产出，非引导式）#

1. Retirement check（Gate 0）：给 3 个"典型触发场景"。若裸模型 / 现有 skill / CLAUDE.md 都能搞定 → 建议退休，停止

2. Routing signal 三要素：primary capability（10–20 tok）+ trigger condition（10–20 tok）+ unique identifier（10–20 tok）

3. Description draft：三要素合成 ≤120 tok；DDMIN 自检（能否再删一词仍唯一触发）

4. Body taxonomy 预标：逐条规则打五类标签（ core_rule / background / example / template / redundant）；拿不准读 background.md

5. File split 布局：SKILL.md 只放 core_rule；非空拆出文件必有 when: + topics: frontmatter；< 50 tok 的拆出文件合回 SKILL.md

6. 四反模式检查：

   • ❌ examples-as-specification（规则藏在示例里）
   • ❌ background 藏数字 / 阈值 / 路径 / API / env
   • ❌ description 堆触发词枚举
   • ❌ redundant（body 重复 refs）

7. Faithfulness 自检（Gate 1）：列 operational concept（动词 / 阈值 / 路径 / API / env）→ 核对都在 core_rule ∪ 拆出文件；丢失则回滚到 core_rule

8. 产出：写到 <path>/<skill-name>/：

   • SKILL.md（core_rule only）
   • 非空的 background.md / examples.md / templates.md（各带 frontmatter）
   • ARCHITECT_REPORT.md（格式读 templates.md）

辅助：

• 分类拿不准 → background.md
• 对照走查 → examples.md
• 骨架 / 报告模板 → templates.md

约束#

• 不创建 < 300 tok 的 skill（Gate 0 退休）
• description ≤ 120 tok
• body core_rule 占比 ≥ 80%；不到重新归类或退休
• 不堆触发词 枚举到 description
• 不把 operational 信息藏 在 background / example
• 每个拆出文件 必有 when: + topics: frontmatter
• 不覆盖 已存在的目录（若 <path>/<skill-name>/ 存在，改写到 <skill-name>.new/）

不该用 skill-scaffolder 的情况#

• 改造 老 skill → 用 skill-compressor
• 想要 引导式创作 + eval 迭代 → 用官方 skill-creator
• 只有 1–2 条规则 → 直接写进 CLAUDE.md，不建 skill