BAIZE AI RESOURCE

代码评审反馈处理

Receiving-code-review

receiving-code-review 是 superpowers 的 AI Skill,指导编码代理收到评审意见后先验证再实现,避免盲从并优先保证技术正确性。

Receiving-code-review

资源介绍

receiving-code-review 是 obra/superpowers 仓库 skills 目录下的一个 AI Skill,以 SKILL.md 形式定义,供编码代理在收到代码评审反馈时遵循。它的核心主张是:评审反馈需要技术评估而非情绪表演,先验证、再假设、后实现。技能给出了一套响应流程:完整阅读反馈、用自己的话复述需求、对照代码库实际情况验证、评估建议是否适用于当前代码库、给出技术性回应或有理有据的反驳、最后逐条实现并逐条测试。它明确禁止“你说得完全对”“好建议”等表演式回应,也禁止在验证前就动手实现;对来自外部评审者的建议要求先检查是否破坏现有功能、是否违反 YAGNI、是否与既有架构决策冲突。适用于使用 Claude Code 等代理工具进行协作开发、需要处理人工或外部代码评审意见的开发者。

Skill 能力

先验证后实现

要求代理在动手修改前对照代码库实际情况核实评审建议,避免盲目照做。

禁止表演式认同

明确禁止“你说得完全对”“好建议”等社交性回应,要求用技术性确认或直接修复代替。

区分反馈来源

对来自人类搭档的反馈与外部评审者的反馈采用不同的信任与核查策略。

支持有理有据的反驳

当建议破坏现有功能、缺乏上下文或违反 YAGNI 时,要求以技术理由提出反驳。

逐条实现与测试

多条反馈按阻塞问题、简单修复、复杂修复排序,逐条实现并逐条测试,避免批量修改。

资源配置

适用平台

Claude Code

支持模型

Claude

调用方式

自动触发

安装与调用

  1. 在代理环境中加载或引用该 SKILL.md,使代理在收到代码评审反馈时按其中流程执行。

  2. 收到反馈后先完整阅读,不立即回应,用自己的话复述需求或就不明确之处提问。

  3. 对照当前代码库验证建议是否成立,评估其是否适用于本项目的技术栈与架构。

  4. 对成立的建议逐条实现并逐条测试;对不成立的建议给出技术性反驳或向人类搭档确认。

  5. 若反馈中有不明确条目,先停止实现并请求澄清,避免部分理解导致错误修改。

使用案例

处理不明确的批量反馈

使用场景人类搭档要求修复第 1 至 6 项问题,但其中第 4、5 项含义不清。

技能要求代理先说明已理解 1、2、3、6 项,并就 4、5 项请求澄清后再动手,而不是先实现能理解的部分。

应对外部评审者的建议

使用场景外部评审者建议移除遗留代码。

代理先核查构建目标与 API 版本要求,发现低版本仍需该代码,于是指出当前实现中的具体问题并询问是修复还是放弃旧版本支持。

识别 YAGNI 场景

使用场景评审者建议为某端点实现完整的指标追踪、日期筛选与 CSV 导出。

代理检索代码库后发现该端点无人调用,于是提出按 YAGNI 移除该端点,或请对方确认是否存在未发现的调用场景。

包含内容

LICENSE-MIT.txt
README-中文安装说明.md
receiving-code-review-source.zip
SHA256.txt

常见问题

这个技能解决什么问题?
它解决编码代理在收到代码评审反馈时容易出现的表演式认同和盲目实现问题,要求先验证再修改,以技术正确性为准。
它适用于哪些代理平台?
资料显示它属于 obra/superpowers 技能集,以 SKILL.md 形式提供,具体支持的代理平台在现有资料中未明确说明。
收到反馈后应该先做什么?
先完整阅读反馈,用自己的话复述需求或就不明确之处提问,然后对照代码库验证建议是否成立,最后才逐条实现并测试。
可以对评审意见提出反驳吗?
可以。当建议破坏现有功能、评审者缺乏完整上下文、违反 YAGNI 或与既有架构决策冲突时,技能要求以技术理由提出反驳。