code-review

代码审查

上下文

暂存的差异：

!git diff --cached

近期提交（供参考）：

!git log --oneline -10

参数

原始参数：$ARGUMENTS

按如下方式解析参数：

• Agent（可选，第一个参数）：要委派审查的 CLI 命令或 Agent 名称。可识别的值：
  • claude、self 或空 — 在当前上下文中直接执行审查（默认）
  • 其他任何值 — 视为 CLI 命令名称（例如 codex、aider、goose）。审查将通过 Bash 调用该命令来委派（参见“委派”部分）。
• 功能（可选，Agent 之后的其余参数）：描述要审查的代码库部分（例如“投票功能”“身份验证”“API 端点”）。提供后，查找并审查所有相关文件。留空或省略时，改为审查暂存的更改。

如果只提供一个参数，且它不匹配已知 Agent 名称（claude、self），则将其视为功能，Agent 默认设为 claude。

指令

确定审查内容

1. 如果指定了功能 — 使用 Glob 和 Grep 查找与所述功能相关的所有文件。读取这些文件，并将其作为现有代码进行审查。
2. 如果未指定功能且存在暂存的更改 — 审查上方显示的暂存差异。
3. 如果未指定功能且没有暂存的更改 — 告知用户：“没有可审查的内容。请使用 git add 暂存更改，或指定要审查的功能，例如 /code-review 投票功能。”然后停止。

执行审查

根据需要阅读相关源文件，以了解上下文。按文件组织审查结果，然后按严重程度分类。

严重程度级别

1. 🔴 Critical — Bug、安全漏洞、数据丢失风险或崩溃。必须修复。
2. 🟠 Error — 逻辑错误、缺少错误处理、边缘情况处理不当。很可能会导致问题。
3. 🟡 Warning — 代码异味、性能问题、潜在边缘情况、可维护性问题。
4. 🔵 Suggestion — 更好的实现方式、可读性改进、符合惯用风格的替代方案。
5. ⚪ Nitpick — 风格、命名、格式、细微偏好。完全可选。

输出格式

按严重程度对审查结果分组。对于有发现的每个严重程度级别，都应使用单独的标题（例如 ## 🔴 Critical、## 🟠 Error 等）。在每个严重程度标题下，列出审查结果。每项审查结果都应包含：

• 文件和行号引用
• 对问题的简洁描述
• 建议的修复方案或替代方案（如适用）

省略没有审查结果的严重程度标题。

最后以 ## Summary 部分收尾：给出总体评估、说明更改是否适合合并（或代码是否健康），并统计各严重程度级别的发现数量。

委派

如果 Agent 不是 claude、self 或空值，则将其视为 CLI 命令名称。通过 Bash 调用该命令来委派审查：

• 构建一个提示词，其中包含审查指令、严重程度级别、输出格式，以及暂存差异或功能描述
• 运行：<agent> -q "<prompt>"，其中 <agent> 是用户指定的 CLI 命令（例如 codex、aider、goose）
• 命令返回后，将其审查结果原样转达给用户