skill-scaffolder 精简技能架构

Other

生成结构精简的 Claude Code skill 骨架,强制 routing-signal 三要素 + 五类 body taxonomy + Faithfulness gate。用户说起草/设计/新建/scaffold skill 时触发。

Install

openclaw skills install skill-scaffolder

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