用途
Skill Review 用于审查未提交的技能(skill)变更,对照技能创作最佳实践的内部清单进行核对,并应用改进。它适用于用户请求对此类变更进行审查与优化的场景,也可从非交互式例程中调用,例如 dev-workflow-triage(d2)或 dev-workflow 的 hooks.on_complete;它从不向用户提问。
主要能力
- 检测变更的技能文件,并按差异范围(而非全量审计)审查。
- 依据内部最佳实践清单,对每个变更文件逐条核对。
- 由全新的子代理(reviewer)执行每轮审查,以保持审查者无偏见;编辑应用留在主线程完成。
- 循环执行“派发审查 + 应用修改”的周期,直到子代理不再返回机械性修改(mechanical_edits)、达到最大迭代次数,或触发安全护栏。
- 将发现分类为两类:机械性修改(mechanical_edit,可作为文本替换直接应用)与结构性说明(structural_note,需要跨文件移动内容、删除章节或大段重写,不会自动应用,而是通过 notes_remaining_count 上报)。
- 额外标记“幻觉缺口”(hallucination gaps),即执行代理需要猜测的地方,如文件名含糊、成功标准未说明、分支之间缺少决策规则。
使用方式
调用方以自然语言传入以下字段,技能会从调用文本中提取:
- 基础引用(Base ref,可选,默认 <working-tree-vs-HEAD>):用于对比的 git 引用。省略时,技能查看工作区中未提交及已暂存的变更(这是 dev-workflow 实现后审查的默认范围)。指定时(如 Base ref: main),技能切换到
git diff <Base ref>语义,用于审查基线分支与 HEAD 之间已提交的变更堆栈。 - 最大迭代次数(Max iterations,可选,默认 3):细化循环的上限。默认 3 与 verify-diff 的默认一致;文案质量打磨通常 1–2 轮即可收敛。
调用方不得在技能运行期间暂存(stage)变更,因为技能会读取工作区,暂存内容会混入差异并破坏裁决。(Base ref 模式读取的是相对该引用的已提交历史,所以暂存干扰只影响默认的工作区模式。)
适用场景
- 审查技能文件的未提交变更并进行改进。
- 从非交互式例程(如 dev-workflow-triage、dev-workflow hooks.on_complete)中调用。
- 对已提交的变更堆栈(基线分支与 HEAD 之间)进行审查(通过指定 Base ref)。
限制
- 仅审查有未提交变更的文件——按差异范围审查,不是全量审计。
- 项目约定(.claude/rules/、CLAUDE.md)在冲突时优先于清单。
- 追求实效而非完美——修复真实问题,记录次要问题后继续。
- 作为子技能运行时,结构性变更通过 notes_remaining_count 上报而非直接应用,由调用方决定是否及如何处理。
- 调用方不得在运行期间暂存变更。
- 若 Agent 不可用,则按 rules-review SKILL.md 中记载的方式回退,在主线程中逐文件内联遍历清单。
(其余资料未提供收费、价格、平台等信息。)