// [Reviewer] Analyze local git diff (with optional user-supplied extra scope) and produce a structured review document with numbered findings (R1, R2...). Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R).
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | review1-raise |
| description | [Reviewer] Analyze local git diff (with optional user-supplied extra scope) and produce a structured review document with numbered findings (R1, R2...). Part of a 5-stage adversarial ping-pong review: raise(R) → reply(D) → confirm(R) → execute(D) → accept(R). |
分析代码改动，生成结构化 review 文档，为后续 review2-reply / review3-confirm / review4-execute / review5-accept 提供输入。
Reviewer Agent — 本阶段由 Reviewer 执行，是五阶段对抗性 ping-pong 流程的第一棒：
raise(R) → reply(D) → confirm(R) → execute(D) → accept(R)
对抗假设：代码中存在作者未察觉的缺陷、设计短视或一致性问题。积极挖掘，不因代码"能跑"就放水。严重程度要客观标定——风格偏好可以提，但不得标为"严重"。预设 Defender 在 review2-reply 中会反驳弱势 Review，因此每条 Review 必须有充分依据，禁止模糊措辞。
git diff HEAD（已暂存 + 未暂存）git diff HEAD [补充范围] 及 git diff --stat HEAD [补充范围]检查历史 review 记录（由主 Agent 执行）：
ls -t .temp/review-*.md 获取历史文档列表head -n 15 .temp/review-xxx.md 读文档开头，查看"评审范围"中涉及的文件路径git diff --stat HEAD 涉及的文件有重叠，视为相关文档；用 read 读取完整内容已共识·实施 / 已共识·延后 / 已共识·否决 / 已共识·存档(旧) / 验收退回 等）及核心问题描述收集 diff（默认 + 用户补充）
若无改动，直接退出
同时启动两个并行子 Agent 评审——不等其中一个完成再启动另一个；让 Agent 自行读取代码与 diff，不要把 diff 文本直接传给 Agent；任一 Agent 启动失败时，不得单独继续，向用户确认后再决定下一步：
Agent A — 实现质量，聚焦：
Agent B — 设计质量，聚焦：
每个 Agent 的输出须包含：
子 Agent 约束：
收集两个 Agent 的完整输出，将其作为参考线索而非最终结论——最终报告由本 Agent 独立负责，不得直接照搬任一 Agent 的原文：
已共识·否决 或旧版 已共识·存档，本轮不再重复提出；若之前标记为 已共识·实施 但当前代码仍未修复，可再次提出并注明"历史遗留"；若之前标记为 已共识·延后，本轮不重复提出，但可在新问题中引用 backlog ID用户体验改动门禁：检查所有问题中是否存在影响功能设计或用户体验的建议（即不是代码 bug 修复或内部实现优化的条目）。若有，逐一和用户确认，用户明确同意保留的建议方可写入文档，未确认的直接剔除
整理问题列表，按 R1, R2... 编号
一次性写入：调用脚本创建文档，通过 heredoc 直接传入完整内容（仅允许这一次写入操作）：
python .claude/skills/review1-raise/review_record.py create <主题slug> <<'EOF'
## 本地改动与分支 Review
...
EOF
脚本自动生成时间戳，输出完整文件路径（如 .temp/review-260420-1530-<主题>.md），后续步骤使用此路径。
## 本地改动与分支 Review
**评审范围**
- 默认范围: git diff HEAD
- 补充范围: (若有)
- 当前分支: <branch>
---
### R1 — <标题>
**Review**
- 严重程度: 严重/警告/建议
- 问题描述: ...
- 修改建议: ...
### R2 — <标题>
**Review**
...
当评审对象是 worktree 中的未提交改动时，所有操作必须在目标 worktree 中执行，不可写入 dev 目录：
ls -t .temp/review-*.md 必须在目标 worktree 根目录下执行，读取目标 worktree 中的历史 review 记录。git diff HEAD 必须在目标 worktree 目录下执行，确保 diff 来自目标 worktree 的未提交改动。review_record.py create 必须在目标 worktree 目录下执行，生成的 .temp/review-*.md 位于目标 worktree 根目录，随 worktree 一起清理/提交。review_record.py 等脚本的调用必须在目标 worktree 目录下执行，确保相对路径解析正确。向用户报告生成的文件路径（位于 .temp/），并提示下一步：
review2-reply <文件名>