SuperAPI AI 工具集

requesting-code-review

编程与开发

查看项目

更新于 10-25 16:16

技能介绍

用途\n该技能用于在开发过程中主动发起代码评审,借助子智能体在问题累积前发现缺陷。它强调“尽早评审、经常评审”,把评审作为任务推进中的常规环节,而不是合并前的最后一道形式。\n\n主要能力\n- 明确评审时机:在子智能体驱动的开发中,每完成一个任务后进行评审;完成重大功能后评审;合并到主分支前评审。\n- 可选场景:遇到困难时获取新视角;重构前做基线检查;修复复杂缺陷后评审。\n- 提供评审调度流程:获取 git SHA、调度 superpowers:code-reviewer 子智能体、处理反馈。\n- 提供反馈分级处理原则:严重问题立即修复,重要问题在继续前修复,次要问题留待后续处理;若评审者有误,可用技术理由反驳。\n\n使用方式\n1. 获取起止提交 SHA:\nBASE_SHA=$(git rev-parse HEAD~1) # 或 origin/main\nHEAD_SHA=$(git rev-parse HEAD)\n2. 通过 Task 工具调度 superpowers:code-reviewer 类型子智能体,并填写 code-reviewer.md 模板中的占位符:{WHAT_WAS_IMPLEMENTED}(刚实现的内容)、{PLAN_OR_REQUIREMENTS}(应实现的功能)、{BASE_SHA}(起始提交)、{HEAD_SHA}(结束提交)、{DESCRIPTION}(简要总结)。\n3. 根据评审反馈采取行动:立即修复严重问题;在继续前修复重要问题;记录次要问题;若评审有误,用技术理由反驳并出示代码或测试证明,或请求澄清。\n\n适用场景\n- 与子智能体驱动开发流程集成:每个任务后评审,防止问题叠加,修复后再进入下一任务。\n- 与计划执行流程集成:每批(3 个任务)后评审,应用反馈后继续。\n- 临时开发:合并前评审,遇到困难时评审。\n\n限制与红线\n不应因为“很简单”跳过评审;不应忽略严重问题;不应在重要问题未修复时继续推进;不应与合理的技术反馈争辩。若评审者判断有误,应以技术理由反驳、展示代码或测试证明,并请求澄清。模板文件路径为 requesting-code-review/code-reviewer.md。