用途
commit-review 是一个代码质量审查技能,用于在 commit 技能选择轻量审查,或用户主动请求时,对某个确切的待提交(pending)commit 进行审查。其目标是围绕该 commit 的意图与目的,检查变更的正确性、回归风险、安全性与复杂度问题。
主要能力
- 确定目标 commit 及其目的,加载适用的项目审查规则与叠加规则(overlays)。
- 在 --fix-loop 模式下,读取 references/fix-loop.md,并在审查前对确切的候选内容做快照,同时保留无关工作。
- 检查每个变更文件及受影响的调用方,关注正确性、回归、安全与不必要的复杂度。
- 追踪变更行为在成功、失败与边界情况下的表现;在相关时检查权限与受影响的调用方。
- 将变更行为与其配置的规范所有者/规格、profile 声明的场景/用例以及执行的测试证据进行对照;仅在存在实际疑虑时读取更多参考资料。
- 对变更行为,识别测试应当捕获的现实 bug;仅在测试强度不明确且编辑已获授权时,使用针对性的变异探针(mutation probe)。
- 对疑虑进行内联验证,对照源码与反证。
使用方式
- 默认以只读方式运行。
- 使用 --fix-loop 时,在范围内修复已验证的问题,并对更新后的整个候选内容重新审查,最多两轮;--loop-owner=caller 时保持只读。
- 遇到未解决的 MEDIUM 及以上问题或检查失败时停止;非阻塞的 LOW 问题延后处理。不得静默扩大预算。
- 简要报告发现、修复、检查、轮次与延后的 LOW 问题。
- 仅在完全覆盖的全新 fix-loop 通过且必需检查通过后,使用其原始快照出具回执(receipt)。
- 该审查不会执行暂存、提交或推送;也不例行加载其他审查工作流。
适用场景
适用于需要在提交前对某个确切待提交 commit 做轻量质量审查的场合,尤其是希望结合项目审查规则、测试证据与边界情况检查,并在授权时进行有限轮次修复与复审的工作流。
限制
- 发现需具备可达触发条件、后果、file:line、严重级别与至少 85% 置信度;推测性建议、无关债务以及已被检查捕获的问题会被省略。
- 缺少必需证据会阻止通过。
- fix-loop 最多两轮,不得静默扩大预算。
- 该技能本身不执行暂存、提交或推送操作。
- 关于具体安装命令、收费与价格、支持平台等信息,资料中暂未提供。