Merge PR #127：ship-check 送達 + 版本 0.22.0

總管複驗並定版 0.22.0。ship-check 在 plugin 那份逐位元組等同真相源（md5 f565e4df）。
票：inkstone/ISEP#122

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "isep",
-      "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：51 支機械閘（64 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、27 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
+      "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：61 支機械閘（84 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、7 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、49 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
       "author": {
         "name": "Leo",
         "url": "https://uncle6.me"

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "isep",
-  "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：61 支機械閘（84 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、7 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、48 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
+  "description": "InkStone Environment Plugin —— leo 的 Claude Code 環境唯一真相源：61 支機械閘（84 條註冊，白話盤點見 docs/hooks-inventory.md）、7 支 slash command、2 支 skill、7 位有名字的工人（agents/，見 docs/governance/worker-roster.md）、49 支腳本，外加治理規範與標籤真相源。本機與雲端裝同一份，沒有子集。",
-  "version": "0.17.0",
+  "version": "0.22.0",
   "keywords": [
     "inkstone",
     "guardrails",

README.md

@@ -25,9 +25,9 @@
 |---|---|---|
 | `hooks/` | 61 支 ＋ `hooks.json` | 全部機械閘（PreToolUse／Stop／SubagentStop／SessionStart／PostToolUse／UserPromptSubmit 共 84 條註冊）。**一支一行的白話盤點在 `docs/hooks-inventory.md`，那裡才是這兩個數字的家** |
 | `agents/` | 7 位 | **工人名單**（`inkstone/ISEP#86`）——派工時指名派給誰，規約見 `docs/governance/worker-roster.md` |
-| `commands/` | 7 支 | `/wiki-recall` `/ship-check` `/cp-write` … |
+| `commands/` | 7 支 | `/wiki-recall` `/wiki-capture` `/cp-write` `/issue-handle` … |
-| `skills/` | 2 支 | |
+| `skills/` | 2 支 | `ship-check`（東西要出去之前）／`deep-recall`（把散落的枝葉還原成一棵樹）。🔴 **這兩支的內容不一定是在這裡寫的**——誰是真相源查 `docs/file-ownership.tsv` |
-| `scripts/` | 48 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
+| `scripts/` | 49 支 | `ticket`／`roster`／`isep-nag`／`wiki-compress`／`github-arm.sh` …（頂層檔案，不含 `lib/` 等子目錄） |
 
 > 🔴 這五個數字**每次都要在自己的樹上實數**，不准沿用上一版、也不准用加減推
 > （`system-dev/wiki/mistakes.md`：那是 leo 的驗收介面，多報就是假綠）：
@@ -70,6 +70,13 @@ hook 一律用官方的 `${CLAUDE_PLUGIN_ROOT}`，**不准寫死絕對路徑、
 🔴 **只改這裡，然後兩邊 `/plugin update`。**
 不要再改 `InkStoneCo/.claude/hooks/`——那個目錄退場中。
 
+🔴 **但有些檔案的內容不是在這裡寫的**（`inkstone/ISEP#122`）：
+`skills/`／`commands/`／`agents/` 底下有幾個檔案在 InkStoneCo 也有一份，
+**誰是真相源、往哪個方向修，一律查 `docs/file-ownership.tsv`**，不要憑「ISEP 一定比較新」動手
+——2026-09-02 實查，兩個方向都真的發生過（`ship-check` 是那邊新，`sdd-check` 是這邊新）。
+改完那類檔案要把 commit／sha256 兩欄一起更新；沒更新的話，
+`isep-presence-beacon.sh` 會在下一個 session 開場當著大家的面說它對不上。
+
 ## 這些閘各自在管什麼
 
 **不用點開任何 `.sh`**——`docs/hooks-inventory.md` 一支一行白話，按「你會在什麼時候撞到它」分組。

docs/TESTING.md

@@ -71,15 +71,32 @@ bash scripts/test-ticket-where-seen-guard.sh
   人就學會忽略它
 - 最後那組 `fd_is_devnull` 紅 ⇒ 判準從「fstat 問得出來的事實」滑回猜文字
 
-### A11 — 討論串裡的任務要長成子票：22 條
+### A11 — 討論串裡的任務要長成子票：29 條
 ```
 bash scripts/test-comment-carries-task-guard.sh
 ```
-**該看到**：`22/22 通過`。
+**該看到**：`29/29 通過`。全程離線（`TICKET_HOST` 指到連不上的位址），不開任何測試票。
 **失敗**：
 - 「該擋」6 條任一紅 ⇒ 08-26 那則真的掉了的留言形狀（「等雲端那半出貨才驗得了」）會漏抓
 - 「不該擋」10 條任一紅 ⇒ **誤攔，這比漏擋嚴重**——每次留言都被擋，人就學會忽略它
-- 最後兩條（`-F <檔>`）紅 ⇒ 內文放在檔案裡時閘看不到，等於走 `ticket say` 就自動繞過
+- `-F <檔>` 那兩條紅 ⇒ 內文放在檔案裡時閘看不到，等於走 `ticket say` 就自動繞過
+- **⑮～⑳（`inkstone/ISEP#112`）**：這一組驗的不是「有沒有擋」，是**擋下來之後教的那條路走不走得通**。
+  - ⑮⑯ 紅 ⇒ 訊息又印出相對路徑的 `scripts/ticket`。相對路徑是對**貼上去那個人的 cwd**
+    解析的，而 `InkStoneCo/scripts/ticket` 是舊複本（`grep -c subtask` → 0）
+    ⇒ 照著貼會印出它「四個動詞」的說明然後什麼都沒發生。
+  - ⑰ 紅 ⇒ 閘又自己抄了一份用法（它應該去 `ticket usage subtask` 現要）。
+  - **⑱ 紅 ⇒ 最嚴重**：把訊息裡那塊指令原樣抽出來、只填標題／目標／驗收條件三格，
+    **真的執行**，離開碼必須是 1（走到網路才停）。是 2 就表示又被某道閘擋下，
+    這張票的病復發了。
+  - ⑲ 是 ⑱ 的鑑別力對照（把閘原本那組 `--assign` 沒配 `--next` 接回去，必須紅）；
+    ⑲ 綠不了就代表 ⑱ 那條綠燈沒有意義。
+  - ⑳ 紅 ⇒ 內文草稿模板跟 `REQUIRED_SECTIONS` 分家了，會生出「照著貼卻過不了自己那道閘」的票。
+  - ㉑ 紅 ⇒ 正本叫不動時（雲端裝壞、路徑不對）閘不是不擋了，就是**又在訊息裡補了一份手抄用法**。
+    fail-open 的只准是「訊息內容」，不准是「擋不擋」；而補一份副本就是把這張票拔掉的東西裝回去。
+
+> 🔴 **這一組刻意驗訊息內容，不是只驗離開碼。** `system-dev/wiki/mistakes.md`
+> 記過：訊息壞掉時閘照樣 `exit 2`，只看離開碼完全看不出來——
+> 而這張票（`inkstone/ISEP#112`）就是那個形狀的極端版：**閘擋對了，但它教的解法根本不存在。**
 
 ### A12 — 收工要把棒子交回來：10 條
 ```
@@ -313,11 +330,19 @@ bash hooks/tests/unpushed-police.test.sh
 - B 群（⑦—⑩，該報）任一紅 ⇒ 為了不吵而改成放行了，那是把閘關掉不是修好
 - 特別看 ④：問不到遠端（離線）**不准當成「你沒推」**
 
-### A18 — 信標會講出雲端會壞掉的那三件事：14 條
+### A18 — 信標會講出雲端會壞掉的那幾件事：26 條
 ```
 bash hooks/tests/isep-presence-beacon.test.sh
 ```
-**該看到**：`通過 14 條，失敗 0 條`。全離線。
+**該看到**：`通過 26 條，失敗 0 條`。全離線。
+
+> 📌 `inkstone/ISEP#122` 從 14 條加到 26 條：信標原本只掃 `scripts/`，
+> 而**真正會自動載入的東西**（skill／command／agent）同樣兩邊各有一份。
+> 實查：那 9 個檔案在 `0.1.0`（c263866）複製過來之後**一次都沒再同步**，
+> 到 2026-09-02 已經分家兩個、而且**方向相反**——
+> `skills/ship-check/SKILL.md` 是 InkStoneCo 那邊新，`commands/sdd-check.md` 是 ISEP 這邊新。
+> ⇒ 所以新增的不只是「有沒有掃到」，還有「**說不說得出真相源是哪一份**」
+> （`docs/file-ownership.tsv`），以及**雲端沒有專案那一份可比時**改用 sha256 單邊驗。
 
 **它在守什麼**（inkstone/ISEP#90 ②③）：信標原本只證明「有一份 plugin 載入了」，
 不證明「載入的是哪一份」——08-27 雲端載 0.3.9、main 0.9.0，差 7 個 release，
@@ -329,6 +354,71 @@ bash hooks/tests/isep-presence-beacon.test.sh
 - ⑤⑦ 紅 ⇒ 舊複本遮蔽正門抓不到（`InkStoneCo/scripts/ticket` 那件）
 - ⑥ 紅 ⇒ **誤攔**：同步過的複本被念，人就學會忽略它
 - ⑪ 紅 ⇒ 內層迴圈變數撞名的回歸（同一個 `.claude` 下第二個殘骸會被靜靜跳過）
+- ⑮⑱⑲⑳ 任一紅 ⇒ 自動載入的分身抓不到（`ship-check` 那件會再發生一次）
+- ⑰ 紅 ⇒ **誤攔**：同步過的複本被念，人就學會忽略它（跟 ⑥ 同一條線）
+- ㉔ 紅 ⇒ 雲端唯一還作數的那個檢查失效（薄殼沒有 InkStoneCo 可以比）
+- ㉕ 紅 ⇒ **誤攔**：還沒登記 sha256 的檔案被當成「被改過」
+
+### A29 — 閘印出來的逃生門，照著打真的過得去：10 條
+> 📌 編號跳過 A27／A28：那兩格被同一張票的 PR `inkstone/ISEP#124` 佔著（還沒併）。
+```
+bash hooks/tests/history-first-guard.test.sh
+```
+**該看到**：`通過 10 條，失敗 0 條`。全離線，全程用 `KBDB_STAMP_DIR` 指到 TMP，
+**不碰這台機器真正的 `/tmp/.kbdb-*` 戳記**（清掉別人的戳記＝把閘弄成隨機的）。
+
+**它在守什麼**（`inkstone/ISEP#122`，2026-09-02 實撞）：`history-first-guard.sh` 印的
+`🚪 KBDB 真的連不上：touch /tmp/.kbdb-down 後重送` 是**假的**——
+`touch` 造出來的是空檔，而那支閘讀的是**檔案內容**當時戳，空字串被當成 0
+⇒ 「距今 17 億秒」⇒ 永遠不新鮮 ⇒ **照著訊息打完，被一模一樣地擋第二次**。
+
+🔴 這跟本票 comment 6071、`inkstone/ISEP#125` 是同一句話：
+**閘印出來的下一步，沒有人實際照著打過一次。**
+
+**失敗**：
+- ④ 紅 ⇒ 逃生門又是假的（這是本支唯一分辨得出新舊版的那一格，見檔頭）
+- ⑦ 紅 ⇒ 逃生門變成永久後門（一次 `touch` 就免疫，過期不算數這件事沒了）
+- ⑧⑨⑩ 任一紅 ⇒ **誤攔**：文件／新檔／測試檔本來就不該被這支碰
+
+### A30 — 測試沙盒傳錯參數時要在**複製之前**收手：10 條
+```
+bash hooks/tests/hook-sandbox.test.sh
+```
+**該看到**：`通過 10 條，失敗 0 條`。全離線。
+
+**它在守什麼**（`inkstone/ISEP#122`，2026-09-02 實撞，**兩次**）：
+`hooks/tests/lib/hook-sandbox.sh` 的 `hook_sandbox <hook 的檔案路徑>` 舊版**不驗參數**，
+直接 `cp -R "$(dirname "$1")"`。順手把 repo 根目錄傳進去時：
+
+```
+$ bash hooks/tests/main-and-prod-push-guard.test.sh "$PWD"
+   dirname → ~/Documents/tech_projects        ← 上一層，不是 hooks/
+   cp -R   → 整個 tech_projects（所有 repo、所有 worktree）搬進 mktemp
+   實測      一次 13 GB＋一次 10 GB，磁碟可用從 25 GB 掉到 462 MB
+   印出來的  ❌ 沙盒建不起來                    ← 只有這一句
+```
+
+🔴 **它沒說參數傳錯，也沒說它已經把磁碟寫滿了。**
+判準用「要求某個東西在場」（`$1` 要是真的檔案；上一層要叫 `hooks`），
+不是關鍵字比對——兩條任一不成立就在 `mktemp` 之前 `return 1`。
+
+📌 **正確用法**（兩支需要傳參數的測試，`docs/TESTING.md` 之前沒寫過）：
+```
+bash hooks/tests/main-and-prod-push-guard.test.sh            hooks/main-and-prod-push-guard.sh
+bash hooks/tests/main-and-prod-push-guard-cross-repo.test.sh hooks/main-and-prod-push-guard.sh
+bash hooks/tests/prod-write-guard.test.sh                    hooks/prod-write-guard.sh
+bash hooks/tests/stage-before-prod-guard.test.sh             hooks/stage-before-prod-guard.sh
+bash hooks/tests/gitea-arm-check.test.sh                     .
+```
+**不傳的後果不是報錯，是假綠**：`prod-write-guard.test.sh` 的 `HOOK="$1"` 空掉時
+每一條都執行空指令回 0 ⇒ 「該擋」全部變成「實得 pass」，**19 條假紅**
+（同一支傳對參數是 `通過 37 ／ 失敗 0`）。不必自己傳參數的包裝在
+`scripts/test-main-and-prod-push-guard.sh`。
+
+**失敗**：
+- ①③⑤⑥ 任一紅 ⇒ 收手收得太晚，暫存區已經開始長東西（磁碟風險回來了）
+- ② 紅 ⇒ 訊息沒給出走得通的那一行（本票整張票在講的就是這件事）
+- ⑧⑨⑩ 任一紅 ⇒ **誤攔／複製錯**：正常用法被弄壞，或複本裡混進了 `hooks/` 以外的東西
 ### A19 — 下游做完時頂層跟著關：49 條
 ```
 bash scripts/test-ticket-handoff-writeback.sh
@@ -547,6 +637,47 @@ bash hooks/tests/sdd-guard-retired.test.sh
 🔴 **順序不可顛倒**：要等這一版 ISEP 出去、兩邊 `/plugin update` 之後，
 那半才動得——先拿掉 active SDD 就會鎖死。
 
+### A26 — 雲端該有的憑證清單，這台機器真的拿得到：11 條
+```
+bash scripts/test-make-cloud-env.sh
+```
+**該看到**：`11/11 通過，跳過 0 條`（清單現在是 10 把——兩台全給 ＋ 機器帳號 ＋ uncle6 出貨 ＋ Arcrun 出貨線的實例 namespace）。**全程只印變數名字與值的長度，一個字元的值都不印。**
+A 段用假的 `.env` 隔離跑（不碰真金鑰、不碰 `~/.claude/cloud-env`）；
+B 段拿這台機器真正的 `.env` 對帳——**`.env` 不在的機器（雲端就是）會印 `⏭️ SKIP`**，
+不算失敗，但也不算驗過。
+
+**它在守什麼**（inkstone/ISEP#115，2026-09-01 實撞）：
+`make-cloud-env.sh` 的 `NEEDED` 是「雲端總管手上有哪些憑證」的**唯一**清單。
+那天雲端要清空 youlin，`env | grep -ciE 'cloudflare|^CF_|wrangler'` → **0**——
+不是雲端漏設，是**這份清單裡從來沒有任何 CF 憑證**。
+🔴 更貴的是它**發生在流程末端**：工人已經把清空腳本與測試都寫完了，
+到要真的跑的那一刻才知道跑不了。
+
+**失敗**：
+- **B7 紅** ⇒ 清單上有一把這台機器根本拿不到值 ⇒ leo 貼出去的會是
+  `<🔴 找不到>`，而雲端要到**用到那一刻**才知道。這就是 ISEP#115 那一天的形狀
+- **B8 紅** ⇒ 清單裡混進了值出自 `polaris/mira/.env` 的變數，那是 **leo21c 現役正式環境**。
+  leo 2026-08-20 已把那 7 把分進 B 段並選擇不放（`inkstone/InkStoneCo#14` → comment `3890`）
+- **B9 紅** ⇒ 清單裡有一把的**值**就是 `CLOUDFLARE_API_TOKEN_leo21c`。
+  leo 2026-09-01 的紅線是「那把不准加」，而 B9 比的是值不是名字 ⇒ **改個名字照樣紅**
+- **B8x 紅或長期 SKIP** ⇒ B8 的偵測**不會亮**。全綠有兩種可能（真的沒有正式憑證／
+  偵測根本壞了），分不開就等於沒驗
+- **A5a／A5b 紅** ⇒ 缺值時不會被標成 `<🔴 …>`、收尾也不點名 ⇒ **假綠**，
+  而假綠正是這張票要解的病
+- **A6 紅** ⇒ 有東西被寫進 repo。那支腳本的產物含金鑰真身，**刻意不在任何 repo 裡**
+
+> 🔴 **B8 與 B9 的判準都不是名字，是機器算得出來的事實。**
+> B8 看「值從哪個檔案拿到的」，B9 看「這個值是不是就是 leo21c 那把」。
+> **兩條是分工不是重複**：`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** `.env`，
+> 不在 `polaris/mira/.env` ⇒ B8 抓不到它，那就是 B9 存在的理由。
+>
+> **兩條的「該紅」方向都實跑過**（2026-09-01，拋棄式副本，分支一個字沒動）：
+> ```
+> 混進 mira 的 NAMESPACE      → ❌ B8 …want=0 got=1，並指出「來自 polaris/mira/.env」
+> 把 leo21c 那把改名 CF_TOKEN_BACKUP → ❌ B9 …want=0 got=1（B8 此時仍綠，因為值不出自 mira）
+> ```
+> ⇒ 第二條正是黑名單會放過去的形狀。
+
 ### A5 — 開票前的搜尋是跨 repo 的
 ```
 python3 scripts/ticket where 標籤 模組化
@@ -715,9 +846,11 @@ bash scripts/make-cloud-env.sh
 
 打開上一步產生的檔，裡面兩塊分別貼進 claude.ai → **Cloud environments** → 你的環境：
 
-1. **Environment variables** 加一個
+1. **Environment variables**：把 ① 區塊**每一行**都貼進去（一行一個，名字與值分開填）。
-   - 名稱：`GITEA_TOKEN_CLAUDE_CODE`
+   現在是 2 個：`GITEA_TOKEN_CLAUDE_CODE`（機器帳號 Gitea token）與
-   - 值：**既有的** claude-code 機器帳號 Gitea token（不要新造一把）
+   `CLOUDFLARE_API_TOKEN_YOULIN_CC_USE`（youlin ＝ AI 的 stage 實例）。
+   🔴 **不要照這裡的名字數**——以腳本產出的 ① 區塊為準，這份文件會落後。
+   值全部是**既有的**，一把都沒有新造。
 2. **Setup script** 欄位：貼進 `docs/cloud-setup-script.sh` 的全文，一字不改。
 
 **該看到**：儲存後沒有紅字。
@@ -815,6 +948,7 @@ B2（信標那行）／B3（setup 輸出）／B4（閘的訊息）三個畫面
 | **A12 留言身份欄（兩道門）** | 總管 | ✅ 11/11（2026-08-27） |
 | **A23 同時跑的線有上限** | isep-guard | ✅ 33/33（2026-08-29，inkstone/ISEP#109） |
 | **A24 一條線要有自己的工作目錄** | isep-guard | ✅ 35/35（2026-08-29，inkstone/ISEP#109→5391） |
+| **A26 雲端憑證清單這台拿得到** | isep-hand | ✅ 11/11（2026-09-01，inkstone/ISEP#115→5526／5541／5542／5577）＋兩條「該紅」方向實跑 |
 | **A16 放行的門真的打得開** | 總管 | ✅ 17/17（2026-08-28，inkstone/ISEP#90） |
 | **A17 未推警察不誤攔雲端分支** | 總管 | ✅ 10/10（2026-08-28，inkstone/ISEP#90） |
 | **A18 信標會報雲端接線缺陷** | 總管 | ✅ 14/14（2026-08-28，inkstone/ISEP#90） |

docs/file-ownership.tsv

@@ -0,0 +1,30 @@
+# file-ownership.tsv — 同一個檔案兩邊都有時，**哪一份是真相源**（inkstone/ISEP#122）
+#
+# 為什麼要有這張表（2026-09-02 實查，兩個方向都真的發生過）：
+#   skills/ship-check/SKILL.md    InkStoneCo 那份前進到 651 行，ISEP 停在 595 行
+#   commands/sdd-check.md         ISEP 那份前進到  81 行，InkStoneCo 停在 65 行
+#                                 （InkStoneCo 那份還在教已經退役的「唯一 active SDD」）
+# ⇒ 「ISEP 一定比較新」是錯的，「InkStoneCo 一定比較新」也是錯的。
+#   兩邊都會被就地編輯，所以歸屬**不能靠人記得**，要寫下來、而且要有東西去比對。
+#
+# 誰在用這張表：`hooks/lib/beacon_report.py`（SessionStart 信標，只報告、不擋人）
+#   ① 兩邊內容不同時 → 照這張表講出「真相源是哪一份、該往哪個方向修」
+#   ② 表上有 sha256 時 → 順便驗 ISEP 這份有沒有被就地改過（雲端沒有 InkStoneCo
+#      可以比，這一格是那時唯一還能作數的檢查）
+#
+# 規約三條：
+#   1. **只有內容會分家的檔案才需要一列。** 兩邊一模一樣時不必登記，信標也不會出聲。
+#   2. 真相源是 `inkstone/InkStoneCo` ⇒ **內容要改就改在那裡**，改完把檔案原樣搬過來、
+#      更新 ④⑤ 兩欄、升版。**不要在 ISEP 這邊改內容**（改了兩邊就各自演化，就是本表要解的病）。
+#   3. 真相源是 `inkstone/ISEP` ⇒ 專案那份是退場中的舊複本，該被同步或刪掉；
+#      ③④⑤ 三欄填 `-`。
+#
+# 欄位（TAB 分隔，5 欄）：
+#   ① plugin 內路徑
+#   ② 真相源 repo
+#   ③ 真相源在那個 repo 裡的路徑（真相源就是 ISEP 時填 `-`）
+#   ④ 這一份是從哪顆 commit 搬過來的（同上，填 `-`）
+#   ⑤ 搬過來的當下 sha256（同上，填 `-`）
+#
+skills/ship-check/SKILL.md	inkstone/InkStoneCo	.claude/skills/ship-check/SKILL.md	bd52fa3a508cbfb29755ddc24923c6fea8c3fbf7	847967830007e804a16dec9adfc5d4120c233445649d4d5cdd34b04550fb3270
+commands/sdd-check.md	inkstone/ISEP	-	-	-

docs/governance/sdd-gitea-governance.md

@@ -853,7 +853,7 @@ scripts/ticket mine [--user <誰>]
 
 | 閘 | 掛在哪 | 抓什麼 | 測試 |
 |---|---|---|---|
-| `hooks/comment-carries-task-guard.sh` | PreToolUse `Bash` | 留言裡帶「等 X 才…／驗不了／還沒…」這種**未完成的未來式**，卻沒開子票 → 擋一次 | `scripts/test-comment-carries-task-guard.sh`（22 條） |
+| `hooks/comment-carries-task-guard.sh` | PreToolUse `Bash` | 留言裡帶「等 X 才…／驗不了／還沒…」這種**未完成的未來式**，卻沒開子票 → 擋一次 | `scripts/test-comment-carries-task-guard.sh`（29 條） |
 | `hooks/baton-handback-guard.sh` | PostToolUse `Agent\|Task` | 一條線收工，票上**指派／tag／下一步**缺哪一格 → 當場說出來（提醒，不擋） | `scripts/test-baton-handback-guard.sh`（10 條） |
 
 🔴 **兩支閘的誤攔設計**：`comment-carries-task-guard` 同一 session 只擋一次，

docs/hooks-inventory.md

@@ -128,7 +128,7 @@
 | `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 撈一次就看得到。 | 🛑 擋（同一輪只擋一次） |
+| `comment-carries-task-guard.sh` | AI 要在票裡留一則「等某某上線才驗得了」這種**還沒做完的事**，卻沒有把它開成一張子票時，擋一次。留言沒人會回頭讀，票的 open／closed 撈一次就看得到。**擋下來時印的是一整塊可以直接貼著跑的指令**（腳本用絕對路徑、母票已經填好、內文草稿附在同一塊裡），那塊字是跟 `scripts/ticket usage subtask` 現要的，不是閘自己抄的一份（`inkstone/ISEP#112`）。 | 🛑 擋（同一輪只擋一次） |
 | `search-is-not-proof-guard.sh` | AI 用知識庫的**搜尋**找到一筆東西，然後把那筆東西的原始編號直接貼進票裡或派工單裡，當成「某個功能壞了」的證據——而它從沒用正規的檢索路徑去查過那筆——擋一次。你關心的是：不會再有人拿錯的方法量出一個錯的結論，然後退回一張其實已經做完的票。 | 🛑 擋（同一輪只擋一次） |
 | `line-needs-own-worktree.sh` | 一條派工線想在**大家共用的那份工作目錄**裡切分支（`git checkout`／`git switch`）就擋下，叫它先開一份自己的 worktree。你關心的是：不會再有人交回工作時把某個 repo 留在自己的分支上，而下一個人在同一個目錄跑出貨、讀到的是別人留下的 HEAD。**總管在自己的目錄裡切分支不管**（那是他的目錄）；已經在自己 worktree 裡的切換全部放行；還原檔案（`git checkout -- 檔`）不管。擋下來的同時會順手把「指向空氣」的 worktree 登記清掉。 | 🛑 擋 |
 | `diagnosis-evidence-guard.sh` | 你想把一段有份量的東西寫上票，而這個 session **沒派人去查過那張票**、那段話裡也**沒有任何走得過去的出處**（檔案:行號／commit／comment 號／票號／網址／貼出來的實測輸出）就擋一次——未經調查的診斷寫在票上會長得像事實，工人會照著它去驗證而不是去查。派過人查、或把出處帶上，都放行；一句短回覆不管。 | 🛑 擋 |
@@ -203,7 +203,7 @@
 
 | 閘名 | 對你意味著什麼 | 動作 |
 |---|---|---|
-| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。 | 📝 記錄（context 注入） |
+| `isep-presence-beacon.sh` | 對話一開始印一行 `🟢 ISEP vX.Y.Z 已載入（N 支閘｜來源：…）`。**這行不是裝飾，是唯一能證明「這個 session 真的有閘」的東西**——它自己就住在 plugin 裡，看得到它就表示 plugin 載入了；某個 session 從頭到尾沒有這行，那個 session 是零閘狀態，先修 plugin 再做事。同一台機器可能同時有兩份 ISEP（marketplace 裝的、repo 裡 vendor 的），所以那行會講出這次是哪一份在說話。它另外會報四件「這一份是不是還有效」：①這一份落後 ISEP main 幾版 ②專案裡有沒有內容不同的同名**腳本**②b 專案裡有沒有內容不同的同名**skill／command／agent**——這些是**自動載入**的，載到舊的那份不會有任何症狀，只會安靜地教錯的東西（`docs/file-ownership.tsv` 說得出每一組的真相源是哪一份、往哪個方向修）②c 本身的內容跟那張歸屬表對不對得上（雲端沒有專案那一份可比時，這是唯一還作數的檢查）③工作區有沒有已退役機制留下的產物。**全部只講不擋。** | 📝 記錄（context 注入） |
 | `session-start-recall.sh` | 對話一開始就自動把「全局現況」（Gitea 各 repo 的票、KBDB 的藏書地圖）推到 AI 眼前，不必等它自己想到要查。 | 📝 記錄（context 注入） |
 | `scripts/mainline refresh` | （不是閘，是腳本）對話一開始把**現在的主線**那條 milestone 的進度與期限更新一次，好讓每回合眼前那一行講的是今天的數字。拿不到 Gitea 就原封不動——**寧可資料舊，不要把主線弄丟**。跑一次就結束，不輪詢。 | 📝 記錄 |
 | `overdue-nag-guard.sh` | 對話一開始就去 Gitea 撈**沒有人會叫的事**：逾期的 milestone、掛著等你的票（標「等了幾天」）、標著「有人在做」卻好幾天沒動的票；撈完用白話講出來，**有事就發 Telegram 給你**。沒東西可報時它會說「查過了，沒有」——**安靜跟壞掉長得一模一樣**。發不出去時不會靜默：它會先問這個 session 的 `prod-write-guard` 會不會擋（舊版把「發通知」誤認成「部署」），擋就改貼回票上並把原文印在眼前。只在開 session 時跑一次，**不輪詢、不掛排程**。 | 📝 記錄（context 注入 ＋ Telegram） |
@@ -252,7 +252,7 @@
 
 | 閘名 | 對你意味著什麼 | 動作 |
 |---|---|---|
-| `history-first-guard.sh` | AI 要改一個舊檔案之前，先把這個檔案過去被改過幾次、被誰在什麼情況下改過的紀錄攤在它眼前，逼它回答「這是不是已經修過的老問題」再動手。 | 🛑 擋 |
+| `history-first-guard.sh` | AI 要改一個舊檔案之前，先把這個檔案過去被改過幾次、被誰在什麼情況下改過的紀錄攤在它眼前，逼它回答「這是不是已經修過的老問題」再動手。前面還有第 0 道：這一小時內有沒有問過 KBDB。**KBDB 連不上時 `touch /tmp/.kbdb-down` 就放行**——這條逃生門 2026-09-02 之前是壞的（`touch` 造的是空檔，而它讀的是檔案內容）**照著訊息打完還是被擋**，`inkstone/ISEP#122` 修好並補了迴歸測試。 | 🛑 擋 |
 
 ---
 

hooks/comment-carries-task-guard.sh

@@ -103,10 +103,64 @@ WARNED="/tmp/.comment-task-guard-warned-$SID"
 [ -f "$WARNED" ] && exit 0     # 同一 session 只擋一次，不鬼打牆
 date +%s > "$WARNED"
 
-cat >&2 <<EOF
+# ── 出路要真的走得通（inkstone/ISEP#112）────────────────────────────────
+#
+# 這支閘 08-27 上線時印的是 `scripts/ticket subtask …`，而那一行**跑不動**，
+# 兩個獨立的原因（2026-08-31 實測，各自都足以害死它）：
+#
+#   ① 相對路徑對「貼上去那個人的 cwd」解析。總管的 cwd 是 `InkStoneCo/`，
+#      那裡的 `scripts/ticket` 是舊複本（`grep -c subtask` → 0），
+#      照著貼只會印出它「四個動詞」的說明然後 exit 0。
+#   ② 用法是**手抄的第二份**，而它已經漂了：寫了 `--assign` 卻沒有 `--next`，
+#      而正本會因為「指派了人卻沒寫 --next」直接擋下。
+#
+# 票上的判決：「**當它教的做法不存在，它就從『幫你』變成『擋你』**——
+#   而且被擋的人當下正在做別的事，最可能的反應是找個理由繞過去。」
+#
+# 🔴 所以這裡**不准再抄一份用法**。整塊指令去正本要：
+#      "$TICKET" usage subtask --example --parent <母票> --draft <草稿路徑>
+#    正本印的路徑是它自己的 `__file__`（絕對路徑）⇒ 印指令的人與跑指令的人
+#    是同一個檔案，沒有第二種可能。
+ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+TICKET="$ROOT/scripts/ticket"
+
+# 母票是誰：兩條路都認（走正門 `ticket say`，或直接打 API）。認不出來就留 <母票 …>，
+# 正本那邊會照樣印出可讀的樣板——**寧可少填一格，不要猜錯一張票**。
+PARENT=$(printf '%s' "$CMD" | python3 -c '
+import re, sys
+c = sys.stdin.read()
+m = re.search(r"/repos/([\w.-]+)/([\w.-]+)/issues/(\d+)/comments", c)
+if m:
+    print("%s/%s#%s" % m.groups()); raise SystemExit
+m = re.search(r"\bticket\s+say\s+([\w.-]+)/([\w.-]+)#(\d+)", c)
+if m:
+    print("%s/%s#%s" % m.groups())
+' 2>/dev/null)
+
+DRAFT="/tmp/isep-subtask-$SID.md"
+EXAMPLE=$(python3 "$TICKET" usage subtask --example \
+            ${PARENT:+--parent "$PARENT"} --draft "$DRAFT" 2>/dev/null) || EXAMPLE=""
+MORE=$(python3 "$TICKET" usage subtask 2>/dev/null) || MORE=""
+
+# fail-open 的**訊息**（不是閘）：正本叫不動時仍然要擋，但不准在這裡補一份手抄用法
+# ——那樣就把剛拔掉的那個副本裝回來了。只指路，指到唯一那一份。
+LEAD="整段複製貼上就跑得動。腳本是絕對路徑、母票已經填好、必填段落已經在草稿裡，
+  只剩三格是機器不可能知道的：標題、目標、驗收條件——改完那三格再送。
+  （下面這塊**不要縮排**，\`<<'MD'\` 的結束標記要頂在行首。）"
+if [ -z "$EXAMPLE" ]; then
+  LEAD="把它長成子票。**這台機器叫不動正本，所以下面只給路、不給整塊指令**
+  ——這裡刻意不補一份手抄的用法，那份副本正是 inkstone/ISEP#112 拔掉的東西。"
+  EXAMPLE="python3 $TICKET usage subtask --example"
+  MORE=""
+fi
+
+# 🔴 訊息一律用 `<<'EOF'`（標記加引號）＋ 事後用 python 換佔位符。
+#    ISEP wiki mistakes.md 記過：不加引號的 heredoc 會把訊息裡的反引號當命令執行，
+#    而**閘照樣 exit 2，所以只看離開碼的測試完全看不出來**。
+MSG=$(cat <<'EOF'
 🎫 這則留言裡藏著一件**還沒做完的事**，而它現在只是文字。
 
-命中的詞：$HIT
+命中的詞：__HIT__
 
 【leo 2026-08-27】「**每個任務長出子票做為這張票的相依⋯⋯票沒完工可以察覺嗎？**」
 
@@ -115,18 +169,32 @@ cat >&2 <<EOF
   08-26 18-23  總管真的出貨了                                          ← 條件滿足，沒人知道
   08-27 11:xx  leo 問「這 14 小時前的，你派了還是沒派？」               ← 才被撿起來
 
-【怎麼做】把它長成子票，Gitea 原生相依會**硬擋**母票關閉（實測 412）：
+【怎麼做】__LEAD__
 
-  scripts/ticket subtask <母票 owner/repo#N> \\
+__EXAMPLE__
-      --title "身為<誰>，我要<什麼>，我才<為什麼>" \\
+__MORE__
-      -F <內文檔> --label s/todo --assign <誰做>
+  ⇒ 子票沒關，母票關不掉。**不是提醒，是平台保證**（Gitea 原生相依，實測 412）。
-
-  ⇒ 子票沒關，母票關不掉。**不是提醒，是平台保證。**
 
 【粒度】leo 2026-08-27：「**小任務做完就關閉，不會讓池子爆掉，
   每個事情沒有歷史記錄才是大問題**」⇒ 判準是「這件事需要被記得嗎」，
   傾向**多開票**。不要用「會不會太多」當理由不開。
 
-【真的不是待辦】在指令裡加 \`no-subtask: <一句理由>\` 重送（留痕）。
+【真的不是待辦】在指令裡加 `no-subtask: <一句理由>` 重送（留痕）。
 EOF
+)
+
+MORE_BLOCK=""
+[ -n "$MORE" ] && MORE_BLOCK="
+  還有哪些參數（指派給誰＋下一步、旅程標籤、換 repo）：
+$(printf '%s' "$MORE" | sed 's/^/    /; s/[[:space:]]*$//')
+"
+
+HIT="$HIT" LEAD="$LEAD" EXAMPLE="$EXAMPLE" MORE_BLOCK="$MORE_BLOCK" MSG="$MSG" python3 -c '
+import os, sys
+m = os.environ["MSG"]
+for k in ("HIT", "LEAD", "EXAMPLE"):
+    m = m.replace("__%s__" % k, os.environ.get(k, ""))
+m = m.replace("__MORE__", os.environ.get("MORE_BLOCK", ""))
+sys.stderr.write(m + "\n")
+'
 exit 2

hooks/history-first-guard.sh

@@ -56,15 +56,32 @@ STAMP="/tmp/.history-guard-$(printf '%s' "$FILE_PATH" | shasum | cut -c1-12)"
 #
 # 時戳由 kbdb-asked-stamp.sh（PostToolUse，matcher 對 kbdb_* 工具）寫下。
 # 逃生口：KBDB 真的連不上時 `touch /tmp/.kbdb-down`——放行但留痕，且回覆裡要說明。
-KBDB_STAMP=/tmp/.kbdb-asked
+#
-KBDB_DOWN=/tmp/.kbdb-down
+# 🔴 **逃生門要真的走得通**（inkstone/ISEP#122，2026-09-02 實撞，本檔第二次修）：
+#   上面那句訊息叫人 `touch /tmp/.kbdb-down`，而 `touch` 造出來的是**空檔**
+#   ⇒ 舊版 `t=$(cat "$f")` 讀到空字串 ⇒ 算式當成 0 ⇒ 「距今 17 億秒」
+#   ⇒ 永遠不新鮮 ⇒ **照著訊息打完，還是被擋**。
+#   實測（2026-09-02，KBDB 兩支工具都回 Connection closed 時）：
+#     $ touch /tmp/.kbdb-down   →  再送同一個編輯  →  一模一樣的擋，訊息一字不差
+#   ⇒ 那行逃生門是印出來好看的，**沒有人照著打過一次**
+#     （同族：ISEP#125 worktree 閘印的逃生門原文照打 rc=2；本票 comment 6071）。
+#
+#   改法：**內容不是數字就用檔案的 mtime**——`touch` 做的正是更新 mtime，
+#   所以訊息裡那一行從此真的走得通，而 `kbdb-asked-stamp.sh` 寫數字的舊格式照樣相容。
+#   路徑用 `KBDB_STAMP_DIR` 可覆寫，**只為了讓迴歸測試不去動這台機器真正的戳記**
+#   （測試把別的 session 的戳記清掉＝把閘弄成隨機的）。
+KBDB_STAMP="${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked"
+KBDB_DOWN="${KBDB_STAMP_DIR:-/tmp}/.kbdb-down"
 kbdb_fresh=0
 now=$(date +%s)
 for f in "$KBDB_STAMP" "$KBDB_DOWN"; do
-  if [ -f "$f" ]; then
+  [ -f "$f" ] || continue
-    t=$(cat "$f" 2>/dev/null || echo 0)
+  t=$(cat "$f" 2>/dev/null || true)
-    [ $((now - t)) -lt 3600 ] && kbdb_fresh=1
+  case "$t" in
-  fi
+    ''|*[!0-9]*) t=$(date -r "$f" +%s 2>/dev/null || stat -c %Y "$f" 2>/dev/null || echo 0) ;;
+  esac
+  [ "${t:-0}" -gt 0 ] || continue
+  [ $((now - t)) -lt 3600 ] && kbdb_fresh=1
 done
 if [ "$kbdb_fresh" -eq 0 ]; then
   cat >&2 <<'KEOF'

hooks/kbdb-asked-stamp.sh

@@ -16,5 +16,6 @@
 #   KBDB（一次看所有庫，最便宜）→ 該 repo 的 wiki/tasks → git log -S → 讀源碼（最貴，
 #   只看得到「現在長怎樣」，看不到「為什麼變成這樣」）
 set -eu
-date +%s > /tmp/.kbdb-asked
+# 路徑跟 history-first-guard.sh 用同一個覆寫變數，否則測試會兩邊指到不同地方
+date +%s > "${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked"
 exit 0

hooks/lib/beacon_report.py

@@ -1,6 +1,7 @@
-# ── 以下三格是 inkstone/ISEP#90 加的「這一份是不是還有效」自檢 ──────────
+# ── 以下五格是「這一份是不是還有效」自檢 ─────────────────────────────
+#    ①②③ inkstone/ISEP#90 立；②b②c inkstone/ISEP#122 補（會自動載入的東西也有分身）
 # 都**只是報告，不擋任何事**（SessionStart 本來就不該擋），而且每一格拿不到答案就閉嘴。
-import json, os, re, subprocess, sys, time, urllib.request
+import hashlib, json, os, re, subprocess, sys, time, urllib.request
 
 ROOT = os.environ.get("CLAUDE_PLUGIN_ROOT", "")
 PROJ = os.environ.get("CLAUDE_PROJECT_DIR") or os.getcwd()
@@ -103,6 +104,144 @@ if sh:
         "在雲端一律死在「拿不到 gitea token」。要嘛刪掉複本改叫 "
         "`\"$CLAUDE_PLUGIN_ROOT\"/scripts/<名字>`，要嘛把複本同步回 ISEP。" % "、".join(sh))
 
+# ══ ②b 會**自動載入**的東西（skill／command／agent）兩邊各有一份而內容不同 ══
+#
+# 🔴 為什麼上面那一格抓不到（inkstone/ISEP#122，2026-09-02 實查）：
+#   ② 只掃 `scripts/`。而真正會**自動載入**的東西住在別的目錄，同樣兩邊各有一份：
+#     plugin `skills/<名>/SKILL.md`  ↔ 專案 `.claude/skills/<名>/SKILL.md`
+#     plugin `commands/<名>.md`      ↔ 專案 `.claude/commands/<名>.md`
+#     plugin `agents/<名>.md`        ↔ 專案 `.claude/agents/<名>.md`
+#
+#   實況：這 9 個檔案在 ISEP `0.1.0`（c263866）從 InkStoneCo 複製過來**一次**，
+#   之後再也沒有同步過。到 2026-09-02 已經分家兩個，而且**方向相反**：
+#     `skills/ship-check/SKILL.md`   InkStoneCo 651 行 ／ ISEP 595 行
+#     `commands/sdd-check.md`        ISEP 81 行 ／ InkStoneCo 65 行
+#                                    （InkStoneCo 那份還在教 ISEP#91 已退役的「唯一 active SDD」）
+#   ⇒ 「ISEP 一定比較新」與「InkStoneCo 一定比較新」**兩句都是錯的**。
+#     兩份都會被就地編輯 ⇒ 歸屬只能寫下來（`docs/file-ownership.tsv`）並且要有東西去比。
+#
+# 🔴 這一格比 ② 嚴重：腳本要有人叫它才會跑，**skill／command 是自動載入的**——
+#   載到舊的那份不會報錯、不會變慢、不會有任何症狀，只會安靜地教錯的東西。
+#   （ship-check 就是這樣：舊描述在「我要發一篇部落格文章」時根本不會被觸發。）
+#
+# 判準與 ② 同一條：**檔名一樣而內容不同**才出聲，同步過的不吵。
+LOADABLE_PAIRS = [("skills", ".claude/skills", True),
+                  ("commands", ".claude/commands", False),
+                  ("agents", ".claude/agents", False)]
+
+
+def ownership():
+    """讀 docs/file-ownership.tsv → {plugin 內路徑: (真相源, 真相源路徑, commit, sha256)}"""
+    out = {}
+    try:
+        with open(os.path.join(ROOT, "docs", "file-ownership.tsv"), encoding="utf-8") as f:
+            for line in f:
+                if not line.strip() or line.lstrip().startswith("#"):
+                    continue
+                c = line.rstrip("\n").split("\t")
+                if len(c) >= 2 and c[0].strip():
+                    out[c[0].strip()] = tuple((c[1:5] + ["-", "-", "-", "-"])[:4])
+    except Exception:
+        pass
+    return out
+
+
+OWN = ownership()
+
+
+def loadable_pairs():
+    """產生 (plugin 內相對路徑, 專案內相對路徑)——只列 plugin 真的有的那些"""
+    for pdir, jdir, nested in LOADABLE_PAIRS:
+        src = os.path.join(ROOT, pdir)
+        if not os.path.isdir(src):
+            continue
+        try:
+            names = sorted(os.listdir(src))
+        except Exception:
+            continue
+        for name in names:
+            if nested:
+                if os.path.isfile(os.path.join(src, name, "SKILL.md")):
+                    yield "%s/%s/SKILL.md" % (pdir, name), "%s/%s/SKILL.md" % (jdir, name)
+            elif name.endswith(".md") and os.path.isfile(os.path.join(src, name)):
+                yield "%s/%s" % (pdir, name), "%s/%s" % (jdir, name)
+
+
+def whose(rel):
+    """真相源是誰 → 一句照著做就會走到的話。表上沒有就誠實說未定，不要猜。"""
+    row = OWN.get(rel)
+    if not row:
+        return "歸屬未定 ⇒ 兩份都看一眼，決定之後補一列進 docs/file-ownership.tsv"
+    src, spath, _commit, _sha = row
+    if src == "inkstone/ISEP":
+        return "真相源＝ISEP 這一份 ⇒ 專案那份是舊複本，同步過去或刪掉它"
+    return ("真相源＝%s:%s ⇒ 內容改在那裡，改完原樣搬進 ISEP、"
+            "更新 docs/file-ownership.tsv 的 commit／sha256、升版" % (src, spath or "?"))
+
+
+def shadow_loadables():
+    out = []
+    roots = [PROJ, os.path.join(PROJ, "InkStoneCo")]
+    for prel, jrel in loadable_pairs():
+        a = os.path.join(ROOT, prel)
+        try:
+            ab = open(a, "rb").read()
+        except Exception:
+            continue
+        for base in roots:
+            b = os.path.join(base, jrel)
+            try:
+                if os.path.realpath(b) == os.path.realpath(a) or not os.path.isfile(b):
+                    continue
+                if open(b, "rb").read() != ab:
+                    out.append("%s ↔ %s（%s）"
+                               % (prel, os.path.relpath(b, PROJ), whose(prel)))
+            except Exception:
+                pass
+    return out
+
+
+ld = shadow_loadables()
+if ld:
+    notes.append(
+        "🟡 **會自動載入的東西兩邊各有一份，而且內容不同**：\n  - %s\n"
+        "  自動載入的東西載到舊的那份**不會有任何症狀**——不報錯、不變慢，"
+        "只會安靜地教錯的東西（`ship-check` 的舊描述在「我要發一篇部落格文章」時"
+        "根本不會被觸發）。歸屬表：docs/file-ownership.tsv（inkstone/ISEP#122）。"
+        % "\n  - ".join(ld))
+
+# ══ ②c ISEP 自己這一份，跟歸屬表記的那顆對不對得上 ══════════════════════
+#
+# 🔴 為什麼要有這一格：②b 要「專案那一份」在磁碟上才比得出來，
+#   而**雲端的 project dir 是薄殼，根本沒有那一份**（ISEP#90 記過同一件事）。
+#   這一格只比「檔案 vs 表上寫的 sha256」——離線、單邊、不依賴任何別的 repo，
+#   是雲端唯一還作數的那個檢查。
+def off_manifest():
+    out = []
+    for rel, (src, spath, commit, sha) in OWN.items():
+        if not sha or sha == "-":
+            continue
+        p = os.path.join(ROOT, rel)
+        if not os.path.isfile(p):
+            continue
+        try:
+            h = hashlib.sha256(open(p, "rb").read()).hexdigest()
+        except Exception:
+            continue
+        if h != sha:
+            out.append("%s（表記 %s 的 %s…，實際 %s…；真相源 %s:%s）"
+                       % (rel, (commit or "?")[:7], sha[:12], h[:12], src, spath or "?"))
+    return out
+
+
+om = off_manifest()
+if om:
+    notes.append(
+        "🟡 **ISEP 這一份跟歸屬表對不上**：%s。兩種可能，兩種都要動手："
+        "① 它被就地改過 ⇒ 內容要改在真相源那邊，這裡只放原樣搬過來的複本；"
+        "② 它是同步過的新內容、只是沒更新 docs/file-ownership.tsv 的 commit／sha256 ⇒ 補上那兩欄。"
+        % "、".join(om))
+
 # ══ ③ 工作區有沒有「已退役機制」留下的產物 ══════════════════════════════
 #
 # 判準是機械的、而且會自己長大：**plugin 自己的原始碼裡有沒有任何一個字提到這個目錄**。

hooks/tests/history-first-guard.test.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+# history-first-guard.sh 的迴歸測試 —— 重點在**逃生門真的走得通**（inkstone/ISEP#122）
+#
+# ── 這支在守什麼 ────────────────────────────────────────────────────
+# 2026-09-02 實撞：KBDB 兩支工具都回 `Connection closed`，照這支閘印出來的那行
+#   `touch /tmp/.kbdb-down`
+# 打完再送同一個編輯，**被一模一樣地擋第二次**——因為 `touch` 造的是空檔，
+# 而舊版是 `cat` 檔案內容當時戳，空字串被當成 0 ⇒ 「距今 17 億秒」⇒ 永遠不新鮮。
+#
+# 🔴 一道閘印出來的出路走不通，比沒有出路更糟：人照做了、還是被擋，
+#    下一步就是去繞過這道閘（本 repo 的 ticket-api-bypass-guard.sh 檔頭記過同一課）。
+#    所以這支測試的第一等公民是**逃生門那一條**，不是「擋不擋得住」。
+#
+# 🔴 **這支測試自己怎麼被證明有鑑別力**（不要只看它全綠）：
+#    把修好之前那一版拿來跑，第 ④ 條要紅。因為舊版沒有 KBDB_STAMP_DIR，
+#    直接餵它會去讀這台機器真正的 /tmp 戳記而「剛好過關」，所以要先把路徑隔離：
+#      git show <修好前的 commit>:hooks/history-first-guard.sh > /tmp/old.sh
+#      sed 's#/tmp/\.kbdb-asked#${KBDB_STAMP_DIR:-/tmp}/.kbdb-asked#;
+#           s#/tmp/\.kbdb-down#${KBDB_STAMP_DIR:-/tmp}/.kbdb-down#' /tmp/old.sh > /tmp/old-iso.sh
+#      bash hooks/tests/history-first-guard.test.sh /tmp/old-iso.sh
+#    2026-09-02 實跑：舊版 9/10（④ 紅），修好後 10/10。
+#    ⚠️ 第 ③ 條**兩版都是綠的**——它只驗離開碼 2，而過了第 0 道之後歷史警察照樣會擋。
+#      真正分辨得出來的是 ④「擋人的是誰」。這一格是本支最容易寫成假綠的地方。
+#
+# 🔴 全程用 KBDB_STAMP_DIR 指到 TMP，**不碰這台機器真正的 /tmp/.kbdb-* 戳記**
+#    （把別的 session 的戳記清掉＝把閘弄成隨機的）。不打網路。
+set -u
+HOOK="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/history-first-guard.sh}"
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+export KBDB_STAMP_DIR="$TMP/stamps"; mkdir -p "$KBDB_STAMP_DIR"
+
+PASS=0; FAIL=0; N=0
+
+# 造一個「有前科」的 code 檔：放在一個有 git 歷史的假 repo 裡
+REPO="$TMP/repo"; mkdir -p "$REPO"
+( cd "$REPO" && git init -q && git config user.email t@t && git config user.name t \
+  && printf 'echo old\n' > victim.sh && git add . && git commit -qm "第一版" ) >/dev/null 2>&1
+VICTIM="$REPO/victim.sh"
+
+# run <檔案> → 印出離開碼（送一份 Edit 的 payload 進去）
+run() {
+  printf '{"tool_input":{"file_path":"%s"}}' "$1" \
+    | CLAUDE_PROJECT_DIR="$REPO" bash "$HOOK" >/dev/null 2>"$TMP/err"
+  printf '%s' "$?"
+}
+
+check() { # check <說明> <實際> <期望>
+  N=$((N+1))
+  if [ "$2" = "$3" ]; then printf '  ✅ %s\n' "$1"; PASS=$((PASS+1))
+  else printf '  ❌ %s —— 期望離開碼 %s，實際 %s\n' "$1" "$3" "$2"; sed 's/^/     /' "$TMP/err" | head -6; FAIL=$((FAIL+1)); fi
+}
+
+clean_stamps() { rm -f "$KBDB_STAMP_DIR/.kbdb-asked" "$KBDB_STAMP_DIR/.kbdb-down"; rm -f /tmp/.history-guard-*; }
+
+echo "── 第 0 道：問過 KBDB 了沒 ──────────────────────────────────"
+clean_stamps
+check "① 沒有任何戳記 → 擋" "$(run "$VICTIM")" 2
+grep -q "KBDB" "$TMP/err" && printf '  ✅ ② 擋下時訊息講得出是哪一道\n' && PASS=$((PASS+1)) || { printf '  ❌ ② 訊息沒提到 KBDB\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
+
+echo "── 🔴 逃生門：照訊息打那一行，就要真的過得去 ──────────────────"
+clean_stamps
+touch "$KBDB_STAMP_DIR/.kbdb-down"          # ← 訊息裡原文那一行做的事
+check "③ touch 出來的空檔（本票的實撞）→ 要放行過第 0 道" "$(run "$VICTIM")" 2
+#    ↑ 期望仍是 2：過了第 0 道之後會被「歷史警察」擋（這個檔真的有前科），
+#      所以要看訊息換人了沒——這是這支測試最容易寫錯的一格。
+grep -q "歷史警察" "$TMP/err" && printf '  ✅ ④ 擋人的換成歷史警察 ⇒ 第 0 道確實被逃生門放過了\n' && PASS=$((PASS+1)) || { printf '  ❌ ④ 還是卡在 KBDB 那一道 ⇒ 逃生門是假的\n'; sed 's/^/     /' "$TMP/err" | head -4; FAIL=$((FAIL+1)); }; N=$((N+1))
+
+clean_stamps
+date +%s > "$KBDB_STAMP_DIR/.kbdb-down"     # 舊格式（檔案內容是時戳）
+run "$VICTIM" >/dev/null
+grep -q "歷史警察" "$TMP/err" && printf '  ✅ ⑤ 舊格式（內容寫時戳）照樣認得 ⇒ 沒有把既有的弄壞\n' && PASS=$((PASS+1)) || { printf '  ❌ ⑤ 舊格式壞了\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
+
+clean_stamps
+date +%s > "$KBDB_STAMP_DIR/.kbdb-asked"
+run "$VICTIM" >/dev/null
+grep -q "歷史警察" "$TMP/err" && printf '  ✅ ⑥ 真的問過 KBDB（kbdb-asked-stamp.sh 寫的戳記）→ 過第 0 道\n' && PASS=$((PASS+1)) || { printf '  ❌ ⑥ 問過了還被擋\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
+
+echo "── 過期的戳記不算數（逃生門不能變成永久後門）──────────────────"
+clean_stamps
+touch -t "$(date -v-2H '+%Y%m%d%H%M' 2>/dev/null || date -d '2 hours ago' '+%Y%m%d%H%M')" "$KBDB_STAMP_DIR/.kbdb-down"
+run "$VICTIM" >/dev/null
+grep -q "KBDB" "$TMP/err" && printf '  ✅ ⑦ 兩小時前的空戳記 → 過期，回到擋\n' && PASS=$((PASS+1)) || { printf '  ❌ ⑦ 過期的戳記還在放行 ⇒ 一次 touch 就永久免疫\n'; FAIL=$((FAIL+1)); }; N=$((N+1))
+
+echo "── 不該擋的（誤攔比漏擋嚴重）────────────────────────────────"
+clean_stamps
+printf '# doc\n' > "$REPO/readme.md"
+check "⑧ 文件檔（.md）→ 一路放行，連第 0 道都不該碰" "$(run "$REPO/readme.md")" 0
+clean_stamps
+check "⑨ 不存在的新檔 → 放行" "$(run "$REPO/brand-new.sh")" 0
+clean_stamps
+mkdir -p "$REPO/tests"; printf 'echo t\n' > "$REPO/tests/a.sh"
+check "⑩ 測試檔 → 放行" "$(run "$REPO/tests/a.sh")" 0
+
+echo
+printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
+[ "$FAIL" = 0 ] || exit 1

hooks/tests/hook-sandbox.test.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+# hooks/tests/lib/hook-sandbox.sh 的迴歸測試（inkstone/ISEP#122）
+#
+# 🔴 為什麼有這支（2026-09-02 實撞，證據在票上）：
+#   `hook_sandbox` 的第一個參數是「那支 hook 的檔案路徑」，傳錯時舊版不檢查就
+#   `cp -R "$(dirname "$1")"` ⇒ 複製的是上一層。傳 repo 根目錄進去，
+#   複製的就是**整個 tech_projects**：兩次吃掉 23 GB，磁碟剩 462 MB，
+#   而它只印一句「沙盒建不起來」——**沒說參數錯，也沒說它已經把磁碟寫滿**。
+#
+#   所以這支測的不是「錯誤訊息好不好看」，是**收手的時機**：
+#   ④⑤ 兩條驗「複製之前就 return 1」——暫存區裡不准留下任何東西。
+#
+# 用法：bash hooks/tests/hook-sandbox.test.sh
+set -u
+HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+ROOT=$(CDPATH= cd -- "$HERE/.." && pwd)          # …/hooks
+REPO=$(CDPATH= cd -- "$ROOT/.." && pwd)
+PASS=0; FAIL=0
+ok(){ printf '  ✅ %s\n' "$1"; PASS=$((PASS+1)); }
+no(){ printf '  ❌ %s —— %s\n' "$1" "$2"; FAIL=$((FAIL+1)); }
+
+# 每一條都在自己的子殼裡跑：hook_sandbox 會設全域變數，不隔離會互相污染。
+run(){ # run <參數>  → 印 "rc|沙盒路徑|訊息"
+  ( . "$HERE/lib/hook-sandbox.sh"
+    msg=$(hook_sandbox "$1" 2>&1); rc=$?
+    printf '%s|%s|%s' "$rc" "${HOOK_SANDBOX:-}" "$(printf '%s' "$msg" | tr '\n' ' ')"
+  )
+}
+
+echo "── 該收手（傳錯參數）──────────────────────────────────────"
+
+r=$(run "$REPO"); rc=${r%%|*}; rest=${r#*|}; sb=${rest%%|*}; msg=${rest#*|}
+[ "$rc" = "1" ] && ok "① 傳 repo 根目錄（本票的實撞）→ return 1" \
+                || no "① 傳 repo 根目錄（本票的實撞）→ return 1" "實得 rc=$rc"
+case "$msg" in *"hooks/main-and-prod-push-guard.sh"*)
+  ok "② 訊息給得出一行**真的跑得起來**的用法" ;;
+  *) no "② 訊息給得出一行**真的跑得起來**的用法" "訊息：$msg" ;;
+esac
+if [ -z "$sb" ] || [ ! -d "$sb" ]; then ok "③ 收手在 mktemp 之前，暫存區沒有殘骸"
+else no "③ 收手在 mktemp 之前，暫存區沒有殘骸" "留下了 $sb"; fi
+
+r=$(run ""); [ "${r%%|*}" = "1" ] && ok "④ 空參數 → return 1（不是拿空字串去 dirname）" \
+                                  || no "④ 空參數 → return 1" "實得 rc=${r%%|*}"
+
+r=$(run "$REPO/scripts/ticket"); rc=${r%%|*}; rest=${r#*|}; sb=${rest%%|*}
+if [ "$rc" = "1" ]; then ok "⑤ 檔案存在但上一層不是 hooks/ → 一樣收手"
+else no "⑤ 檔案存在但上一層不是 hooks/ → 一樣收手" "實得 rc=$rc"; fi
+if [ -z "$sb" ] || [ ! -d "$sb" ]; then ok "⑥ ⑤ 這條也沒把 scripts/ 複製出去"
+else no "⑥ ⑤ 這條也沒把 scripts/ 複製出去" "留下了 $sb"; fi
+
+r=$(run "$ROOT/沒有這支.sh"); [ "${r%%|*}" = "1" ] && ok "⑦ 路徑不存在 → return 1" \
+                                                   || no "⑦ 路徑不存在 → return 1" "實得 rc=${r%%|*}"
+
+echo "── 不准把本來會過的弄壞（誤攔比漏擋嚴重）────────────────────"
+( . "$HERE/lib/hook-sandbox.sh"
+  hook_sandbox "$ROOT/main-and-prod-push-guard.sh"; rc=$?
+  if [ "$rc" != "0" ]; then echo "RC=$rc"; exit 0; fi
+  [ -f "$HOOK_SANDBOX_HOOK" ] && echo "HOOKOK"
+  [ -d "$HOOK_SANDBOX/hooks/lib" ] && echo "LIBOK"
+  # 只複製 hooks/，不該把 repo 的其他目錄帶進來
+  [ -d "$HOOK_SANDBOX/hooks/scripts" ] && echo "LEAK"
+  hook_sandbox_cleanup
+) > /tmp/.hs-ok.$$ 2>&1
+grep -q HOOKOK /tmp/.hs-ok.$$ && ok "⑧ 正常用法照樣建得起來，複本裡有那支 hook" \
+                              || no "⑧ 正常用法照樣建得起來" "$(cat /tmp/.hs-ok.$$)"
+grep -q LIBOK  /tmp/.hs-ok.$$ && ok "⑨ 整個 hooks/（含 lib/）都在複本裡" \
+                              || no "⑨ 整個 hooks/（含 lib/）都在複本裡" "$(cat /tmp/.hs-ok.$$)"
+grep -q LEAK   /tmp/.hs-ok.$$ && no "⑩ 只複製 hooks/，沒有把 repo 其他目錄帶進去" "複本裡出現 scripts/" \
+                              || ok "⑩ 只複製 hooks/，沒有把 repo 其他目錄帶進去"
+rm -f /tmp/.hs-ok.$$
+
+echo
+echo "通過 $PASS 條，失敗 $FAIL 條（共 $((PASS+FAIL)) 條）"
+[ "$FAIL" -eq 0 ]

hooks/tests/isep-presence-beacon.test.sh

@@ -25,9 +25,21 @@ mkplugin() {
   cp "$HOOK" "$d/hooks/$(basename "$HOOK")"
   cp "$REAL_HOOKS/lib/beacon_report.py" "$d/hooks/lib/beacon_report.py"
   printf '#!/bin/sh\necho real\n' > "$d/scripts/ticket"
+  # inkstone/ISEP#122：會自動載入的東西（skill／command／agent）也要造得出來
+  mkdir -p "$d/skills/demo" "$d/commands" "$d/agents" "$d/docs"
+  printf 'PLUGIN 版的 skill\n' > "$d/skills/demo/SKILL.md"
+  printf 'PLUGIN 版的 command\n' > "$d/commands/demo.md"
+  printf 'PLUGIN 版的 agent\n' > "$d/agents/demo.md"
   printf '%s\n' "$d"
 }
 
+# mkown <plugin root> <列...> → 寫一份 docs/file-ownership.tsv（欄位用真正的 TAB）
+mkown() {
+  d="$1"; shift; mkdir -p "$d/docs"
+  { printf '# 測試用\n'; for row in "$@"; do printf '%s\n' "$row"; done; } \
+    | sed 's/|/\t/g' > "$d/docs/file-ownership.tsv"
+}
+
 # run <plugin root> <project dir> → 印出 systemMessage（JSON 壞掉就印 __BADJSON__）
 run() {
   CLAUDE_PLUGIN_ROOT="$1" CLAUDE_PROJECT_DIR="$2" bash "$1/hooks/$(basename "$HOOK")" 2>/dev/null \
@@ -112,6 +124,72 @@ printf '#!/bin/sh\necho "OLD"\n' > "$J6/scripts/ticket"
 out=$(run "$P" "$J6")
 check "⑭ 報告內容含引號 → JSON 仍然合法" "$out" "🟢 ISEP" "!__BADJSON__"
 
+P2=$(mkplugin 1.0.0)   # ⑫⑬ 會刪掉 $P 的 report，這一組要自己一份
+echo "── ②b 會自動載入的東西也有分身（inkstone/ISEP#122）──────────────"
+# 🔴 這一組守的是 ship-check 那件：plugin 帶著舊描述，而舊描述在「我要發部落格文章」
+#    的情境根本不會被觸發 ⇒ 那個 session 永遠載不到出貨流程，而且不會有任何症狀。
+JS="$TMP/proj-skill"; mkdir -p "$JS/.claude/skills/demo"
+printf '專案版的 skill（比較舊）\n' > "$JS/.claude/skills/demo/SKILL.md"
+out=$(run "$P2" "$JS")
+check "⑮ 專案有同名 skill 而內容不同 → 要點名" "$out" \
+  "會自動載入的東西兩邊各有一份" "skills/demo/SKILL.md" ".claude/skills/demo/SKILL.md"
+check "⑯ 歸屬表沒登記 → 誠實說未定，不要替人猜方向" "$out" "歸屬未定"
+
+JS2="$TMP/proj-skill-same"; mkdir -p "$JS2/.claude/skills/demo"
+cp "$P2/skills/demo/SKILL.md" "$JS2/.claude/skills/demo/SKILL.md"
+out=$(run "$P2" "$JS2")
+check "⑰ 內容一模一樣 → 不吵（誤攔比漏擋嚴重）" "$out" "!會自動載入的東西兩邊各有一份"
+
+JC="$TMP/proj-cmd"; mkdir -p "$JC/.claude/commands"
+printf '專案版的 command（比較舊）\n' > "$JC/.claude/commands/demo.md"
+out=$(run "$P2" "$JC")
+check "⑱ command 也要掃（sdd-check 那件）" "$out" "commands/demo.md" ".claude/commands/demo.md"
+
+JA="$TMP/proj-agent"; mkdir -p "$JA/.claude/agents"
+printf '專案版的 agent（比較舊）\n' > "$JA/.claude/agents/demo.md"
+out=$(run "$P2" "$JA")
+check "⑲ agent 也要掃" "$out" "agents/demo.md" ".claude/agents/demo.md"
+
+JCL="$TMP/proj-cloud"; mkdir -p "$JCL/InkStoneCo/.claude/skills/demo"
+printf '專案版的 skill（比較舊）\n' > "$JCL/InkStoneCo/.claude/skills/demo/SKILL.md"
+out=$(run "$P2" "$JCL")
+check "⑳ 雲端排法：真身在 \$TOP/InkStoneCo/ 底下也要抓到" "$out" \
+  "InkStoneCo/.claude/skills/demo/SKILL.md"
+
+echo "── 歸屬表要講得出「往哪個方向修」──────────────────────────────"
+PO=$(mkplugin 1.0.1)
+mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-"
+out=$(run "$PO" "$JS")
+check "㉑ 真相源＝InkStoneCo → 說「內容改在那裡」並給得出路徑" "$out" \
+  "真相源＝inkstone/InkStoneCo:.claude/skills/demo/SKILL.md" "內容改在那裡" "!歸屬未定"
+
+mkown "$PO" "skills/demo/SKILL.md|inkstone/ISEP|-|-|-"
+out=$(run "$PO" "$JS")
+check "㉒ 真相源＝ISEP → 說「專案那份是舊複本」" "$out" \
+  "真相源＝ISEP 這一份" "舊複本" "!歸屬未定"
+
+echo "── ②c 沒有專案那一份也要驗得出來（雲端唯一作數的檢查）────────────"
+# 雲端的 project dir 是薄殼，沒有 InkStoneCo 可以比 ⇒ 只剩「檔案 vs 表上的 sha256」
+SHA=$(shasum -a 256 "$PO/skills/demo/SKILL.md" | cut -d" " -f1)
+mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|$SHA"
+out=$(run "$PO" "$J")
+check "㉓ sha256 對得上（而且專案那份不存在）→ 一個字都不說" "$out" \
+  "🟢 ISEP v1.0.1 已載入" "!跟歸屬表對不上" "!會自動載入的東西兩邊各有一份"
+
+printf '被就地改過\n' >> "$PO/skills/demo/SKILL.md"
+out=$(run "$PO" "$J")
+check "㉔ 檔案被就地改過 → 就算沒有專案那份，也要抓得到" "$out" \
+  "跟歸屬表對不上" "skills/demo/SKILL.md" "abc1234"
+
+mkown "$PO" "skills/demo/SKILL.md|inkstone/InkStoneCo|.claude/skills/demo/SKILL.md|abc1234|-"
+out=$(run "$PO" "$J")
+check "㉕ 表上 sha 欄是 \`-\` → 這一格閉嘴（還沒登記不是錯）" "$out" "!跟歸屬表對不上"
+
+echo "── 加了這兩格也不准讓信標消失 ────────────────────────────────"
+out=$(run "$P2" "$JS")
+check "㉖ ②b 有報告時，那行綠色信標仍在且 JSON 合法" "$out" \
+  "🟢 ISEP v1.0.0 已載入" "!__BADJSON__"
+
 echo
 printf '通過 %s 條，失敗 %s 條（共 %s 條）\n' "$PASS" "$FAIL" "$N"
 [ "$FAIL" = 0 ] || exit 1

hooks/tests/lib/hook-sandbox.sh

@@ -39,9 +39,38 @@
 #   ⇒ hostsum 兩次都回 `NODIR`（相等）、沙盒的請求數當然是 0
 #   ⇒ **第一條斷言變成「拿空的比空的」的假綠**。
 #   所以改成「設變數、不印」，而且 hook_sandbox_assert 開頭會擋空值（見下）。
+#
+# 🔴 **先驗參數再複製**（inkstone/ISEP#122，2026-09-02 實撞，本檔第二次修）：
+#   `$1` 是「那支 hook 的路徑」。傳錯（例如順手傳了 repo 根目錄）時，舊版不檢查就
+#   `cp -R "$(dirname "$1")" …` ⇒ **複製的是那個目錄的上一層**。
+#   當天實測：`bash hooks/tests/main-and-prod-push-guard.test.sh "$PWD"`
+#     ⇒ dirname 變成 ~/Documents/tech_projects
+#     ⇒ 把 **整個 tech_projects**（所有 repo、所有 worktree）複製進 mktemp
+#     ⇒ 兩次就吃掉 23 GB，磁碟從 25 GB 剩到 462 MB，`cp` 一路吐
+#        `No space left on device`，最後才印一句「❌ 沙盒建不起來」。
+#   ⇒ 訊息只說「建不起來」，**沒說是參數傳錯，也沒說它已經把磁碟寫滿了**。
+#   判準用「要求某個東西在場」，不是關鍵字比對：
+#     ① `$1` 要指到一個**真的檔案**（傳目錄、傳空字串都不算）
+#     ② 它的上一層目錄名要叫 `hooks`（沙盒的前提就是「複製一整個 hooks/」）
+#   兩條任一不成立就**在複製之前**收手，並印出走得通的那一行。
 hook_sandbox() {
   _hs_real=$1
+  if [ -z "${_hs_real:-}" ] || [ ! -f "$_hs_real" ]; then
+    printf '❌ hook_sandbox：第一個參數要是「那支 hook 的檔案路徑」，實得 %s\n' \
+      "${_hs_real:-（空的）}" >&2
+    printf '   例：bash hooks/tests/main-and-prod-push-guard.test.sh hooks/main-and-prod-push-guard.sh\n' >&2
+    printf '   （不必自己傳的版本：bash scripts/test-main-and-prod-push-guard.sh）\n' >&2
+    return 1
+  fi
   _hs_hooks=$(CDPATH= cd -- "$(dirname -- "$_hs_real")" && pwd) || return 1
+  if [ "$(basename "$_hs_hooks")" != "hooks" ]; then
+    printf '❌ hook_sandbox：%s 的上一層不是 hooks/，而沙盒要複製的就是那個目錄。\n' \
+      "$_hs_real" >&2
+    printf '   算出來的來源是 %s——照複製下去會把它整個搬進暫存區（2026-09-02 這樣寫滿過磁碟）。\n' \
+      "$_hs_hooks" >&2
+    printf '   例：bash hooks/tests/main-and-prod-push-guard.test.sh hooks/main-and-prod-push-guard.sh\n' >&2
+    return 1
+  fi
   HOOK_SANDBOX=$(mktemp -d) || return 1
   cp -R "$_hs_hooks" "$HOOK_SANDBOX/hooks" || return 1
   HOOK_SANDBOX_HOST="${_hs_hooks%/hooks}/pending-main-push"

hooks/tests/sdd-guard-retired.test.sh

@@ -76,7 +76,11 @@ printf -- '---\nstatus: active\n---\n# A\n' > "$REPO_MULTI/system-dev/docs/3-spe
 printf -- '---\nstatus: active\n---\n# B\n' > "$REPO_MULTI/system-dev/docs/3-specs/b/design.md"
 
 # 撈出所有掛在 Write|Edit|MultiEdit 上的 PreToolUse 閘（照 hooks.json 的實況，不寫死清單）
-mapfile -t WRITE_HOOKS < <(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
+# macOS 內建 bash 是 3.2，沒有 mapfile/readarray——用相容寫法收陣列
+# （同 scripts/gitea-labels-sync.sh:56 的前例；2026-09-01 inkstone/ISEP#115 實撞：
+#  這支測試在 leo 的 mac 上一次都沒跑成功過，離開碼 1，而 TESTING.md 標著「通過 8」）
+WRITE_HOOKS=()
+while IFS= read -r _l; do WRITE_HOOKS+=("$_l"); done < <(python3 - "$HOOKS_DIR/hooks.json" <<'PY'
 import json, sys
 d = json.load(open(sys.argv[1]))
 for g in d["hooks"].get("PreToolUse", []):
@@ -87,7 +91,7 @@ for g in d["hooks"].get("PreToolUse", []):
 PY
 )
 
-if [ "${#WRITE_HOOKS[@]}" -eq 0 ]; then
+if [ "${#WRITE_HOOKS[@]:-0}" -eq 0 ]; then
   bad "撈不到任何 Write|Edit 的 PreToolUse 閘——測試本身失效了，先修這裡"
 fi
 

scripts/make-cloud-env.sh

@@ -10,9 +10,63 @@
 set -euo pipefail
 
 # ── 雲端需要哪些變數（只有名字。要加就加在這裡）──────────────────
+#
+# 範圍＝**youlin（stage）與 geek6688（測試 prod ＆ 出貨機）兩台全給**，
+#       **外加 uncle6**——出貨的三個站實際部署到的是那個帳號。
+# leo 2026-09-01：「youlin 和 geek6688 都全給，因為這兩個都是讓 CC 操作
+#   一個 stage 一個 test prod，**不給所有的就是受阻**。」
+# uncle6 是同一句話的延伸（inkstone/ISEP#115 → comment `5577`）：
+#   `products/arcrun-rag/installer/ship.targets.json` 六處 accountId 去重後只有一個值
+#   `58309bb90fd93ad6d0fe0aae99170e9d`，而本機出貨靠的是家目錄裡的 OAuth 登入態
+#   （`~/.wrangler/config/default.toml`）——**那個檔不隨 repo clone 走，雲端永遠拿不到**。
+#   ⚠️ 這把「是 uncle6 的、而且 active」是驗過的；「它有沒有 Workers Scripts:Edit
+#      ＝真的部署得動」**沒驗**（驗它必須寫入，那是紅線）。缺這格會在部署當下才知道。
 NEEDED=(
-  GITEA_TOKEN_CLAUDE_CODE      # 機器帳號 claude-code 的 Gitea token；bootstrap 與 plugin 安裝都靠它
+  # ── 機器帳號 ──
+  GITEA_TOKEN_CLAUDE_CODE                # claude-code 的 Gitea token；bootstrap 與 plugin 安裝都靠它
+
+  # ── youlin ＝ AI 的 stage（沒指定帳號時的預設，agent-memory.md §2）──
+  CLOUDFLARE_API_TOKEN_YOULIN_CC_USE     # D37 起這把就是設計給 CC 用的
+  CLOUDFLARE_ACCOUNT_ID_YOULIN           # 上面那把的配對 account id（帳號 id 不是機密）
+  YOULIN_MCP_OWNER_SECRETS               # youlin 那台 MCP 的 owner secret
+  STAGE_USERNAME_YOULIN                  # ⚠️ 密碼類，見下面那條限制
+  STAGE_PASSWORD_YOULIN                  # ⚠️ 密碼類，見下面那條限制
+
+  # ── geek6688 ＝ 測試 prod ＆ 出貨機 ──
+  CLOUDFLARE_API_TOKEN_CC_SHIPPING_CORE  # 出貨線寫入用
+  CLOUDFLARE_ACCOUNT_ID_GEEK6688         # 上面那把的配對 account id
+
+  # ── uncle6 ＝ 出貨三站真正部署到的帳號（installer／docsSite／mailRelay，stage 與 prod 都是）──
+  UNCLE6_CF_API_KEY                      # 住在 products/arcrun-rag/.env；本機是靠 ~/.wrangler 的 OAuth 登入態出貨，那個檔不隨 clone 走
+
+  # ── Arcrun 出貨線的實例座標（inkstone/Arcrun#195 起）──
+  #    網址隨 repo 走（Arcrun 的 shared/instance-coordinates/instances.json），
+  #    只有 namespace 是機敏 ⇒ 走環境變數。原本只住在 ~/.arcrun/config.yaml 的 api_key，
+  #    那個檔在家目錄、不隨 clone 走 ⇒ 雲端永遠拿不到。
+  ARCRUN_NS_YOULIN                       # youlin 實例的 namespace（X-Arcrun-API-Key）
 )
+#
+# 🔴 這份清單的邊界——加一把之前先問「這把打得到哪個實例」，不是「這把方便嗎」
+#
+#    可以進來的：**youlin 與 geek6688** 這兩台的全部，加上機器帳號自己的 token。
+#    🔴 不准進來的：
+#      ① `CLOUDFLARE_API_TOKEN_leo21c`——leo 2026-09-01 只點名那兩台；
+#         leo21c 是現役正式環境，`inkstone/InkStoneCo#14` → comment `3890` 已分進 B 段不放。
+#      ② `polaris/mira/.env` 裡的任何東西——那整份都是 leo21c 現役正式環境。
+#         其中 `CLOUDFLARE_API_TOKEN` / `CLOUDFLARE_ACCOUNT_ID` 這兩個**沒有名字**的最危險：
+#         所有 CF 工具都把它們當預設 ⇒ 雲端一個沒指定帳號的指令就會打到正式環境。
+#         2026-08-14 那輪審查把它列為「本輪最危險的發現」。
+#      🔎 這一條不必靠人記得：`scripts/test-make-cloud-env.sh` 的 B8 會去看
+#         **每一把的值是從哪個檔案拿到的**，出自 `polaris/mira/.env` 就紅。
+#
+# 🔴 密碼類（`STAGE_PASSWORD_YOULIN` 等）進清單是為了讓**人**拿得到。
+#    `credentials-map.md`「密碼類憑證的用法限制」（2026-08-17 立）照舊有效：
+#    **AI 不得把密碼打進登入欄位**，這是 surface 層硬規則，leo 交代了也不解除。
+#    機器要驗登入後的畫面走那節寫的兩條：帶 token/cookie 打 API，或接 leo 已登入的分頁。
+#
+# 📌 兩台的 account id 都有具名變數了（`…_YOULIN` 是 2026-09-01 才補進頂層 `.env` 的，
+#    inkstone/ISEP#115 → comment `5542`；帳號 id 不是機密，wiki 的帳號表本來就公開記著）。
+#    **所以永遠不需要去用那個沒有名字的 `CLOUDFLARE_ACCOUNT_ID`**——那是 leo21c。
 
 # ── 去哪裡找值（credentials-map.md 記的六個 .env）────────────────
 BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"

scripts/test-comment-carries-task-guard.sh

@@ -64,6 +64,158 @@ printf '已驗完，全部綠燈\n' > "$TMPF"
 run 0 "scripts/ticket say inkstone/arcrun-rag#136 -F $TMPF"
 rm -f "$TMPF" "/tmp/.comment-task-guard-warned-$SID"
 
+echo "── 閘教的那行指令要真的跑得動（inkstone/ISEP#112）──"
+# 🔴 這一組**不看離開碼**，看訊息內容、而且**真的把訊息裡那塊指令執行一次**。
+#    ISEP wiki mistakes.md 記過：訊息壞掉時閘照樣 exit 2，只驗離開碼完全看不出來。
+#    這張票就是那個形狀的極端版——閘擋對了，但它教的解法**根本不存在**。
+SID2=test-cctg-msg-$$
+rm -f "/tmp/.comment-task-guard-warned-$SID2"
+PAYLOAD=$(python3 -c '
+import json, sys
+cmd = ("curl -X POST \"$API/repos/inkstone/arcrun-rag/issues/136/comments\" "
+       "-d \x27{\"body\":\"Phase 1 的驗收在雲端那半出貨之前驗不了\"}\x27")
+print(json.dumps({"session_id": sys.argv[1], "tool_name": "Bash",
+                  "tool_input": {"command": cmd}}, ensure_ascii=False))
+' "$SID2")
+MSGFILE=$(mktemp)
+printf '%s' "$PAYLOAD" | bash "$H" 2>"$MSGFILE" >/dev/null
+rm -f "/tmp/.comment-task-guard-warned-$SID2"
+
+RESFILE=$(mktemp)
+PAYFILE=$(mktemp); printf '%s' "$PAYLOAD" > "$PAYFILE"
+rm -f "/tmp/.comment-task-guard-warned-$SID2"
+MSGFILE="$MSGFILE" RESFILE="$RESFILE" GUARD="$H" PAYLOAD="$PAYFILE" python3 - <<'PY'
+import io, os, re, subprocess, sys
+
+msg = io.open(os.environ["MSGFILE"], encoding="utf-8").read()
+res = []
+
+
+def t(ok, name, detail=""):
+    res.append((bool(ok), name, detail))
+
+
+here = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) \
+    if "__file__" in dir() else os.getcwd()
+ticket = os.path.realpath(os.path.join(os.getcwd(), "scripts", "ticket"))
+
+# ⑮ 那塊指令**真正要執行的那一行**，開頭是絕對路徑，而且指到這一份正本。
+#    🔴 判準刻意放在「要執行的那一行」上，不是「訊息裡出現過的所有路徑」——
+#      後者在相對路徑混進來時是**空過**的（別的行還有絕對路徑，all() 照樣真）。
+#      2026-08-31 變異測試當場抓到：把 example 改回相對路徑，舊寫法的 ⑮ 沒紅。
+run_line = ""
+for l in msg.splitlines():
+    if " subtask " in l and l.strip().endswith("\\"):
+        run_line = l.strip()
+        break
+first = run_line.split()[0] if run_line else ""
+t(first.startswith("/") and os.path.realpath(first) == ticket,
+  "⑮ 要執行的那一行開頭是絕對路徑，且就是這一份正本",
+  "那一行：%s" % (run_line or "（找不到）"))
+
+# ⑯ 訊息裡**不准**出現相對的 `scripts/ticket`
+#    相對路徑是對「貼上去那個人的 cwd」解析的，而 InkStoneCo/scripts/ticket 是舊複本。
+rel = [l for l in msg.splitlines()
+       if re.search(r"(?<![\w/])scripts/ticket\b", l)]
+t(not rel, "⑯ 訊息裡沒有任何相對路徑的 scripts/ticket",
+  "違規行：%s" % (rel[:2] or ""))
+
+# ⑰ 訊息裡的用法區塊 ＝ `ticket usage subtask` 的輸出（**一字不差**）
+#    這就是「不再有第二份可以漂」的機械證明：漂了這一條當場紅。
+usage = subprocess.run([sys.executable, ticket, "usage", "subtask"],
+                       capture_output=True, text=True).stdout.strip()
+flat_msg = "\n".join(l.strip() for l in msg.splitlines())
+flat_use = "\n".join(l.strip() for l in usage.splitlines())
+t(flat_use and flat_use in flat_msg,
+  "⑰ 訊息裡的用法就是 `ticket usage subtask` 的輸出，沒有第二份",
+  "" if flat_use in flat_msg else "訊息裡找不到正本印的用法")
+
+
+def extract_block(m):
+    """把訊息裡那塊指令**原樣**抽出來——不重新產生，否則就驗不到漂移。"""
+    lines = m.splitlines()
+    i = next(k for k, l in enumerate(lines) if l.startswith("cat > "))
+    md = next(k for k in range(i, len(lines)) if lines[k] == "MD")
+    j = next(k for k in range(md + 1, len(lines)) if not lines[k].endswith("\\"))
+    return "\n".join(lines[i:j + 1])
+
+
+def fill(block):
+    """只填三格機器不可能知道的：標題、目標、驗收條件。其餘一個字都不改。"""
+    block = (block.replace("<誰>", "跑這行指令的人")
+                  .replace("<什麼>", "它真的跑得動")
+                  .replace("<為什麼>", "不會被迫去繞過它"))
+    return re.sub(r"<[^<>\n]+>", "測試填的內容", block)
+
+
+ENV = dict(os.environ, TICKET_HOST="http://127.0.0.1:9",
+           GITEA_TOKEN_CLAUDE_CODE="dummy", GITEA_TOKEN="dummy")
+
+# ⑱ ★ 把它原樣貼上、只填那三格，**真的跑一次**。
+#    離開碼 2 ＝ 被某道閘擋下（動詞不存在／旗標不成組／標題不合格…）＝ 這張票的病復發
+#    離開碼 1 ＝ 一路走到網路才炸（TICKET_HOST 指到連不上的位址）＝ 參數全部過關
+try:
+    blk = fill(extract_block(msg))
+    r = subprocess.run(["bash", "-c", blk], capture_output=True, text=True, env=ENV)
+    code = r.returncode
+except StopIteration:
+    blk, code, r = "", -1, None
+t(code == 1, "⑱ ★ 訊息裡那塊指令原樣貼上就跑得完（走到網路才停，不是被閘擋）",
+  "離開碼 %s（2 ＝ 又被某道閘擋下）%s"
+  % (code, ("｜" + (r.stderr or "").strip().splitlines()[0][:80]) if r and code == 2 else ""))
+
+# ⑲ 鑑別力對照：⑱ 不是「只要跑就會過」。
+#    把閘**原本**印的那組旗標（`--assign <誰做>` 沒配 `--next`）接回去 ⇒ 必須紅。
+if blk:
+    bad = blk.rstrip() + " --assign claude-code"
+    rb = subprocess.run(["bash", "-c", bad], capture_output=True, text=True, env=ENV)
+    t(rb.returncode == 2,
+      "⑲ 對照組：閘原本那組旗標（--assign 沒配 --next）確實跑不完",
+      "離開碼 %s（要是 2；不是 2 就表示 ⑱ 沒有鑑別力）" % rb.returncode)
+else:
+    t(False, "⑲ 對照組：抽不出指令區塊", "")
+
+# ⑳ 草稿模板與必填檢查**同源**：模板裡一定有 REQUIRED_SECTIONS 的每一段。
+#    寫死一份模板的話，有人往 REQUIRED_SECTIONS 加一段就會生出
+#    「照著貼卻過不了自己那道閘」的票——正是這張票要修的形狀。
+req = subprocess.run(
+    [sys.executable, "-c",
+     "import runpy,sys;m=runpy.run_path(sys.argv[1]);"
+     "print('\\x00'.join(m['REQUIRED_SECTIONS']));"
+     "print(m['body_template']())", ticket],
+    capture_output=True, text=True)
+head, _, tmpl = req.stdout.partition("\n")
+secs = [x for x in head.split("\x00") if x]
+t(secs and all(x in tmpl for x in secs) and all(x in msg for x in secs),
+  "⑳ 草稿模板由 REQUIRED_SECTIONS 現生，訊息裡也齊",
+  "必填段：%s" % secs)
+
+# ㉑ 正本叫不動時（雲端裝壞、路徑不對）：**閘照樣擋**，而且**不准就地補一份手抄用法**
+#    ——那份副本正是這張票拔掉的東西。fail-open 的是「訊息內容」，不是「擋不擋」。
+fb = subprocess.run(["bash", os.environ["GUARD"]],
+                    input=io.open(os.environ["PAYLOAD"], encoding="utf-8").read(),
+                    capture_output=True, text=True,
+                    env=dict(os.environ, CLAUDE_PLUGIN_ROOT="/tmp/isep-no-such-root"))
+fbmsg = fb.stderr
+t(fb.returncode == 2 and "usage subtask" in fbmsg
+  and "--title" not in fbmsg and "[--journey" not in fbmsg,
+  "㉑ 正本叫不動時仍然擋，且只指路、不補一份手抄用法",
+  "離開碼 %s｜訊息裡有沒有手抄用法：%s"
+  % (fb.returncode, "有（違規）" if "[--journey" in fbmsg else "沒有"))
+
+npass = 0
+for ok, name, detail in res:
+    print("  %s %s%s" % ("✅" if ok else "❌", name,
+                         ("　※ " + detail) if (detail and not ok) else ""))
+    npass += 1 if ok else 0
+io.open(os.environ["RESFILE"], "w", encoding="utf-8").write(
+    "%d %d" % (npass, len(res) - npass))
+PY
+read -r P2 F2 < "$RESFILE"
+PASS=$((PASS + P2)); FAIL=$((FAIL + F2))
+rm -f "$MSGFILE" "$RESFILE" "$PAYFILE" "/tmp/isep-subtask-$SID2.md" \
+      "/tmp/.comment-task-guard-warned-$SID2"
+
 echo
 echo "$PASS/$((PASS+FAIL)) 通過"
 [ "$FAIL" = 0 ]

scripts/test-make-cloud-env.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+# make-cloud-env.sh 的測試（docs/TESTING.md A14）
+#
+# 它守什麼: 那支腳本是「雲端總管手上有哪些憑證」的唯一清單。清單漏一把，
+#           雲端會在**流程末端**才發現跑不了（inkstone/ISEP#115 內文：派了工人寫完
+#           清空腳本、寫完測試，到要真的跑的那一刻才知道 CF token 根本不在）。
+#
+# 兩段:
+#   A 段 —— 用假的 .env 隔離跑，證明「產物長對、缺值不會假綠、什麼都不寫進 repo」。
+#           全程不碰真金鑰、不碰 ~/.claude/cloud-env。
+#   B 段 —— 拿這台機器真正的 .env 對帳，證明清單上每一把**這台都拿得到值**，
+#           而且**沒有一把的值來自 polaris/mira/.env**（leo21c 現役正式環境）。
+#           .env 不在（例如雲端）⇒ 印 ⏭️ SKIP，不算通過也不算失敗。
+#
+# 🔴 B8／B9 的判準都不是名字，是機器算得出來的事實——**換什麼名字都躲不掉**。
+#    B8 看「這個值是從哪個檔案拿到的」（出自 polaris/mira/.env ＝ leo21c 現役正式環境）。
+#    B9 看「這個值是不是就是 leo21c 那把 token」（值相等就紅，改名叫什麼都一樣）。
+#    🔴 兩條是分工不是重複：`CLOUDFLARE_API_TOKEN_leo21c` 住在**頂層** .env，
+#       不在 polaris/mira/.env ⇒ **B8 抓不到它**，這正是 B9 存在的理由。
+#    關鍵字黑名單反過來只擋得住已經被列進去的那幾個名字，新名字一律漏掉
+#    （leo 2026-08-17 已證偽文字層封路：當日 8 次誤攔、0 次正確攔截）。
+#
+# 🔴 全程只印變數**名字**與值的**長度**，一個字元的值都不印。
+cd "$(dirname "$0")/.." || exit 1
+S=scripts/make-cloud-env.sh
+PASS=0; FAIL=0; SKIP=0
+ok(){   PASS=$((PASS+1)); printf '  ✅ %s\n' "$1"; }
+bad(){  FAIL=$((FAIL+1)); printf '  ❌ %s\n' "$1"; }
+skip(){ SKIP=$((SKIP+1)); printf '  ⏭️  SKIP %s\n' "$1"; }
+chk(){ [ "$1" = "$2" ] && ok "$3（$2）" || bad "$3：want=$1 got=$2"; }
+
+# 清單與搜尋路徑都從腳本本身讀出來——測試不另養一份，養了就會漂。
+# 註：macOS 內建的是 bash 3.2，沒有 mapfile／readarray，一律用 while read 收陣列。
+NEEDED=()
+while IFS= read -r l; do NEEDED+=("$l"); done < <(
+  sed -n '/^NEEDED=(/,/^)/p' "$S" | sed -E '1d;$d; s/[[:space:]]*#.*$//; s/[[:space:]]//g' | grep -v '^$')
+[ "${#NEEDED[@]}" -gt 0 ] || { echo "🔴 從 $S 讀不出 NEEDED，測試本身壞了"; exit 1; }
+echo "清單（只有名字）：${NEEDED[*]}"
+echo
+
+TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
+FAKE="$TMP/fakeroot"; OUTD="$TMP/out"; mkdir -p "$FAKE"
+
+echo "── A. 隔離跑（假 .env，不碰真金鑰、不碰 ~/.claude/cloud-env）──"
+: > "$FAKE/.env"
+for n in "${NEEDED[@]}"; do echo "$n=FAKEVALUE-$n" >> "$FAKE/.env"; done
+
+BEFORE=$(git status --porcelain)
+OUT_LINE=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
+F=$(printf '%s\n' "$OUT_LINE" | sed -n 's/^✅ 產生完成：//p')
+
+[ -f "$F" ] && ok "A1 產物產出來了" || bad "A1 產物不存在（腳本輸出：$OUT_LINE）"
+chk 600 "$(stat -f '%OLp' "$F" 2>/dev/null || stat -c '%a' "$F" 2>/dev/null)" "A2 產物權限"
+
+miss=0
+for n in "${NEEDED[@]}"; do grep -qx "$n=FAKEVALUE-$n" "$F" || { miss=$((miss+1)); echo "     ↑ 沒出現：$n"; }; done
+chk 0 "$miss" "A3 每個名字都帶著值出現在 ① 區塊"
+
+printf '%s\n' "$OUT_LINE" | grep -q "找不到值的 0 個" \
+  && ok "A4 收尾那行說「找不到值的 0 個」" || bad "A4 收尾計數不對：$OUT_LINE"
+
+# 缺值時不准假綠：拿掉第一個，它要變成 <🔴 …> 且計數變 1
+grep -v "^${NEEDED[0]}=" "$FAKE/.env" > "$FAKE/.env.tmp" && mv "$FAKE/.env.tmp" "$FAKE/.env"
+OUT2=$(INKSTONE_ROOT="$FAKE" OUT_DIR="$OUTD" bash "$S" 2>&1)
+F2=$(printf '%s\n' "$OUT2" | sed -n 's/^✅ 產生完成：//p')
+grep -q "^${NEEDED[0]}=<🔴" "$F2" && ok "A5a 缺值那行標成 <🔴 …>" || bad "A5a 缺值沒被標出來"
+printf '%s\n' "$OUT2" | grep -q "找不到值的 1 個 ${NEEDED[0]}" \
+  && ok "A5b 收尾點名缺的是誰" || bad "A5b 收尾沒點名：$OUT2"
+
+if [ "$BEFORE" = "$(git status --porcelain)" ]; then ok "A6 跑完沒有任何檔案被寫進 repo"
+else bad "A6 repo 裡多了東西：$(diff <(printf '%s\n' "$BEFORE") <(git status --porcelain) | tr '\n' ' ')"; fi
+
+echo
+echo "── B. 拿這台機器真正的 .env 對帳（只印長度，不印值）──"
+ENVF=()
+while IFS= read -r l; do ENVF+=("$l"); done < <(
+  sed -n '/^ENV_FILES=(/,/^)/p' "$S" | sed -E '1d;$d; s/^[[:space:]]*"//; s/"[[:space:]]*$//' | grep -v '^$')
+BASE="${INKSTONE_ROOT:-$HOME/Documents/tech_projects/InkStoneCo}"
+real_src(){  # $1=名字 → 印出「值的長度 來源檔」；找不到回非 0
+  local name="$1" f p v
+  for p in "${ENVF[@]}"; do
+    f="${p/\$BASE/$BASE}"; f="${f/\$\{BASE\}/$BASE}"
+    [ -f "$f" ] || continue
+    v=$(grep -E "^[[:space:]]*(export[[:space:]]+)?${name}=" "$f" 2>/dev/null | tail -1 \
+        | sed -E "s/^[[:space:]]*(export[[:space:]]+)?${name}=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/')
+    [ -n "$v" ] && { printf '%s %s' "${#v}" "$f"; return 0; }
+  done
+  return 1
+}
+# 只取值、不取來源，給 B9 比對用。值只活在變數裡，從不印出、也不寫檔。
+_val(){ local r f; r=$(real_src "$1") || return 1; f="${r#* }"
+  grep -E "^[[:space:]]*(export[[:space:]]+)?$1=" "$f" | tail -1 \
+    | sed -E "s/^[[:space:]]*(export[[:space:]]+)?$1=//" | sed -E 's/^"(.*)"$/\1/; s/^'"'"'(.*)'"'"'$/\1/'; }
+
+found=0
+for p in "${ENVF[@]}"; do f="${p/\$BASE/$BASE}"; [ -f "$f" ] && found=1; done
+
+if [ "$found" = 0 ]; then
+  skip "B7 這台機器一個 .env 都沒有（雲端就是這個狀態），對帳跳過"
+  skip "B8 同上"
+else
+  gone=0; prod=0
+  for n in "${NEEDED[@]}"; do
+    if r=$(real_src "$n"); then
+      len="${r%% *}"; src="${r#* }"
+      printf '     %-38s → 找得到（長度 %s）來自 %s\n' "$n" "$len" "${src#$BASE/}"
+      case "$src" in */polaris/mira/.env) prod=$((prod+1)); echo "     🔴 ↑ 這是 leo21c 現役正式環境那份 .env";; esac
+    else
+      printf '     %-38s → 🔴 這台拿不到\n' "$n"; gone=$((gone+1))
+    fi
+  done
+  chk 0 "$gone" "B7 清單上每一把這台都拿得到值"
+  chk 0 "$prod" "B8 沒有一把的值來自 polaris/mira/.env（leo21c 正式環境）"
+
+  # B9 —— leo 2026-09-01 的紅線：「CLOUDFLARE_API_TOKEN_leo21c 不准加」。
+  # 🔴 判準是**值**不是名字：拿 leo21c 那把的值，比對清單上每一把解出來的值。
+  #    有人把它改名叫 CF_TOKEN_BACKUP 照樣會紅，而黑名單會放它過去。
+  #    B8 抓不到這一條（那把住在頂層 .env，不在 polaris/mira/.env）。
+  if leoval=$(_val CLOUDFLARE_API_TOKEN_leo21c); then
+    hit=0
+    for n in "${NEEDED[@]}"; do
+      v=$(_val "$n") || continue
+      [ "$v" = "$leoval" ] && { hit=$((hit+1)); echo "     🔴 $n 的值就是 leo21c 那把"; }
+    done
+    chk 0 "$hit" "B9 清單上沒有一把的值等於 CLOUDFLARE_API_TOKEN_leo21c"
+  else
+    skip "B9 這台找不到 CLOUDFLARE_API_TOKEN_leo21c，沒有比對基準"
+  fi
+
+  # B8 全綠有兩種可能：真的沒有正式憑證，或**偵測根本不會亮**。分得開才算驗過。
+  # 拿一個已知住在 polaris/mira/.env 的名字餵它，看它認不認得出來。
+  if r=$(real_src CLOUDFLARE_ACCOUNT_ID); then
+    case "${r#* }" in
+      */polaris/mira/.env) ok "B8x 反例自驗：把 leo21c 那份 .env 的變數餵進去，偵測認得出來" ;;
+      *) skip "B8x 反例自驗：CLOUDFLARE_ACCOUNT_ID 這次解到 ${r#* }，不是 mira 那份，這台沒得驗" ;;
+    esac
+  else
+    skip "B8x 反例自驗：這台找不到 CLOUDFLARE_ACCOUNT_ID，沒有現成的反例可餵"
+  fi
+fi
+
+echo
+echo "$PASS/$((PASS+FAIL)) 通過，跳過 $SKIP 條"
+[ "$FAIL" -eq 0 ]

scripts/ticket

@@ -26,6 +26,8 @@ leo 2026-08-16 三句話，本工具就是它們的機械化：
     ticket mine [--user <誰>]                     撈一次：棒子在誰手上、每根下一步是什麼
     ticket loose                                  撈一次：下游都關了、自己還開著的頂層票
 
+    ticket usage <動詞> [--example]               用法的唯一真相源——**閘印的那一行從這裡來**
+
 票的寫法：`owner/repo#N`，例：`inkstone/InkStoneCo#44`
 """
 import json
@@ -504,6 +506,10 @@ def _writeback(owner, repo, num, deliv):
                           for i in open_left]
                 lines += ["", "⇒ 本票維持原狀，不要當成可以收了。"]
             else:
+                # 🔴 這一段是要**貼進 Gitea 留言**的，所以 `ticket close` 刻意寫成相對的
+                #    ——留言會被別台機器讀到，寫死本機的絕對路徑等於寫死一個他們沒有的檔案。
+                #    絕對路徑那條規約（inkstone/ISEP#112）管的是**印到終端機、要人複製貼上**的字，
+                #    兩者分界就是這一句：「這行字會被誰複製、在哪台機器上跑？」
                 lines += ["", "**這是最後一張下游——本票的下游已經全部關閉。**", "",
                           f"{BATON_MARK}　→ `{HANDBACK_TO}`", "",
                           "**下一步**：驗一次頂層要的東西真的到齊了，到齊就 "
@@ -719,6 +725,134 @@ def writeback_plan(parent_state, parent_deps):
     return ("note" if open_left else "handback"), open_left
 
 
+# ══════════════════════════════════════════════════════════════════════════
+# inkstone/ISEP#112 — 閘教的那行指令要真的跑得動
+#
+# 票上的原話：「**當它教的做法不存在，它就從『幫你』變成『擋你』**——
+#   而且被擋的人當下正在做別的事，最可能的反應是找個理由繞過去。」
+#
+# 那次它為什麼跑不動，兩個獨立的原因（2026-08-31 實測，兩個都會單獨害死它）：
+#
+#   ① **相對路徑**。閘印的是 `scripts/ticket subtask …`，而相對路徑是對
+#      **貼上去那個人的 cwd** 解析的。總管的 cwd 是 `InkStoneCo/`，那裡的
+#      `scripts/ticket` 是本檔停在 2026-08-27 之前的**舊複本**：
+#          grep -c subtask InkStoneCo/scripts/ticket  → 0
+#      它的 docstring 只列到「四個動詞」，於是照著貼會印出那段說明、exit 0、
+#      什麼都沒發生 —— 正是票上寫的症狀。
+#      （`hooks/lib/beacon_report.py` ② 已經會在 SessionStart 報這個舊複本，
+#        但**報告不會改掉閘印出來的那一行**。）
+#
+#   ② **用法各寫一份**。閘手寫了一段用法，`cmd_subtask` 的 die() 又寫了一段。
+#      兩份已經漂了：閘那份寫 `--assign <誰做>` 卻**沒有 `--next`**，
+#      而 cmd_subtask 會因為「🚫 指派了人卻沒寫 --next。」直接 die（實測 exit 2，
+#      而且是在打任何 API 之前，所以離線也複現得出來）。
+#      ⇒ 就算路徑對了，那一行照樣跑不完。
+#
+# 🔴 修法是**拿掉可以漂的那一格**，不是把兩份對齊一次：
+#      · 路徑     → self_path()，`__file__` 的絕對路徑。印指令的人與跑指令的人
+#                   是同一個檔案，沒有第二種可能。
+#      · 用法     → USAGE 這一份。閘去 `ticket usage subtask` 拿，不自己抄。
+#      · 內文模板 → body_template() 由 REQUIRED_SECTIONS 現生。
+#                   檢查與模板同一個來源 ⇒ 模板不可能少一段。
+# ══════════════════════════════════════════════════════════════════════════
+
+def self_path():
+    """這支腳本自己的絕對路徑。**閘印出來的指令一律用它。**
+
+    不用 `sys.argv[0]`：那是「別人怎麼叫我」，被相對路徑叫進來時它就是相對的。
+    `__file__` 走 realpath 是「我是誰」——貼到任何 cwd 底下都指得回同一個檔案。
+    """
+    return os.path.realpath(__file__)
+
+
+# 每一段必填欄位的草稿提示。**鍵一定要是 REQUIRED_SECTIONS 裡的字串**——
+# 對不上也不會漏掉那一段（下面會退成 `<填這裡>`），只是提示變笨。
+SECTION_HINTS = {
+    "## 目標": "<這件事要達成什麼。寫目的，不要寫做法>",
+    "## 驗收條件": "- [ ] <怎麼算做完——別人可以自己跑一次的那種>",
+    "## deliverable 類型": "code",
+}
+
+
+def body_template():
+    """子票內文的草稿，**用 REQUIRED_SECTIONS 現生**。
+
+    🔴 不要把這段字面寫死：寫死就變成第二份，而 `cmd_subtask` 檢查的是
+       REQUIRED_SECTIONS。有人往那個清單加一段，寫死的模板就會生出一張
+       **照著貼卻過不了自己那道閘**的票 —— 這張票要修的就是這個形狀。
+    """
+    out = []
+    for sec in REQUIRED_SECTIONS:
+        out.append(sec)
+        out.append(SECTION_HINTS.get(sec, "<填這裡>"))
+        out.append("")
+    return "\n".join(out).rstrip() + "\n"
+
+
+def subtask_example(parent=None, draft=None):
+    """可以整段複製貼上的那一塊：先把內文草稿寫出來，再開子票。
+
+    刻意**不放 `--assign`**：`--assign` 沒配 `--next` 會被擋（見 cmd_subtask），
+    而一行印出來卻跑不完的指令，正是這張票在修的病。要指派的人看 USAGE 那份，
+    那裡兩個參數是綁在一起寫的。
+
+    留在 <> 裡的只有三件**機器不可能知道**的事：標題、目標、驗收條件。
+    其餘（腳本路徑、母票、必填段落、標籤）全部已經填好。
+    """
+    parent = parent or "<母票 owner/repo#N>"
+    draft = draft or "/tmp/subtask-body.md"
+    return (
+        "cat > %s <<'MD'\n" % draft
+        + body_template()
+        + "MD\n"
+        + "%s subtask %s \\\n" % (self_path(), parent)
+        + '    --title "身為<誰>，我要<什麼>，我才<為什麼>" \\\n'
+        + "    -F %s --label s/todo\n" % draft
+    )
+
+
+# 🔴 `{bin}` 一定要留成佔位符、由 usage_text() 現填 self_path()：
+#    用法裡寫死 `ticket` 或 `scripts/ticket`，讀的人照著貼就又踩回這張票的坑。
+USAGE = {
+    "subtask":
+        "用法：{bin} subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
+        "      [--repo <收件 repo，預設跟母票同一個>] [--label <s/xxx，預設 s/todo>]\n"
+        "      [--journey <旅程名>]　← 這件事服務哪條使用者旅程（對不上就不要加）\n"
+        "      [--assign <誰做> --next \"<他第一件事要做什麼>\"]　← 這兩個是一組，"
+        "指派了就一定要寫下一步\n"
+        "\n（`ticket handoff` 是同一個動作的別名：頂層票 → 下游 repo）",
+}
+
+
+def usage_text(verb):
+    """用法的**唯一**一份，路徑現填成絕對路徑（inkstone/ISEP#112）。"""
+    return USAGE[verb].format(bin=self_path())
+
+
+def cmd_usage(argv):
+    """把「用法」與「可以貼著跑的那一塊」交給同一個地方產生（inkstone/ISEP#112）。
+
+    閘的訊息**呼叫這一支**，不自己抄一份 ⇒ 訊息與能跑的指令之間沒有第二份可以漂。
+    """
+    verbs = "|".join(sorted(USAGE))
+    if not argv or argv[0] not in USAGE:
+        die("用法：ticket usage <%s> [--example] [--parent <owner/repo#N>] "
+            "[--draft <內文檔路徑>]\n"
+            "  --example ＝ 印一塊可以整段貼著跑的指令（路徑是絕對路徑，母票已填好）" % verbs)
+    verb = argv[0]
+
+    def opt(name, default=None):
+        return argv[argv.index(name) + 1] if name in argv else default
+
+    if "--example" in argv:
+        if verb != "subtask":
+            die("🚫 `ticket usage %s --example` 還沒有可貼著跑的版本。\n"
+                "   先看用法：ticket usage %s" % (verb, verb))
+        sys.stdout.write(subtask_example(opt("--parent"), opt("--draft")))
+        return
+    sys.stdout.write(usage_text(verb).rstrip() + "\n")
+
+
 # ── subtask ──────────────────────────────────────────────────────────────
 def cmd_subtask(argv):
     """把「討論串裡的一件事」長成看得見的子票，並掛成母票的 Gitea 原生相依。
@@ -737,11 +871,9 @@ def cmd_subtask(argv):
     不是「新開一條線」——那道閘擋的是後者。
     """
     if len(argv) < 1:
-        die("用法：ticket subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
+        # 🔴 用法只有 USAGE 那一份（inkstone/ISEP#112）。這裡不准再抄一段：
-            "      [--repo <收件 repo，預設跟母票同一個>] [--label <s/xxx，預設 s/todo>]\n"
+        #    抄一段就是又多一個會漂的副本，而閘印的那一行也是從 USAGE 來的。
-            "      [--journey <旅程名>]　← 這件事服務哪條使用者旅程（對不上就不要加）\n"
+        die(usage_text("subtask"))
-            "      [--assign <誰做> --next \"<他第一件事要做什麼>\"]　← 指派了就一定要寫下一步\n"
-            "\n（`ticket handoff` 是同一個動作的別名：頂層票 → 下游 repo）")
     powner, prepo, pnum = parse_ref(argv[0])
 
     def opt(name, default=None):
@@ -830,7 +962,7 @@ def cmd_subtask(argv):
         print(f"   旅程：`{jlabel}`（母子兩端都貼——只貼一端就聚不起來）")
     else:
         print("   旅程：沒有貼（沒給 --journey）。對得上就補一次："
-              f"`ticket subtask … --journey <旅程名>`；對不上就不要硬湊。")
+              f"`{self_path()} subtask … --journey <旅程名>`；對不上就不要硬湊。")
     print(f"\n📌 母票 {powner}/{prepo}#{pnum} 目前有 {len(openn)} 張未關的相依：")
     for i in deps:
         mark = "◻" if i["state"] == "open" else "☑"
@@ -1026,8 +1158,10 @@ def cmd_loose(argv):
         for d in deps:
             print(f"      ☑ {d['repository']['full_name']}#{d['number']}"
                   f"　{d['title'][:52]}")
-        print(f"    → 驗過就關：ticket close {full}#{n} --deliverable <URL>")
+        # 絕對路徑（inkstone/ISEP#112）：相對的 `scripts/ticket` 會被貼到別的 cwd 底下，
-        print(f"      還缺東西：ticket subtask {full}#{n} --title \"<US>\" -F <檔>")
+        # 在那裡叫到的可能是本檔的舊複本（`InkStoneCo/scripts/ticket` 就是）。
+        print(f"    → 驗過就關：{self_path()} close {full}#{n} --deliverable <URL>")
+        print(f"      還缺東西：{self_path()} subtask {full}#{n} --title \"<US>\" -F <檔>")
         print()
 
     print("📌 這張表撈的是**機械事實**（相依邊的 state），不是猜文字。")
@@ -1038,7 +1172,8 @@ def cmd_loose(argv):
 
 CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
         "decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
-        "handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose}
+        "handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose,
+        "usage": cmd_usage}
 
 if __name__ == "__main__":
     if len(sys.argv) < 2 or sys.argv[1] not in CMDS:

skills/ship-check/SKILL.md

@@ -1,18 +1,21 @@
 ---
 name: ship-check
 description: |
-  改完任何會影響用戶的東西之後、說「做完了」之前必讀（改雲端 worker／portal／daemon／
+  **任何東西要從「內」（Gitea）送到「外」之前必讀**——不只是 arcrun。
-  workflow／installer 都算）。也在下列時機自動載入：要打包 App、要出貨、要推 bundle、
+  對外包含：發一篇部落格文章到 uncle6.me、推 tag 到 GitHub 鏡像 repo、投稿 n8n 官方模板庫、
-  要送 MS Store、leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」。
+  出雲端零件包、出桌面 daemon。也在下列時機自動載入：改完會影響用戶的東西之後、
-  核心判準：**版本號是 leo 唯一的驗收介面**——portal 版本卡看雲端、daemon 檢查更新看桌面；
+  要打包 App／出貨／推 bundle／送 MS Store、要發文、要 pages deploy、要推 GitHub、
-  版本沒動＝他無從判斷你做了什麼＝等於沒交付，而「我在某台實例 wrangler deploy 過了」不算。
+  leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」「發出去了嗎」。
-  收齊：兩條版本線的差別／重打 bundle（最常漏，要 grep 複驗改動真的進去）／
+  🔴 第一個動作是**分辨這是哪個出口**，因為 stage／版本／arm 每個出口都不同——
-  改 workflow 要重編預編圖／三支機械閘＋把 DMG/zip 真的打開檢查／寫 changelog（用戶語言）／
+  流程本體住在 system-dev/docs/3-specs/critical-paths/ship.md（唯一一份），本 skill 是它的入口。
-  D20 開閘出貨／purge jsDelivr／從 leo 會看的那兩處抓實際畫面複驗。
+  核心判準：**收的人拿到的東西真的變了，而且他看得出變了什麼**；
-  附「常見漏掉的」實撞表與收工前五問。
+  對 arcrun 兩條線而言那個介面就是版本號（portal 看雲端、daemon 看桌面）。
+  收齊：五個出口的判準／兩條版本線的差別／重打 bundle（最常漏）／改 workflow 要重編預編圖／
+  三支機械閘＋把 DMG/zip 真的打開檢查／寫 changelog／D20 開閘出貨／purge jsDelivr／
+  從收的人會看的那個地方抓實際畫面複驗。附「常見漏掉的」實撞表與收工前五問。
 ---
 
-# /ship-check — 改完東西後，讓 leo 看得到版本變了
+# /ship-check — 東西要出去之前，先確定收的人真的會拿到
 
 > **這支解什麼病**（leo 2026-08-05 原話）：
 > 「對人來說，**我雲端看 portal 有沒有更新，本地看 daemon 有沒有更新**，
@@ -25,6 +28,44 @@ description: |
 
 ---
 
+## 🚦 第一步：這是哪個出口？（2026-09-02 補，`inkstone/InkStoneCo#112`）
+
+> **為什麼補這段**（leo 2026-09-02）：「Gitea 為『內』，只要對外都是『外』，
+> **任何東西出去之前都要經過出貨流程，不是只有 Arcrun, Arcrun RAG 這個計劃**」
+>
+> 🔴 **這支 skill 2026-09-01 失效過**：它自己與它指向的地方**只認得 daemon 那個形狀**，
+> 於是那晚要發部落格與 GitHub 模板時，它沒把人導向任何可用的流程——**只好即興補**。
+
+- 🔴 **流程本體只有一份**：`system-dev/docs/3-specs/critical-paths/ship.md`
+	- 它定義了**內／外的判準**、**六個步驟**、**五個出口各自的 stage／版本／arm／驗法**
+	- **動手前先讀那一卷的對應出口段**，不要憑本 skill 的印象做
+- **判準一句：送出去之後，有沒有一個不是我們的人看得到／拿得到？** 有 ⇒ 走那六步
+- **五個出口，各自去 `ship.md` 的哪一段**：
+	- ① 桌面 daemon（`v0.18.x`）——**本 skill 底下的內容主要是它與 ②**
+	- ② 雲端零件包（`1.4.x`）——同上
+	- ③ 部落格 uncle6.me — 🔴 **沒有 arm、沒有版本號**，stage 是 `<8碼>.kbcontent.pages.dev` 快照；
+	  `pages deploy` **必須在 repo 外的目錄跑**，否則 `.env` 的 token 會蓋掉 OAuth 並報成權限錯誤
+	  ｜**驗法是瀏覽器，不是 `curl`**（收件人是讀者 ⇒ 見 §5.8 與 `ship.md` 出口③「驗法」）
+	- ④ GitHub 鏡像 repo — 🔴 **要 arm，而且連 `git remote add` 都擋**（D20）；
+	  Gitea 就是它的 stage；**推 tag 之外還要發 release note**
+	  （怎麼發、要不要再 arm ⇒ `ship.md` 出口④ 的「release note 怎麼發」段）
+		- 🔴 **步驟 3 的「Use this template」也要 arm，而且要單獨請一次**——它建的是
+		  **第二個 repo**，撞 ROE「單一 repo」那條，夾不進推 tag 的窗口。
+		  且 guard 只掛在 `Bash` ⇒ **走瀏覽器按那顆按鈕不會被擋，這條靠人守**
+		  （⇒ `ship.md` 出口④ 的「Use this template 要不要 arm」段）
+	- ⑤ n8n 官方投稿 — 沒有 stage，投稿端點尚未查到（`inkstone/llm-wiki-template#9`）
+- 🔴 **不要拿 ① 的答案去套 ③④⑤**——那正是 2026-09-01 出錯的機制
+- 🔴 **「這個出口沒有 arm」不等於「這個出口不必經過 leo」**——③⑤ 的人閘是**步驟 5**
+  （leo 親手在 stage 上走過那一遍）。判準全文＝`ship.md` 的
+  「誰批准、誰按鍵、在哪台跑」段：**leo 批准，機器執行**
+- **跨多個 repo 的一批貨，「100%」看母票的相依清單，不要看 milestone 的百分比**
+  （milestone 只數 hub 那個 repo，別的 repo 那幾張不在分母裡）
+  ⇒ `ship.md` 的「那個數字看哪裡」段
+- 🔴 **發現 `ship.md` 沒涵蓋你手上這件事 ⇒ 那一卷缺了一格，回去補它**，
+  不要在別處另開一份流程（leo 2026-09-02 明確選了「改寫 ship.md」）
+
+---
+
 ## ⚠️ 這支 skill 自己的失效模式（先讀這段）
 
 leo 2026-08-05：「**你寫完一個 skill 然後每個我要提醒你，表示這個 skill 無效**」
@@ -44,8 +85,19 @@ leo 2026-08-05：「**你寫完一個 skill 然後每個我要提醒你，表示
 
 ## 什麼時候跑
 
-**改完任何會影響用戶的東西之後**（雲端 worker／portal／daemon／workflow），
+**任何東西要送到「外面」之前**——改完會影響用戶的東西、要發一篇文章、要推 tag 到 GitHub、
-在說「做完了」之前。不是收工才跑。
+要投稿、要出零件包或 daemon。在說「做完了」之前跑，不是收工才跑。
+
+⚠️ **底下的步驟是出口①②（arcrun 兩條版本線）的細節。**
+出口③④⑤ 請照上面那段回 `ship.md` 讀該出口的判準——**它們沒有版本號卡可以看**。
+
+🔴 **但底下 §5.8「驗前端＝用瀏覽器真的載一次」是全出口通則，不歸①② 所有**
+（2026-09-02 補：本 skill 這句劃界曾把 §5.8 圈進①②，
+而 `ship.md` 對出口③ 給的驗法是 `curl` ⇒ **兩個檔對同一個問題給了兩種答案**）。
+- **一句話判準：用收的人的那個介面驗。**
+	- 收的人的介面是**網頁** ⇒ 瀏覽器（出口③ 讀者、出口① 的 portal 版本卡）
+	- 收的人的介面是 **API／CLI** ⇒ `curl` 才是對的（出口② 的 `/health`，程式在讀它）
+- ⇒ 這不是「①② 用 curl、③ 用瀏覽器」，是**每個出口各自問自己的收件人在看什麼**
 
 ---
 
@@ -503,6 +555,10 @@ curl -s "https://rag.arcrun.dev/docs/start/install-windows/?cb=$RANDOM" \
 
 > leo 原話：「**你的環境有 web，你應該用 web 驗，你已經開啓了卻沒有完成，你要把這個列入規定。**」
 
+🔴 **適用範圍：全出口，不是只有①②**（2026-09-02 補，見上面「什麼時候跑」那段的劃界）。
+**收的人的介面是網頁就套這條**——出口③ 部落格的收件人是讀者，他的介面就是瀏覽器。
+`ship.md` 出口③「驗法」那格寫的是同一件事，兩邊只有一種說法。
+
 **為什麼 `curl | grep` 是假驗證**（08-08 實撞，leo 抓到而不是我發現）：
 `curl` 拿到的是 **HTML 原始碼**——它**不執行 JS、不載入 `config.js`、不發 API 請求**。
 所以我 grep 到文案就宣稱「前端驗過」，而使用者實際打開看到的是整條紅色錯誤：

system-dev/wiki/mistakes.md

@@ -154,3 +154,78 @@ leo 當場：「**這些為什麼不寫到票裡？**」
 📌 KBDB 缺這一段: 2026-08-31 用 `kbdb_search(mode='semantic')` 查
    「SDD 生命週期／單一活性／取消 Active SDD」**0 命中**（最接近的是 2026-08-09
    一張講 SDD × Gitea 整合摩擦的卡，那是裁決之前）。⇒ 這條開發史還沒進 KBDB。
+
+## ⚠️ MISTAKE: 閘擋對了，但它印出來的那條出路**跑不動**
+
+票: `inkstone/ISEP#112`
+日期: 2026-08-31
+
+症狀: `comment-carries-task-guard.sh` 擋下留言時教你跑
+      `scripts/ticket subtask …`。照著貼，會印出一段「四個動詞」的說明然後
+      什麼都沒發生。被擋的人當下正在做別的事，最可能的反應是**找個理由繞過去**。
+
+實查: 兩個**各自獨立**的原因，任何一個單獨存在都足以害死它——
+  ① **相對路徑**。閘印的是 `scripts/ticket`，而相對路徑是對
+     **貼上去那個人的 cwd** 解析的。總管的 cwd 是 `InkStoneCo/`，
+     那裡的 `scripts/ticket` 是正本停在 2026-08-27 之前的舊複本：
+     `grep -c subtask InkStoneCo/scripts/ticket` → **0**（正本是 10）。
+     ⇒ 「`subtask` 這個子命令不存在」這個結論**在那個 cwd 底下是真的**。
+  ② **用法各寫一份**。閘手抄了一段用法，`cmd_subtask` 的 `die()` 又寫了一段。
+     兩份已經漂了：閘那份寫 `--assign <誰做>` 卻**沒有 `--next`**，
+     而正本會因為「指派了人卻沒寫 --next」直接擋下（實測 exit 2）。
+     ⇒ **就算路徑對了，那一行照樣跑不完。**
+
+原因: 閘的訊息與它教的那支工具是**兩份各自維護的字**。
+      `hooks/lib/beacon_report.py` ② 早就會在 SessionStart 報「專案裡有舊複本」，
+      **但報告不會改掉閘印出來的那一行**——知道有這個坑，跟那一行會不會踩到它，
+      是兩件事。
+
+正確做法:
+  - **路徑**：印出來要人複製的指令，一律用正本自己的 `__file__` 絕對路徑
+    （`scripts/ticket` 的 `self_path()`）。印指令的人與跑指令的人是同一個檔案，
+    沒有第二種可能。
+    ⚠️ 分界線是「**這行字會被誰複製、在哪台機器上跑？**」——
+    要**貼進 Gitea 留言**的指令反而要維持相對寫法（留言會被別台機器讀到）。
+  - **用法**：只留一份（`scripts/ticket` 的 `USAGE`／`usage_text()`），
+    閘去 `ticket usage subtask --example` 現要，不自己抄。
+  - **模板**：子票內文草稿由 `REQUIRED_SECTIONS` 現生（`body_template()`），
+    跟檢查同源 ⇒ 不可能生出「照著貼卻過不了自己那道閘」的票。
+
+🔴 **驗法要驗到「它跑不跑得動」，不是「它有沒有擋」。**
+`scripts/test-comment-carries-task-guard.sh` ⑱ 把閘 stderr 裡那塊指令
+**原樣抽出來、只填三格、真的執行一次**：離開碼 1（走到網路才停）＝過，
+2（被某道閘擋下）＝這個病復發。⑲ 是它的鑑別力對照組。
+
+📌 推廣：**一支閘的價值是「擋下來 ＋ 給一條走得通的路」。**
+出路走不通時它不是幫你，是擋你——而被擋的人不會停下來修閘，
+他會去找繞過去的方法。所以「出路能不能跑」要跟「判準準不準」一樣被測。
+## ⚠️ MISTAKE: 「雲端該有哪些憑證」的清單是唯一真相源，卻沒有任何東西在跟機器對帳
+
+票: `inkstone/ISEP#115`（→ comment `5522`／`5526`）
+日期: 2026-09-01
+
+症狀: 雲端 session 要清空 youlin，`env | grep -ciE 'cloudflare|^CF_|wrangler'` → **0**。
+      而 `credentials-map.md` 明明寫著那把 token 在 `InkStoneCo/.env`。
+
+實查: 不是雲端漏設。`scripts/make-cloud-env.sh` 的 `NEEDED` 當時**只有 1 個變數**，
+      裡面從來沒有任何 CF 憑證。而 `inkstone/InkStoneCo#14` comment `3890`
+      （2026-08-20）盤點出的 A 段是 **8 個**——那一版三段輸出的腳本，
+      到今天為止只活在**沒併進 `main` 的分支 `fix/cloud-env-parity-14`（PR #43）**上。
+
+原因: 盤點做在票上、實作做在分支上、`main` 上的清單是另一回事——**三份，互不對帳**。
+      🔴 而清單漏一項的代價**在流程末端才付**：工人已經把腳本與測試都寫完了，
+      到要真的跑的那一刻才知道跑不了。
+
+正確做法: 清單要有測試逼它跟這台機器對帳（`scripts/test-make-cloud-env.sh`，
+      `docs/TESTING.md` A26）——B 段逐一去 `.env` 找值，找不到就紅。
+      🔴 而「不准混進正式環境憑證」這一條，判準一律是**機器算得出來的事實**，
+      **不是名字裡有沒有某個字**——兩條分工：
+      B8 看**值從哪個檔案拿到的**（出自 `polaris/mira/.env` ＝ leo21c 現役正式環境就紅）；
+      B9 看**這個值是不是就是 `CLOUDFLARE_API_TOKEN_leo21c`**（那把住在頂層 `.env`，
+      B8 抓不到，而改個名字黑名單就放它過去——實跑證過）。黑名單擋不住沒被列進去的新名字，
+      「這個值出自那份 `.env`」是 grep 得出來的事實，換什麼名字都躲不掉。
+      同時釘住反面（B8x）：拿一個已知住在那份 `.env` 的變數餵它，證明偵測**真的會亮**——
+      否則「全綠」有兩種可能（真的乾淨／偵測壞了），而分不開就等於沒驗。
+
+⇒ **推廣**：repo 裡任何「這台機器該有什麼」的清單，都要有一支東西定期拿它去問機器。
+   清單自己不會知道它漏了什麼。