请求代码审查 requesting-code-review

这是一个用于软件开发流程中代码质量控制的技能。它定义了何时以及如何请求代码审查,强调早期和频繁的审查原则,以在问题扩大化之前捕获它们。该技能通过派遣专门的代码审查员子代理,提供结构化的审查请求模板和反馈处理指南,确保代码符合要求,提升软件质量。关键词:代码审查、代码质量、软件开发流程、代码评审、质量控制、Git、子代理、反馈处理。

DevOps 0 次安装 0 次浏览 更新于 3/4/2026

name: 请求代码审查 description: 在完成任务、实现主要功能或合并前使用,以验证工作是否符合要求

请求代码审查

派遣超能力:代码审查员子代理,在问题级联前捕获问题。

核心原则: 尽早审查,频繁审查。

何时请求审查

强制要求:

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

可选但很有价值:

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

如何请求

1. 获取 git SHA:

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

2. 派遣代码审查员子代理:

使用 Task 工具,类型为 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/plans/deployment-plan.md 的任务 2
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661
  DESCRIPTION: 添加了 verifyIndex() 和 repairIndex(),包含 4 种问题类型

[子代理返回]:
  优点:架构清晰,有真实测试
  问题:
    重要:缺少进度指示器
    次要:报告间隔的魔法数字 (100)
  评估:可以继续

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

与工作流的集成

子代理驱动开发:

  • 每个任务后审查
  • 在问题累积前捕获
  • 在进入下一个任务前修复

执行计划:

  • 每批(3个任务)后审查
  • 获取反馈,应用,继续

临时开发:

  • 合并前审查
  • 遇到困难时审查

危险信号

切勿:

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

如果审查员有误:

  • 用技术理由反驳
  • 展示证明其有效的代码/测试
  • 请求澄清

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