代码审查指南Skill requesting-code-review

这个技能提供了详细的代码审查流程指南,帮助开发者在完成任务、实现功能或合并代码时验证工作符合要求。它涵盖了核心原则、请求时机、操作步骤和与工作流的集成,以提高代码质量、团队协作和开发效率。关键词包括代码审查、软件开发、质量保证、DevOps、测试、审查流程、团队协作、代码质量、早期审查、反馈处理。

测试 0 次安装 0 次浏览 更新于 3/21/2026

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

请求代码审查

分发超级能力:代码审查员子代理,以在问题级联之前捕捉问题。

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

何时请求审查

强制:

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

可选但有价值:

  • 当遇到困难时(新视角)
  • 重构前(基准检查)
  • 修复复杂漏洞后

如何请求

1. 获取git SHA:

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

2. 分发代码审查员子代理:

使用Task工具和超级能力:代码审查员类型,填写模板在 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)

[分发超级能力:代码审查员子代理]
  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