# docs/reviews

8 步開發迴圈**步驟 4**(兩個 reviewer 跑同一份 prompt、報告取聯集)的證據。
⚠️ **這個目錄的存在本身就是開關** —— `scripts/check-claude-md.sh --start-segment` 看到它存在,
就會要求「上一段的 commit 範圍內有新增 `docs/reviews/S<數字>*.md`」。刪掉目錄 = 退出這個慣例。

## 格式

一段一組 `S<段落>-a.md` 與 `S<段落>-b.md`,各三節:

| 節 | 寫什麼 |
|---|---|
| **派工** | 範圍(`git diff <起點> HEAD`)、取檔方式、明寫「已跑過不要重跑」的驗證、重點指示 |
| **發現** | 每一項的級別、內容、依據(實跑 / 只讀)。**兩份獨立抓到同一項要標出來** —— 那代表不是誤判 |
| **處置** | **每一項實際怎麼處理**:採納附做了什麼 / 不採納附理由 / 轉成新段落。⚠️ 這是唯一只有自己寫得出來、也是唯一看得出「發現有沒有變成修正」的一節 |

末尾加一節**兩份報告的比較**:完全重疊的、各自獨有的。獨有項通常比重疊項更有價值 ——
它說明了單發會漏掉什麼。

## 規矩

- **報告裡的行號凍結在被審的那個 commit**,不要回頭更新;但**處置欄必須保持正確**
  (它描述的是現況)。
- 真的不需要跑步驟 4 時,建 `S<段落>-SKIP.md` 寫明理由,並在 commit 訊息加
  `SKIP-REVIEW: <段落> <理由>` 這行 trailer。
  ⚠️ **「程式碼只有一行」不是合法理由** —— review 真正抓的是**註解與文件裡的宣稱**,
  那部分機械檢查蓋不到。判準是「diff 裡有沒有引別處行號 / 函式 / UI 字串 / commit 範圍的敘述」。
- ⚠️ **`docs/reviews/CLAUDE.md`(本檔)不算報告** —— 它不是 `S` 開頭接數字,改它不會讓 gate 放行。
- ⚠️ **只「修改」既有報告也不算** —— gate 用 `--diff-filter=A`,要的是**新增**。