tools(agent-loop): Claude merges a stale branch itself when only docs conflict

Product owner chose option A on Jyotisha #53 (2026-10-13): being behind
staging with a docs-only merge is not a bounce and does not count toward
the two-bounce escalation. Code conflicts still go back to Grok.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LutgzyJqNhPpZy1nFsJtN3

tools/agent-loop/README.md

@@ -10,7 +10,7 @@ Claude（开发机，Linux）负责规划与验收，Grok Build（产品负责
 | --- | --- | --- |
 | `agent/待规划` | Claude：诊断 → 任务书推 staging | `agent/待执行` 或 `agent/需拍板` |
 | `agent/待执行` | Grok：按任务书在 `codex/*` 实现、自测、推分支 | `agent/待验收` 或 `agent/需拍板` |
-| `agent/待验收` | Claude：只验 Grok 回报的 SHA | 通过 → 推 staging → `agent/部署中`；不通过 → 修复单 → `agent/待执行`（打回 2 次 → `agent/需拍板`） |
+| `agent/待验收` | Claude：只验 Grok 回报的 SHA | 通过 → 推 staging → `agent/部署中`；不通过 → 修复单 → `agent/待执行`（打回 2 次 → `agent/需拍板`）；只是落后于 staging 且合并只碰文档时，Claude 自己合并，不打回、不计次数（2026-10-13 产品决定） |
 | `agent/部署中` | Claude 脚本（不用模型）：核对 `/api/health` | `agent/待真机`；3 小时未部署 → `agent/需拍板` |
 | `agent/待真机` | 产品负责人 | 关 issue，或评论问题并改回 `agent/待规划` |
 | `agent/需拍板` | 产品负责人 | 回复后改回原状态 |

tools/agent-loop/prompts/claude-review.md

@@ -8,7 +8,7 @@
 
 ## 要做的
 
-1. `git fetch origin`，`git checkout --detach <extra.sha>`。确认 `git merge-base --is-ancestor origin/staging HEAD` 成立（分支基于最新 staging 可快进）；不成立则判 `fail`，修复单要求 Grok 在最新 staging 上重做。
+1. `git fetch origin`，`git checkout --detach <extra.sha>`。确认 `git merge-base --is-ancestor origin/staging HEAD` 成立（分支基于最新 staging 可快进）；不成立时先试 `git merge --no-ff origin/staging`：若无冲突，或冲突**只在 `docs/**`、`CHANGELOG*.md` 等纯文档里**（如两单都往 `docs/BUG_HISTORY.md` 末尾加条目），由你解决冲突、提交合并（提交信息写明「只碰文档」），核对 `scripts/`、`tests/`、`frontend/` 等代码路径与被验 SHA 的树完全相同，再按下面验收并推送，**不打回、不计打回次数**（2026-10-13 产品负责人在 #53 选定方案 A）。冲突碰到任何代码文件则判 `fail`，修复单要求 Grok 在最新 staging 上重做（Grok 不能改写已推分支，用 merge 而不是 rebase）。
 2. 对照任务书逐条给出 **通过 / 未通过 / 环境缺口**。验收命令按 `CLAUDE.md`「验收口径」与 `AGENTS.md` §7、§10 跑，前端全量 `npm test` 与 Python 快速门以你这里为准。依赖缺失时先在本工作目录 `npm ci --prefix frontend`；Python 用 `.venv/bin/python`，没有就用 `python3`。
 3. `test:db` 你这里跑不了：以 Grok 回报为准，但要核对它贴的失败清单与 `tools/agent-loop/windows-known-failures.txt` 逐条一致；对不上即未通过。
 4. 检查越界：diff 里有没有任务书没要求的文件、`.gitea/**`、依赖升级、冻结文件增长、弱化断言（缺"原值 / 新值 / 原因"三栏）、隐私数据。有就 `fail`。