SuperAPI AI 工具集

plan-7-v2-code-review

测试与质量

查看项目

更新于 10-15 22:40

技能介绍

用途:对某个计划阶段(Phase)的代码变更做只读审查,检查实现质量、领域合规、是否重复实现已有能力、测试与证据质量、以及项目规则符合度,最终给出裁定并写出审查报告文件。不修改源码,补丁仅作提示。

主要能力:启动 5 个并行子代理——实现质量(正确性、安全、错误处理、性能、范围合规、模式一致性)、领域合规(文件归属、仅契约导入、依赖方向、domain.md/registry/domain-map 更新、无孤儿文件、无循环业务依赖、无未标注边、概念文档)、反重复(新组件是否与既有领域能力重叠)、测试与证据验证、项目规则与架构校验。汇总去重后按严重级排序(CRITICAL→HIGH→MEDIUM→LOW),给出 APPROVE、APPROVE WITH NOTES 或 REQUEST_CHANGES 裁定。

使用方式:需要 --plan(plan.md 绝对路径);Full 模式还需 --phase "<Phase N: Title>",Simple 模式省略。可选 --diff-file,省略则从 git 计算;--strict 将 HIGH 视为阻断。产物:Full 模式写入 ${PHASE_DIR}/reviews/review.${PHASE_SLUG}.md,Simple 模式写入 ${PLAN_DIR}/reviews/review.md;REQUEST_CHANGES 时另写 fix-tasks 文件;计算出的 diff 存为 reviews/_computed.diff。

适用场景:采用 SDD 流程、具有 docs/domains 领域注册表与项目规则文档的代码仓库,在阶段实现(plan-6)之后、下一阶段之前执行。

限制:只读,不改源文件;报告确定性输出、使用绝对路径;若 domain-map.md 存在则必须校验;不自行启动运行时验证,运行时由 harness 系列负责;未见项目规则文档时报告 N/A 而非失败。