🚀 快速安装

复制以下命令并运行,立即安装此 Skill:

npx @anthropic-ai/skills install obra/superpowers/requesting-code-review

💡 提示:需要 Node.js 和 NPM

请求代码审查

分派 superpowers:code-reviewer 子智能体,以便在问题扩大之前将其捕获。

核心原则:尽早审查,经常审查。

何时请求审查

必须执行:

  • 在子智能体驱动的开发中,完成每个任务之后
  • 完成主要功能之后
  • 合并到主分支之前

可选但有价值:

  • 遇到阻碍时(获取新视角)
  • 重构之前(基线检查)
  • 修复复杂错误之后

如何请求

1. 获取 Git SHA:

BASE_SHA=$(git rev-parse HEAD~1)  # 或 origin/main
HEAD_SHA=$(git rev-parse HEAD)

2. 分派 code-reviewer 子智能体:

使用任务工具,类型为 superpowers:code-reviewer,并填写 code-reviewer.md 中的模板

占位符:

  • {WHAT_WAS_IMPLEMENTED} – 你刚刚构建的内容
  • {PLAN_OR_REQUIREMENTS} – 它应该做什么
  • {BASE_SHA} – 起始提交
  • {HEAD_SHA} – 结束提交
  • {DESCRIPTION} – 简要总结

3. 根据反馈采取行动:

  • 立即修复严重问题
  • 在继续之前修复重要问题
  • 记录次要问题以便稍后处理
  • 如果审查者判断有误,可提出异议(需提供理由)

示例

[刚刚完成任务 2:添加验证函数]

你:让我在继续之前请求代码审查。

BASE_SHA=$(git log --oneline | grep "任务 1" | head -1 | awk '{print $1}')
HEAD_SHA=$(git rev-parse HEAD)

[分派 superpowers:code-reviewer 子智能体]
  WHAT_WAS_IMPLEMENTED:对话索引的验证和修复函数
  PLAN_OR_REQUIREMENTS:来自 docs/superpowers/plans/deployment-plan.md 的任务 2
  BASE_SHA:a7981ec
  HEAD_SHA:3df7661
  DESCRIPTION:添加了 verifyIndex() 和 repairIndex(),支持 4 种问题类型

[子智能体返回]:
  优点:架构清晰,包含真实测试
  问题:
    重要:缺少进度指示器
    次要:报告间隔使用了魔数 (100)
  评估:可以继续

你:[修复进度指示器]
[继续执行任务 3]

与工作流程的集成

子智能体驱动的开发:

  • 每个任务之后进行审查
  • 在问题叠加之前将其捕获
  • 在进入下一个任务之前修复

执行计划:

  • 每批任务(例如 3 个)完成后进行审查
  • 获取反馈,应用修改,然后继续

临时开发:

  • 合并前进行审查
  • 遇到阻碍时进行审查

危险信号

切勿:

  • 因为“很简单”而跳过审查
  • 忽略严重问题
  • 在未修复重要问题的情况下继续
  • 与有效的技术反馈争论

如果审查者判断有误:

  • 用技术理由提出异议
  • 展示证明其有效的代码/测试
  • 请求澄清

参见模板:requesting-code-review/code-reviewer.md

📄 原始文档

完整文档(英文):

https://skills.sh/obra/superpowers/requesting-code-review

💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。