SuperAPI AI 工具集

skill-review

编程与开发

查看项目

更新于 10-16 05:34

技能介绍

用途

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 中记载的方式回退,在主线程中逐文件内联遍历清单。

(其余资料未提供收费、价格、平台等信息。)