用途:在 Verbs 仓库中创建符合契约的新技能,或评估、改进已有技能。定位介于 grill --brief(想法到简报)与 sprint(简报执行)之间,负责拒绝非技能、防止触发词重叠、强制执行冷热放置、并从清单源同步各加载器。
主要能力:一是构建路径,按阶段引导识别缺口、做 MECE 检查(含 Q0 拒绝构建、查 docs/out-of-scope/、开 RESOLVER.md 枚举目录)、决定热/冷(每次调用读取超过 5K token 必须派发子智能体做重读取)、决定内联还是抽取、编写 SKILL.md 前置元数据与正文、在 manifest.toml 和 RESOLVER.md 注册、运行验证与近邻路由检查、并做构建自检。二是 --eval <name> 评估模式:按 lib/skill-eval.md 的评分步骤与模板,读 writing-great-skills 评分卡,对全部 9 个轴打分(pass/weak/fail,每条引用一个 L<n>,默认 weak),写出带哈希的 skills/<bucket>/<name>/eval.md,并确认 bash scripts/lint-eval-fresh.sh <name> 通过;--eval all 为每个技能派发一个子智能体,不在单一热上下文中评估全库。
使用方式:新建的 SKILL.md 前置元数据须符合 SKILL-FRONTMATTER.md,含 name、description、user-invocable、type 等字段;正文按 Phases、Output Format、Anti-Patterns 顺序编写。注册时向 manifest.toml 添加 [skill.<name>],再运行 scripts/verbs sync;四个宿主加载器 JSON 是生成产物,不得手工编辑。RESOLVER.md 中按现有分类添加一行。验证运行 git diff --check、scripts/verbs sync --check、前置元数据检查器和 python3 tests/resolver-routes-test.py;只有存在 .test/.spec 文件时才运行 bun test。触发词增改后需手动确认约 6 组易混技能仍正确路由。
输出物包括 skills/<bucket>/<name>/SKILL.md、eval.md、manifest 条目、RESOLVER 行及重新生成的加载器 JSON。
限制与反模式:不得与已有技能触发面重叠,应扩展而非新增;未达抽取阈值前不得预建 lens/persona/rubric 注册表;不得跳过冷热检查;不得引入未映射的语义字段;不得无理由新增 RESOLVER 分类;一个月内触发不超过 3 次的技能不应发布。
其他细节:官方文档暂未提供。