# Requesting Code Review

> 在完成任务、实现主要功能，或合并前验证工作符合需求时使用

- Skill: `vinvcn/requesting-code-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add vinvcn/requesting-code-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vinvcn/requesting-code-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vinvcn (https://skillmd.com/u/vinvcn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vinvcn/requesting-code-review

---


# 请求代码审查

分派代码审查者子代理，在问题扩大前捕捉它们。审查者会获得为评估精确构造的上下文——绝不是你的会话历史。这会让审查者专注于工作产物，而不是你的思考过程，同时保留你自己的上下文以便继续工作。

**核心原则：** 尽早审查，经常审查。

## 何时请求审查

**强制：**
- 在 subagent-driven development 中每个任务之后
- 完成主要功能后
- 合并到 main 之前

**可选但有价值：**
- 卡住时（获得新视角）
- 重构前（基线检查）
- 修复复杂 bug 后

## 如何请求

**1. 获取 git SHAs：**
```bash
BASE_SHA=$(git rev-parse HEAD~1)  # or origin/main
HEAD_SHA=$(git rev-parse HEAD)
```

**2. 分派代码审查者子代理：**

使用 `general-purpose` 类型的 Task 工具，填写 `code-reviewer.md` 中的模板

**占位符：**
- `{DESCRIPTION}` - 你构建内容的简短总结
- `{PLAN_OR_REQUIREMENTS}` - 它应该做什么
- `{BASE_SHA}` - 起始 commit
- `{HEAD_SHA}` - 结束 commit

**3. 处理反馈：**
- 立即修复 Critical 问题
- 继续前修复 Important 问题
- 记录 Minor 问题以便之后处理
- 如果审查者错了，进行反驳（带理由）

## 示例

```
[刚完成 Task 2：添加验证函数]

你：继续之前，我先请求代码审查。

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

[分派代码审查者子代理]
  DESCRIPTION: 添加了 verifyIndex() 和 repairIndex()，包含 4 种问题类型
  PLAN_OR_REQUIREMENTS: docs/superpowers/plans/deployment-plan.md 中的 Task 2
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661

[子代理返回]:
  Strengths: 架构干净，测试真实
  Issues:
    Important: 缺少进度指示器
    Minor: 报告间隔使用魔法数字 (100)
  Assessment: 可以继续

你：[修复进度指示器]
[继续 Task 3]
```

## 与工作流集成

**Subagent-Driven Development：**
- 每个任务后都审查
- 在问题累积前捕捉它们
- 移动到下一个任务前先修复

**Executing Plans：**
- 每个任务后或自然检查点审查
- 获取反馈、应用、继续

**Ad-Hoc Development：**
- 合并前审查
- 卡住时审查

## 危险信号

**绝不要：**
- 因为 "it's simple" 就跳过审查
- 忽略 Critical 问题
- 带着未修复的 Important 问题继续
- 与有效的技术反馈争辩

**如果审查者错了：**
- 用技术推理反驳
- 展示能证明它可用的代码/测试
- 请求澄清

模板见：requesting-code-review/code-reviewer.md