ship-check 送到得了任何 session：內容原樣搬過來，歸屬寫下來讓機器去比 #127
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: inkstone/ISEP#127
Reference in New Issue
Block a user
Delete Branch "fix/isep-122-ship-check-delivery"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Parent:
inkstone/ISEP#122（→ comment 6096）一句話
ship-check那五份分身裡，plugin 這一份原樣換成真相源的內容（不是我寫的，逐位元組相同），並且把「誰是真相源」寫成機器讀得懂的表，交給既有的信標去比——不新開閘。
驗收條件逐條
1. 「要發部落格文章」的情境載得到，而且是五個出口那版
描述是 skill 被自動載入的唯一判準。實測兩版的描述：
grep -c 出口 skills/ship-check/SKILL.md→ 20。cmp對InkStoneCo@bd52fa3的同名檔：逐位元組相同（md5f565e4df…）。◐ 這一格我沒有跑真 session 驗：要在隔離 HOME 裝這個分支再開一個 session，
權限被擋下來了。所以「載入路徑通不通」我是用既有事實補的——
isep:ship-check現在就出現在這台機器的 skill 清單裡（0.16.2 那份），而我只改了那個檔案的內容，沒有動位置與 frontmatter 形狀。
2. 說得出哪一份是真相源，而且不靠人記得
docs/file-ownership.tsv：真相源／來源路徑／取自哪顆 commit／當時的 sha256isep-presence-beacon.sh（hooks/lib/beacon_report.py）上：它的 ② 本來就在做「同名而內容不同」，只是只掃
scripts/⇒ ②b 補上
skills／commands／agents，②c 用 sha256 單邊驗（雲端沒有 InkStoneCo 可比）實跑（這棵樹 × 真的 InkStoneCo）：
3. 升版 — 🔴 待總管定版。
為什麼是「搬全文」不是「改成指針」
雲端的 project dir 是薄殼根，InkStoneCo 只是它底下一個目錄
（
docs/governance/cloud-wiring.md）⇒InkStoneCo/.claude/skills/在雲端不會載入。ISEP 不帶全文 ＝ 雲端拿不到 ＝ 又變回「薄殼是真身的子集」，那正是本 repo 成立要殺的病。
⇒ ISEP 帶全文，但它是搬運工不是作者。
順手撞到、順手修掉的一件（第一顆 commit）
history-first-guard.sh印的🚪 touch /tmp/.kbdb-down從來沒有放行過任何人：touch造的是空檔，而它讀的是檔案內容當時戳 ⇒ 空字串當 0 ⇒「距今 17 億秒」⇒ 恆擋。今天 KBDB 真的掛了（兩支工具都
Connection closed），照著打，被一模一樣擋第二次。跟
#122comment 6071、#125同一句話：閘印出來的下一步，沒有人照著打過一次。修成讀 mtime，補 10 條迴歸（舊版 9/10、④ 紅；新版 10/10）。
要拆成獨立子票的話請說一聲。
測試
六個數字在這棵樹上實數：61 支閘／84 條註冊／7 位工人／7 支命令／2 支 skill／49 支腳本
（這次沒有增減，仍然是數出來的）。
兩件我沒做、要別人做的
.claude/skills/ship-check/與.claude/commands/sdd-check.md兩份舊複本還在，該同步或刪掉。在那之前信標每次開場會點名。scripts/check-version-consistency.sh現在是紅的（tagv0.18.0vs plugin.json0.21.0）——
origin/main上就是紅的，不是這個分支造成的（在 main 的 checkout 上跑過同一支）。實撞（2026-09-02，做這張票的路上）：KBDB 兩支工具都回 Connection closed， 照 history-first-guard.sh 印出來的那行 `touch /tmp/.kbdb-down` 打完再送同一個編輯， **被一模一樣地擋第二次，訊息一字不差**。 根因（打出來的，不是推的）： $ touch /tmp/.kbdb-down $ t=$(cat /tmp/.kbdb-down); echo "[$t]" → [] $ echo $((now - t)) → 1788318047 ≥ 3600 touch 造的是空檔，而那支閘讀的是**檔案內容**當時戳 ⇒ 空字串被當成 0 ⇒「距今 17 億秒」⇒ 永遠不新鮮 ⇒ 恆擋。 ⇒ 那行逃生門是印出來好看的，**沒有人照著打過一次**。 跟本票 comment 6071（scripts/ticket 沒有 handback 這個動詞）、 inkstone/ISEP#125（worktree 閘的逃生門原文照打 rc=2）是同一句話。 改法：內容不是數字就改用檔案的 mtime——touch 做的正是更新 mtime， 所以訊息那一行從此真的走得通；kbdb-asked-stamp.sh 寫數字的舊格式照樣相容。 路徑加 KBDB_STAMP_DIR 覆寫，只為了讓測試不去動這台機器真正的戳記 （清掉別的 session 的戳記＝把閘弄成隨機的）。 沒有把閘弄鬆：過期的戳記照樣不算數（測試第 ⑦ 條守這件事）， 文件／新檔／測試檔本來就不擋的三條也各有一格守著。 驗（hooks/tests/history-first-guard.test.sh，10 條，全離線）： 修好後 10/10 修好前（路徑隔離） 9/10 —— ④「擋人的換成歷史警察了嗎」紅 ⚠️ 第 ③ 條兩版都綠（它只驗離開碼，而過了第 0 道還有歷史警察會擋） 真正分辨得出新舊的是 ④，檔頭寫了怎麼重現這個對照。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>## 這一份是原樣搬過來的，一個字都沒改 skills/ship-check/SKILL.md ← inkstone/InkStoneCo `bd52fa3`（PR #114，**還沒併**） 搬完 md5 f565e4df1b18cc8aaf057f5fa64a9e15，跟來源逐位元組相同（cmp 通過） 595 → 651 行；描述裡多了部落格／GitHub 鏡像／n8n／pages deploy 這些觸發詞 ——舊描述那幾個詞**一個都沒有**，所以「我要發一篇部落格文章」那個情境 根本觸發不到它，而那正是 leo 這次要解的問題。 ## 為什麼不是「改成指針」也不是「ISEP 不再自帶」 雲端的 project dir 是**薄殼根**，InkStoneCo 只是它底下的一個目錄 （docs/governance/cloud-wiring.md 記著這件事） ⇒ `InkStoneCo/.claude/skills/` 在雲端**不會被載入**，只有 plugin 這一份會 ⇒ ISEP 不帶全文 ＝ 雲端拿不到 ＝ 又變回「薄殼是真身的子集」， 而那正是這個 repo 成立時要殺掉的病（README 開頭）。 所以 ISEP 必須帶全文，但它是**搬運工不是作者**：內容改在真相源，這裡只放複本。 ## 歸屬不能靠人記得——實查證明兩個方向都會發生 skills/ 與 commands/ 那 9 個檔案在 0.1.0（c263866）從 InkStoneCo 複製過來一次， 之後**再也沒有同步過**（git log 只有那一顆）。到今天已經分家兩個，方向相反： skills/ship-check/SKILL.md InkStoneCo 651 行 ／ ISEP 595 行 ← 那邊新 commands/sdd-check.md ISEP 81 行 ／ InkStoneCo 65 行 ← 這邊新 （InkStoneCo 那份還在教 ISEP#91 已退役的「唯一 active SDD」） ⇒「ISEP 一定比較新」與「InkStoneCo 一定比較新」兩句都是錯的。 這是票上第 4 題「為什麼會有兩份」的答案：不是誰忘了同步， 是**兩份都會被就地編輯**，而沒有任何東西會喊一聲。 ## 所以機制是「寫下來 ＋ 讓機器去比」，而且不新開一支閘 - docs/file-ownership.tsv —— 哪一份是真相源、取自哪顆 commit、當時的 sha256 - 比對長在**既有的信標**上（isep-presence-beacon.sh → hooks/lib/beacon_report.py）： 它的 ② 已經在做「同名而內容不同」這件事，只是**只掃 scripts/**。 這次把 skills／commands／agents 一起納進去（②b）， 再加一格 ②c 用 sha256 單邊驗——**雲端沒有 InkStoneCo 可以比，那是唯一還作數的檢查**。 🔴 刻意不開新閘：ISEP 最常見的錯是重造一支平行的閘 （docs/governance/dispatch-and-reply-format.md §1.6 記著同一課）。 判準是「檔名一樣**而內容不同**」，同步過的不吵——誤攔比漏擋嚴重。 全部只講不擋（SessionStart 本來就不該擋人）。 ## 實跑（這棵樹，真的 InkStoneCo） 🟡 會自動載入的東西兩邊各有一份，而且內容不同： - skills/ship-check/SKILL.md ↔ .claude/skills/ship-check/SKILL.md （真相源＝inkstone/InkStoneCo:… ⇒ 內容改在那裡，改完原樣搬進 ISEP、更新 commit／sha256、升版） - commands/sdd-check.md ↔ .claude/commands/sdd-check.md （真相源＝ISEP 這一份 ⇒ 專案那份是舊複本，同步過去或刪掉它） 兩個方向各講對了自己的出路。 測試：hooks/tests/isep-presence-beacon.test.sh 14 → 26 條，全綠、全離線。 README／docs/hooks-inventory.md／docs/TESTING.md（A18 改 26 條、新增 A29）都跟著改了。 六個數字在這棵樹上實數：61 支閘／84 條註冊／7 位工人／7 支命令／2 支 skill／49 支腳本 ——這次沒有增減，但仍然是數出來的，不是沿用上一版。 （本 commit 也帶著上一顆「逃生門」那件事的兩列文件：hooks-inventory 第 255 列與 TESTING A29。） 🔴 待總管定版：改了會被載入的東西就要升版，否則 plugin update 是 no-op。 🔴 InkStoneCo 那半不是我做的（不同 repo）：那邊的 .claude/skills/ 與 .claude/commands/ 還留著兩份舊複本，該同步或刪掉；在那之前信標會每次開場點名它們。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>總管定版：inkstone/ISEP#122 → comment 6122。三件會改變行為的東西 ⇒ minor 進一格： • ship-check 的「描述」換掉——描述是 skill 自動載入的唯一判準， 舊描述在「要發部落格文章」的情境一個觸發詞都沒有 • 信標多了 ②b／②c（掃 skills／commands／agents；sha256 單邊驗） • history-first-guard.sh 的逃生門從「恆擋」變成真的能放行 順手修掉的一格（同一個病，不同檔案）： .claude-plugin/marketplace.json 的描述停在「51 支閘／64 條註冊／27 支腳本」， 而 plugin.json 是「61／84／49」——同一段描述兩份 manifest 各存一份， marketplace 那份從 7de1ad6（v0.5 前後）之後就沒人動過。 這正是本票在講的病，只是分身這次是同一個 repo 裡的兩個 manifest。 已同步成 plugin.json 那一份，六個數字在這棵樹上實數確認： 61 支閘／84 條註冊／7 位工人／7 支命令／2 支 skill／49 支腳本 🔴 這顆 commit 只是把版本號寫上去。**tag 還沒打**—— plugin.json 說 0.22.0 而最新 tag 是 v0.18.0， `scripts/check-version-consistency.sh` 現在是紅的，要等 v0.22.0 的 tag 打下去才會綠。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>本輪跑迴歸測試時實撞兩次，兩次都把這台機器的磁碟寫滿： $ bash hooks/tests/main-and-prod-push-guard.test.sh "$PWD" REAL="$1" 要的是「那支 hook 的檔案路徑」，我傳了 repo 根目錄 ⇒ hook_sandbox 不驗參數，直接 cp -R "$(dirname "$1")" ⇒ dirname 變成 ~/Documents/tech_projects（上一層） ⇒ 整個 tech_projects（所有 repo、所有 worktree）被搬進 mktemp 實測：第一次 13 GB ＋ 10 GB，第二次 23 GB。 磁碟可用 25 GB → 462 MB，cp 一路吐 "No space left on device"。 兩次都是我手動 rm -rf 才回來的（27 GB）。 🔴 而它印出來的只有一句「❌ 沙盒建不起來」—— 沒說是參數傳錯，也沒說它已經把磁碟寫滿了。 ⇒ 這跟本票在講的是同一句話：**閘/工具給的下一步，沒有人照著打過一次**， 差別只在這次壞的不是逃生門，是「它壞掉時說的話」。 改法（判準是「要求某個東西在場」，不是關鍵字比對）： ① $1 要指到一個真的檔案（空字串、目錄、不存在的路徑都不算） ② 它的上一層目錄名要叫 hooks（沙盒的前提就是複製一整個 hooks/） 任一不成立 ⇒ 在 mktemp 之前 return 1，並印出走得通的那一行。 順手補上 docs/TESTING.md 之前沒寫過的一件事：**有五支測試要傳參數**， 而不傳的後果不是報錯是假綠——prod-write-guard.test.sh 的 HOOK="$1" 空掉時 每一條都執行空指令回 0 ⇒「該擋」全變成「實得 pass」，19 條假紅 （傳對參數：通過 37 ／ 失敗 0）。 測試：hooks/tests/hook-sandbox.test.sh 10 條（A30），通過 10 失敗 0 ①③⑤⑥ 驗的是「收手在複製之前」，不是「訊息好不好看」 ⑧⑨⑩ 驗正常用法沒被弄壞、複本裡沒混進 hooks/ 以外的東西 既有兩支沙盒測試複驗： scripts/test-main-and-prod-push-guard.sh 13/13 hooks/tests/main-and-prod-push-guard.test.sh 通過 10 ／ 失敗 0 hooks/tests/main-and-prod-push-guard-cross-repo.test.sh 通過 19 ／ 失敗 0 📌 這顆跟 0.22.0 的三件事無關，是本輪路上撞到的。要拆票或丟掉這顆都行， 它獨立於前面兩顆，而且只動 hooks/tests/（沒有任何 hook 的執行行為改變）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>