用途
code-review-agent 是一个只读的代码审查技能,用于对指定文件或目录进行独立的深度审查,也可在存在 contracts/ 目录时结合合同信息进行审查。它不会被自动触发,也不属于编排构建的构建阶段;构建期的 diff 审查由外部 /code-review CLI 负责,本技能仅用于显式请求的独立审查。
主要能力
审查围绕两个独立轴展开,并刻意保持二者互不合并:
- Standards 轴:检查变更是否遵循仓库已文档化的编码规范(
CLAUDE.md、lint/format 配置、docs/agents/*),并覆盖references/standards-baseline.md中即使仓库无文档也适用的内置代码坏味道基线。该轴不查看原始需求/合同。 - Spec 轴:检查变更是否忠实、完整地实现了既定需求(合同、问题单、账本条目或任务步骤),且没有构建未被要求的内容。该轴不查看规范文档。
两条配套硬性规则:其一,两个轴的结论始终并排呈现,不合并、不重新排序为单一评分;其二,在启动审查前快速失败——若范围为空、无法解析或找不到原始规格,则停止并说明,不以猜测的规格运行 Spec 轴(可标记为 NOT RUN)。
使用方式
- 解析审查范围(文件列表或 diff)、原始规格与上下文;若范围为空或无法解析则停止。
- 将两个轴作为各自独立的只读子代理并行运行(无 Write/Edit 权限),避免上下文交叉污染;若无法分派子代理,则按 Standards 先、Spec 后的顺序串行运行,且互不影响结论。
- 按固定模板组装并排报告,包含双轴结论表、Spec 轴问题清单、Standards 轴问题清单与表扬部分,不设总分行。
适用场景
- 对一组文件进行独立的、显式请求的全面只读审查。
- 需要同时评估编码规范符合度与需求实现忠实度的场景。
- 为 QE 流程提供合同符合性与代码质量输入,为安全流程标记潜在漏洞以供深入排查。
限制
- 只读,不修改代码;问题仅报告,由对应责任代理修复。
- 不是自动构建阶段,构建期 diff 审查应使用
/code-reviewCLI。 - 找不到原始规格时 Spec 轴标记为 NOT RUN,不给出猜测性结论。