review

运行时注意事项

• 工作流要求暂停并等待输入时，直接询问用户。
• 将 AGENTS.md、TODO.md 和 TODOS.md 视为仓库本地说明的可能来源。
• 保持工作流的意图不变，但将任何特定于环境的措辞替换为适用于当前工具集的表述。

合并前 PR 审查

你正在运行 review 工作流。针对 main 分支分析当前分支的差异，查找测试无法发现的结构性问题。

---

步骤 1：检查分支

1. 运行 git branch --show-current 获取当前分支。
2. 如果当前分支是 main，输出：“无需审查 — 你当前位于 main 分支，或与 main 相比没有任何更改。” 然后停止。
3. 运行 git fetch origin main --quiet && git diff origin/main --stat 检查是否存在差异。如果没有差异，输出相同消息并停止。

---

步骤 2：阅读检查清单

阅读 references/checklist.md。

如果无法读取该文件，请停止并报告错误。 未阅读检查清单前，不得继续。

---

步骤 3：获取差异

获取最新的 main，避免因本地 main 过期而产生误报：

git fetch origin main --quiet

运行 git diff origin/main 获取完整差异。这包括相对于最新 main 的已提交和未提交更改。

---

步骤 4：分两轮审查

分两轮根据检查清单审查差异：

1. 第 1 轮（严重）： SQL 与数据安全、大模型输出信任边界
2. 第 2 轮（提示性）： 条件副作用、魔法数字与字符串耦合、死代码与一致性、大模型提示词问题、测试缺口、视图／前端

遵循检查清单中规定的输出格式。遵守抑制规则——不得报告“不要报告”部分列出的项目。

---

步骤 5：输出发现

始终输出所有发现——包括严重和提示性问题。用户必须看到每个问题。

• 如果发现严重问题：输出所有发现，然后针对每个严重问题，分别直接询问用户，说明问题、推荐的修复方案和选项（A：立即修复，B：确认知悉，C：误报——跳过）。 用户回答完所有严重问题后，输出用户对每个问题的选择摘要。如果用户对任何问题选择 A（修复），则应用推荐的修复方案。如果用户只选择了 B／C，则无需采取行动。
• 如果只发现非严重问题：输出发现。无需进一步操作。
• 如果未发现问题：输出 Pre-Landing Review: No issues found.

---

重要规则

• 发表评论前，阅读完整差异。 不要报告差异中已经解决的问题。
• 默认只读。 只有用户明确对严重问题选择“立即修复”时，才修改文件。绝不提交、推送或创建 PR。
• 简洁。 问题一行，修复方案一行。不写前言。
• 只报告实际问题。 没有问题的内容不要报告。