docs(sdlc): 補上 wp-gate.sh 工具說明與兩層閘門分工

2026-08-25 18:59:37 +08:00
parent ec23f6ee12
commit f299d1706a
2 changed files with 18 additions and 3 deletions
@@ -118,7 +118,16 @@ SDLC 各階段引用的參考分支與來源分支，**一律指遠端的 `origi

 一個工作包的 PR 還沒合併，就不得開始下一包。修正一律回原 worktree、推同一條工作分支，**不為同一包開第二個 PR**。

-查驗程序（查狀態、讀留言、詢問修正或等待、已關閉但未合併怎麼辦）由 `skills/implement/SKILL.md` 步驟 4 擁有，本檔不重複。
+這條規則在程式層強制，不靠內文自律，分工是兩層：
+
+| 層 | 誰執行 | 做什麼 |
+| --- | --- | --- |
+| 工具閘門 | `tools/wp-gate.sh` | 唯一去問 Gitea 的一方，也是唯一有權解鎖的一方。`check` 查合併狀態、印出全部留言、印 `latest=` 時間戳；`lock` 在 PR 開好後記下未結清。結束碼 0 放行、1 擋住、2 用法錯誤、3 查不到（查不到就擋，不放行） |
+| hook 提醒 | `jsc-hooks` 的 `sdlc-gate.sh wp-check` | 只讀 `$JSC_HOME/wp/` 的狀態檔，不打網路。`prompt` 模式注入提醒但**不擋提示**；`skill` 模式擋掉 `plan`、`analyze`、`maintain`，放行 `implement`——擋住的是「跳去做別的階段」，不是「回來把這一包做完」 |
+
+狀態檔不綁 session：PR 沒合併就是沒合併，開新對話照樣擋。
+
+查驗程序的細節（何時帶 `--since`、留言逐筆的處理結果、修不動的留言怎麼辦、時間戳寫回哪裡）由 `skills/implement/SKILL.md` 步驟 4 擁有，本檔不重複。

 ## 不破壞既有工作