SuperAPI AI 工具集

requesting-code-review

测试与质量

查看项目

更新于 10-16 06:46

技能介绍

用途:在方法包实现工作中发起规范化的代码审查请求。适用于子代理驱动开发的每个任务之后、完成主要功能后、合并到主分支前,也可在卡住、重构前或修复复杂缺陷后使用。

主要能力:使用规范模板 code-reviewer.md 派发通用审查子代理,为其提供精确构造的上下文而非会话历史;要求审查先列具体发现(缺陷优先、风险优先、测试优先),检查证据充分性、基线与当前权威对齐、需求/产品对齐、架构/当前权威对齐、设计缺陷/实现漂移分类、重复所有者风险、兼容边界、缺失的 ADR 自动回填或基线同步发现、未验证声明、应退役的旧逻辑、公共命名漂移等。

使用方式:先收集最小审查输入(实现了什么、应对齐的需求/计划/规范/ADR、已有证据、兼容边界、退役说明、是否涉及 ADR 或基线同步、相关 CONTEXT.md 语言),再定义 Git 审查范围,例如工作树审查用 REVIEW_SCOPE=working-tree 与 BASE_SHA=$(git rev-parse HEAD),已提交范围用 REVIEW_SCOPE=committed-range、BASE_SHA=<known-start>、HEAD_SHA=$(git rev-parse HEAD)。随后用 Task 工具派发审查子代理并填写模板占位符,如 {WHAT_WAS_IMPLEMENTED}、{PLAN_OR_REQUIREMENTS}、{EVIDENCE}、{COMPATIBILITY_BOUNDARY}、{RETIREMENT_NOTES}、{REVIEW_SCOPE}、{BASE_SHA}、{HEAD_SHA}、{DESCRIPTION}。最后按反馈行动:立即修复严重问题,继续前修复重要问题,记录次要问题,若审查者有误可据理反驳,若暴露证据缺口则补做验证。

适用场景:子代理驱动开发、执行计划、临时开发中的审查请求。

限制:审查是建议性、以证据为导向的,本身不授予权威完成权,不能替代完成前验证;审查就绪不等于合并批准。若无法回答所需输入,应先补齐再派发。模板位于 requesting-code-review/code-reviewer.md。