Menu
Code review skill using codex-rs methodology with ai CLI
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Planner-Generator-Evaluator 编排模式。GAN 启发的多 agent 动态编排，通过 ai CLI 控制子 agent 完成复杂任务的拆解-执行-验证闭环。
为任意代码仓库构建结构化知识库（code wiki），并通过 frozen snapshot 机制启动即问即答的 expert agent。 当你需要深入理解一个大型代码仓库、构建可复用的代码知识库、或为其他 agent 提供代码专家服务时使用此技能。
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Orchestrate a real-time alternating debate between two subagents using ai serve/send. Judge controls rounds by prompting each agent in turn.
任务规划与进度追踪。当任务有 5+ 步骤、多文件改动、或长执行链时使用。 核心机制：用 checkbox 列表追踪进度，每完成一步立即更新，利用"重写列表"将完整任务清单重新注入 context。
使用 ai serve/send/watch/kill 控制子 agent 的通用指引。所有需要子 agent 的技能都应参考此技能，而非重复定义 spawn/cleanup 流程。
| name | review |
| description | Code review skill using codex-rs methodology with ai CLI |
| tools | ["bash"] |
使用 codex-rs 的 review 方法论执行代码审查。通过 ai serve + ai send + ai watch 运行独立的 review agent。
子 agent 生命周期遵循 subagent 技能： spawn → watch → cleanup（ai kill）。本技能不重复定义 spawn/watch/kill 流程。
⚠️ MUST：在执行任何子 agent 操作前，确认 subagent 技能已加载到当前上下文。如果未加载，先调用 find_skill 工具（参数 name="subagent", load=true）加载它。
/skill:review 帮我 review 这个 pr https://github.com/tiancaiamao/ai/pull/42
/skill:review review 当前未提交的代码
/skill:review review commit abc123
| 模式 | 命令示例 | 说明 |
|---|---|---|
| PR Review | /skill:review review PR #42 | Review GitHub PR |
| Uncommitted | /skill:review review 当前未提交的代码 | Review 本地未提交更改 |
| Commit | /skill:review review commit abc123 | Review 指定 commit |
| Base Branch | /skill:review review against main | Review 相对于 base branch 的变更 |
ai serve --id-file（tmux）启动独立 agent，传入 reviewer system prompt 和任务ai send 发送 review 指令ai watch --follow --pretty 实时观察直到 agent_end先 --stat 看规模，再决定怎么读 diff。
# 本地模式（commit / uncommitted）
git diff --stat <base>..<head>
# PR 模式 — 已 fetch 到 FETCH_HEAD（推荐，见下方"获取 PR 源分支"）
git diff --stat <base-sha>..FETCH_HEAD -- . ':!生成文件路径'
# PR 模式 — 无法 fetch 时退而用 GitHub API（只看文件列表，不含 diff 内容）
gh api repos/<owner>/<repo>/pulls/<pr>/files --paginate -q '.[] | "\(.filename)\t+\(.additions)\t-\(.deletions)"'
| 规模 | 策略 |
|---|---|
| ≤ ~300 行 | 单个 git diff 即可，一步读完 |
| > ~300 行 | 逐文件 git diff <base>..<head> -- <file>，避免生成文件撑爆、截断后续内容 |
| 含生成文件 | 用 -- . ':!pkg/parser/parser.go' 等排除，或直接逐文件 diff |
git diff <base>..<head> -- <file> # 看改动
grep / read # 需要上下文时读源文件
不要把整个 diff 写入文件再 sed 分页读取——大 diff 里生成文件会占大量空间并截断后续内容。
Review 时跳过生成文件，只看它的源文件。通用识别方法：
Code generated by ...、DO NOT EDIT、auto-generated*_generated.go、mock_*.go、*.pb.go常见生成关系举例：
| 模式 | 说明 |
|---|---|
parser.go from parser.y | yacc/bison 语法文件生成 |
BUILD.bazel from make bazel_prepare | 构建系统自动生成 |
mock_*.go from mockgen | mock 代码生成 |
*.pb.go from protoc | protobuf 生成 |
Agent 应查阅项目的 AGENTS.md 或构建文档确认生成关系，项目特定的生成文件列表写在项目的 AGENTS.md 中。
需要本地 git diff 时，先 fetch PR 源分支：
# 1. 获取 fork repo 和分支名
gh api repos/<owner>/<repo>/pulls/<pr> --jq '.head.repo.full_name + " " + .head.ref'
# 输出: <user>/<repo> <branch>
# 2. 获取 base SHA
gh api repos/<owner>/<repo>/pulls/<pr> --jq '.base.sha'
# 3. Fetch 源分支（depth=1 即可，只要 diff）
git fetch https://github.com/<user>/<repo>.git <branch> --depth=1
# 4. 本地 diff
git diff <base-sha>..FETCH_HEAD -- <specific-file>
审查使用专用的 reviewer role（~/.ai/roles/reviewer/，非 git 管理），已预置：
~/.ai/skills/review/reviewer.md）opencode/deepseek-v4-flash（可在 ~/.ai/roles/reviewer/agent.yaml 中调整）{
"findings": [
{
"title": "[P1] Fix null pointer risk in auth handler",
"body": "在 user.go:45 处，user 可能是 nil...",
"confidence_score": 0.9,
"priority": 1,
"code_location": {
"absolute_file_path": "/path/to/user.go",
"line_range": {"start": 44, "end": 46}
}
}
],
"overall_correctness": "patch is correct",
"overall_explanation": "代码质量良好，无阻塞问题",
"overall_confidence_score": 0.85
}
PR_NUM=42
REVIEW_OUT="/tmp/review-${PR_NUM}.json"
用 subagent 技能 Single Task 模式 spawn 子 agent，参数：
| 参数 | 值 |
|---|---|
| role | reviewer |
| input | 'You are in the project directory. Review PR #'"${PR_NUM}"'. Steps: 1) Run gh pr diff '"${PR_NUM}"' to see the changes. 2) Read relevant source files for context. 3) Write your review findings as JSON to '"${REVIEW_OUT}"' following the output format in your system prompt.' |
| name | reviewer-$PR_NUM |
| timeout | 10m |
完成后读取 $REVIEW_OUT，然后遵循 subagent 技能 Cleanup 阶段清理。
REVIEW_OUT="/tmp/review-local.json"
用 subagent 技能 Single Task 模式 spawn 子 agent，参数：
| 参数 | 值 |
|---|---|
| role | reviewer |
| input | 'You are in the project directory. Review the current uncommitted changes. Steps: 1) Run git diff and/or git diff --cached to see the changes. 2) Read relevant source files for context. 3) Write your review findings as JSON to '"${REVIEW_OUT}"' following the output format in your system prompt.' |
| name | rev-local |
| timeout | 10m |
COMMIT=abc123
REVIEW_OUT="/tmp/review-${COMMIT}.json"
用 subagent 技能 Single Task 模式 spawn 子 agent，参数：
| 参数 | 值 |
|---|---|
| role | reviewer |
| input | 'You are in the project directory. Review commit '"${COMMIT}"'. Steps: 1) Run git show '"${COMMIT}"' to see the changes. 2) Read relevant source files for context. 3) Write your review findings as JSON to '"${REVIEW_OUT}"' following the output format in your system prompt.' |
| name | rev-${COMMIT} |
| timeout | 10m |
Spawn/watch/kill 的常见陷阱详见 subagent 技能 Common Pitfalls 章节。Review 特有的错误：
| 错误 | 说明 |
|---|---|
| agent 失败后自己代做 | ⛔ 严格禁止。停下来向用户汇报，等待指示 |
| 传递 diff 文件路径 | ❌ 应传递项目目录，让 agent 自己 git diff |
| JSON 解析失败 | 尝试修复 JSON 或要求 agent 重试 |
| id 文件为空 | 增加 sleep 等待时间或检查 serve 是否启动失败 |
subagent 技能 — spawn、watch、kill 的具体代码见 subagent 技能git diff 和读取源文件| 问题 | 解决方案 |
|---|---|
| PR 不存在 | 提示用户检查 PR 链接 |
| 无变更 | 输出 "No changes to review" |
| Agent 超时 | 增加 timeout 值或简化 review 范围 |
| JSON 解析失败 | 尝试修复 JSON 或要求 agent 重试 |
| id 文件为空 | 增加 sleep 等待时间或检查 serve 是否启动失败 |
~/.ai/roles/reviewer/ — Reviewer role 配置（agent.yaml + system prompt，非 git 管理）~/.ai/skills/review/reviewer.md — Reviewer system prompt 源文件