一次交貨 ＝ 一份跨 repo 版本清單（inkstone/ISEP#84）
＋ 每次結案都留下估多久／花多久／差多少（inkstone/ISEP#85） #84：scripts/release-manifest freeze 前每一格都真的去 Gitea 抓過（抓不到不給凍結）；凍結後不准再加東西； rollback 一定吐出整份清單的每一格，--only 指名單一 repo 會被擋下 ——那正是票上那個病：剩下的還停在新版 ⇒ 一組從來沒測過的組合。 清單與 INDEX.md 寫在專案根的 releases/（不是 plugin 目錄，plugin update 會清掉）。 #85：scripts/milestone-account ＋ hooks/milestone-account-guard.sh 三個數字自己算（取自 Gitea 的 created_at／due_on／closed_at，不用手填）； 差超過 ±25%（超時或提早都算）就要從七個固定代號裡挑一個，挑不出來不准結案； 代號要有 Gitea 時間軸撐得住——訊號不成立的代號直接拒收（不採信自述）。 閘擋的是「直接 curl PATCH state=closed 但還沒記帳」，正門走 milestone-account close。 盤點數字在本樹實數（ls hooks/*.sh｜grep -c '"command":'）： hooks 53→54 支、註冊 68→69 條、scripts 39 支（描述欄舊的 38 把三個目錄也數進去了）。 順手修掉 docs/hooks-inventory.md「一句話結論」被貼兩次、且標頭 52／內文 53 互相矛盾。 測試（全部離線，不打 Gitea、不留測試票／不關真的 milestone）： scripts/test-release-manifest.sh 21/21 scripts/test-milestone-account.sh 23/23 hooks/tests/milestone-account-guard.test.sh 22/22 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016ZBu4Sa1cGntKFRBYNZ6xs
This commit is contained in:
claude-code
+12
-3
@@ -1,4 +1,4 @@
|
||||
# 52 支閘，白話盤點表
|
||||
# 54 支閘，白話盤點表
|
||||
|
||||
> 回應 `inkstone/InkStoneCo#40`：「如果加入了，我應該可以白話文看到 hooks 的內容？」
|
||||
> 這份表就是那個「白話文」——不用點開任何 `.sh` 檔，一行看懂一支閘在管什麼。
|
||||
@@ -7,8 +7,7 @@
|
||||
|
||||
## 一句話結論
|
||||
|
||||
`hooks/` 底下有 **53 個 `.sh` 檔**，`hooks.json` 實際掛上 **68 條註冊**（同一支閘常被多種情境同時掛上）；
|
||||
`hooks/` 底下有 **53 個 `.sh` 檔**，`hooks.json` 實際掛上 **68 條註冊**（同一支閘常被多種情境同時掛上）；
|
||||
`hooks/` 底下有 **54 個 `.sh` 檔**，`hooks.json` 實際掛上 **69 條註冊**（同一支閘常被多種情境同時掛上）；
|
||||
其中 **3 支檔案存在但沒被掛上**（2 支是待人填的空範本、1 支是刻意留著沒開的止血帶，見下面「未生效」表）。
|
||||
下面按「你會在什麼時候撞到它」分組，一支一行。
|
||||
|
||||
@@ -46,6 +45,15 @@
|
||||
> 順手改掉一個過期的數字：描述欄長期寫「27 支腳本」，實數是 **34**
|
||||
> （`ls -p scripts | grep -v / | wc -l`）——**同一個病，只是換一欄。**
|
||||
|
||||
> 📌 **`inkstone/ISEP#85`（2026-08-28）進來一支**：`milestone-account-guard.sh`（A 組，PreToolUse／Bash）。
|
||||
> 53→**54** 支、68→**69** 條，兩個數字都是加完之後**在自己的樹上當場數出來的**
|
||||
> （指令同上），**不是拿上一版加一**——`system-dev/wiki/mistakes.md` 記著這條：
|
||||
> 那個數字是 leo 的驗收介面，多報就是假綠。
|
||||
> 順手修掉一個真的漂移：上一版「一句話結論」那一句**被貼了兩次**（同一行連續出現兩遍），
|
||||
> 而標頭寫 52、內文寫 53——**同一頁裡三個數字互相矛盾**，正是本頁自己警告過的那種病。
|
||||
> 另外描述欄的「38 支腳本」是把 `kbdb-live-exam/`／`lib/`／`patches/` 三個**目錄**也數進去了；
|
||||
> 用本頁寫死的那道指令（只數檔案）實數是 **39**。
|
||||
|
||||
---
|
||||
|
||||
## 怎麼讀這張表
|
||||
@@ -74,6 +82,7 @@
|
||||
| `release-tag-guard.sh` | AI 想打版本 tag，但 `plugin.json` 裡寫的版本號跟 tag 對不上就擋下——避免「這裡說 0.2.0、那裡說 0.1.0」各說各話。 | 🛑 擋 |
|
||||
| `ticket-api-bypass-guard.sh` | AI 想繞過 `scripts/ticket` 工具、直接打 API 新增 Gitea 東西（開新票／milestone／label／PR，會漏掉「新增前先搜過」這道檢查）就擋下——不管是隱式 POST（urllib 傳 data= 沒寫 method）還是小寫 `requests.post(...)`。 | 🛑 擋 |
|
||||
| `milestone-due-guard.sh` | AI 想開一個新的里程碑（milestone）卻沒填期限就擋下，**填 `9999-01-01` 一樣擋**——那是「沒有期限」穿了一件期限的衣服，盤點時每一格看起來都有值，其實一格都沒有。只管「建里程碑」這個動作，查詢／改別的欄位都放行。 | 🛑 擋 |
|
||||
| `milestone-account-guard.sh` | AI 想直接打 API 把某個里程碑改成「已關閉」，卻**還沒留下「估多久／花多久／差多少／為什麼差」**就擋下。跟上一列是同一條線的兩端：那支管**開**里程碑要有真的期限，這支管**關**的時候要留下帳。走正門 `scripts/milestone-account close` 就會自己算（數字取自 Gitea 的 `created_at`／`due_on`／`closed_at`，不用手填），差超過 ±25% 才要你從**七個固定代號**裡挑一個，而且那個代號要有 Gitea 時間軸撐得住——**不採信自述**。純讀取／建里程碑／改期限／只是談論它／走正門，全部放行；真要手動關就在指令裡加 `milestone-account-ok`（留痕）。 | 🛑 擋 |
|
||||
| `reply-identity-guard.sh` | 直接打 Gitea API 貼留言到票上時，內文第一行沒有 `【身份】`（`總管`／`subagent`／`leo`）就擋下——票上多條線並行時，看不出哪一則是誰寫的。純讀取、走 `scripts/ticket` 正門、指令裡加 `reply-identity-ok` 都放行。 | 🛑 擋 |
|
||||
| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**，卻沒有把它開成一張子票時，擋一次。留言沒人會回頭讀，票的 open／closed 撈一次就看得到。 | 🛑 擋（同一輪只擋一次） |
|
||||
| `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西，然後把那筆東西的原始編號直接貼進票裡或派工單裡，當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是：不會再有人拿錯的方法量出一個錯的結論，然後退回一張其實已經做完的票。 | 🛑 擋（同一輪只擋一次） |
|
||||
|
||||
Reference in New Issue
Block a user