ISEP/docs/governance/DIVERGENCE-v0.5.0-to-v0.6.0.md

我改了 claude.ai 那版的哪些地方，為什麼

leo 2026-08-20 交辦：「你查看是否合理，提出意見，因為這個是計劃， 有些已經有、有些還沒有、有些有了不符合⋯⋯則你要改一版你的版本。」

本檔是我的意見書。原稿存檔在 _draft-claude-ai-v0.5.0.md， 修訂後的現行規範是 sdd-gitea-governance.md（v0.6.0）。

---

先講結論

• 骨架是對的，照單全收
  • 物件模型（SDD → tracking → leaf → PR → release，milestone 橫切當 time 軸）
  • 「封路優於守規」這條公理——它跟你 08-17 那句「封的是動作，不是文字」是同一件事
  • 「人是特殊 executor」把 gate/human（審核者）與 exec/human（執行者）拆開
    • 🔴 這是原稿最有價值的一條。現行的 Human 標籤把兩件事混在一起： 「你來按放行」跟「這件事只有你的手能做」——前者你可以晚點按， 後者你不按整條線就停在那。混在一起你看不出哪張真的在擋路。
  • 時態分工（SDD 未來式／Gitea 現在式／Wiki 過去式）
• 有 14 處對不上現場，我改了。下面逐條。
• 有 2 處是你的裁決題，我先按我的判斷做了，理由寫在票上，你覺得不對就打回。

---

A. 事實錯誤（原稿寫的東西，現場不存在或不長那樣）

A1. 標籤名幾乎全是憑空的

• 我實查（2026-08-20）：inkstone/ISEP 當時 0 個標籤；inkstone/InkStoneCo 有 10 個
  • 現有：Human duplicate p/high p/low s/backlog s/doing s/pending s/stage s/todo s/triage
  • 原稿要的 gate/human s/review close/* hub type/*——一個都不存在
• 為什麼會這樣：claude.ai 看不到 codebase 也連不上 Gitea，標籤名只能用猜的。這不是它的錯，是那個 surface 的限制。
• 我怎麼改：把標籤集寫成 labels.yaml 當唯一真相源，並且先建出來再說——ISEP 已經實建 23 個並驗證存在。名字取捨見 A2–A4。

A2. gate/human → 不改名，維持 Human

• 你 08-17 才把 s/leo 改名成 Human，而且明講它是正交維度不是流程狀態， 你自己是靠 Gitea 原生「指派給您的」＋這個標籤在看跨 repo 的待辦。
• 改名成 gate/human 會做兩件壞事：既有票全部要重貼標籤；你現在的看板習慣當場失效。
• 我怎麼改：Human 原封不動（語意＝你是審核者）。另外新增 human/exec 表示「這張票的執行者是人」。兩者可以疊，也可以只有其一。

A3. 狀態機只有三態，會把現場四個態擠掉

• 原稿：s/todo → s/doing → s/review → closed。
• 現場正在用的還有 s/triage（還沒驗傷）、s/backlog（要做但沒排 sprint）、 s/pending（卡在外部）、s/stage（已上 stage 等你驗）。 三個 repo 加起來 179 張 open 票掛在這些態上。
• 我怎麼改：狀態機擴成七態，原稿的三態是其中的主幹道。

A4. s/review 和 s/stage 是兩件事，原稿把它們當成一件

• s/review ＝ PR 開了，等總管 merge（程式碼還沒進 main）
• s/stage ＝ 已經部署到 stage，等 leo 實際打開來驗（程式碼早進 main 了）
• 原稿只有前者，等於把「等你驗收」這個態砍掉——那正是你唯一會看的那個態。
• 我怎麼改：兩個都留，並在狀態機裡標明先後。

A5. E1–E16 的 hook 全是憑空命名，現場有 41 支真的

• 原稿的封路清單只寫「用什麼封」，沒有一個對得上真檔名。
• 實際對照（我逐支比對過檔名，不是猜的）：

原稿	現場有沒有	對應到哪支
E1 直接 push 預設分支	◐ 有但語意相反	main-and-prod-push-guard.sh（擋 subagent，放行總管）
E6 代理越過人閘	◐ 部分	irreversible-dispatch-guard.sh／prod-write-guard.sh
E11 地端雲端漂移	◐ 管的是別的	skill-deploy-drift-guard.sh（管 skill，不管 manifest）
E12 宣稱交付但票未關	◐ 部分	delivery-police.sh／claim-verify-police.sh
E14 subagent 空口宣稱	✅ 已經有了	subagent-claim-worksheet.sh＋empty-handed-stop-guard.sh
E2 E3 E4 E5 E7 E8 E9 E10 E13 E15 E16	❌ 沒有	—

• 我怎麼改：修訂版的封路清單一律標「現況：已有 <檔名> ／ 待建」， 已有的不重造（重造就是第 42 支互相打架的閘）。

A6. §11.1 的目錄結構與實際 repo 不符

• 原稿畫的是 governance-plugin/，實際 repo 叫 ISEP。
• 原稿沒提到的、實際存在的：commands/（7 支）、skills/（2 支）、scripts/（23 支）。
• 原稿列的、實際不存在的：labels.yaml、templates/、jobs/、manifest.json。
• 🔴 順手抓到的髒東西：scripts/install.sh 其實是 system-dev-template 的安裝器 （內容在裝 wiki／SDD，跟 plugin 無關），搬家時混進來的。修訂版標明它是待清理項。

A7. §11.4.4 叫 install.sh 去 systemctl restart gitea

• 我沒有查證 Gitea 跑在哪台、是不是 docker、我有沒有那台的 shell。所以我不知道這行能不能跑。
• 但更根本的問題：原稿自己在 §11.4.3 說「模板通道壞掉不影響治理正確性」—— 既然如此，就不該為它在安裝腳本裡放一個會失敗、會嚇人、還可能重啟到別人東西的動作。
• 我怎麼改：模板通道降級成 optional 的獨立腳本，不掛在 install 流程上。

A8. Telegram「小六 bot 通道」

• 原稿直接寫了通道名。我沒有核實過那是不是現役通道名，所以修訂版不寫死通道名， 改成指向 wiki/agent-memory.md 的通知通道段（真相源在那裡，這裡只放指針）。

---

B. 與你既有鐵律直接打架的（照原稿走，第一天就會違規）

B1. §11.2.5「薄殼只裝 manifest 標記 shell-safe 的子集」— 🔴 這條我整條刪掉

• 這是舊薄殼模型的殘留，而且它會把你剛拆掉的病裝回去。
• 你 08-20 的原話是「同一個 plugin 你用，薄殼也用，保證兩邊同步」。 「只裝子集」＝ 兩邊不一樣 ＝ 就是 InkStoneCo#57（薄殼少 7 支閘）那張票的成因本身。
• 原稿其他地方（P11.2.1「安裝同一個 release」、P11.2.4「整包替換禁止 cherry-pick」） 跟這條自相矛盾——它自己也知道不該有子集。
• 我怎麼改：刪除，並在修訂版明文寫「沒有子集，只有同一份」。

B2. §12.1 說 SDD 的寫入者是「人」、代理僅提案

• 現況相反：SDD 幾乎都是 AI 寫的，你是審的那個。照字面走，第一天就全面違規。
• 我怎麼改：改成「代理可寫，但範圍／驗收／非目標的變更必經人閘」—— 管的是哪些欄位需要你點頭，不是誰握筆。

B3. E9 留言 ≤600 字元、同票同 session >3 則就 reject

• 這條的方向是對的（推理進 wiki，留言只帶指標），但數字太緊，而且它懲罰誠實。
• 你 08-17 自己的診斷：文字層的閘那天 8 次誤攔、0 次正確攔截， 而且「紅線寫得越細，命中關鍵字的機率越高 ⇒ 那些閘在懲罰謹慎」。
• 我怎麼改：超長不 reject，改成擋下來並要求把長內容移去 wiki 再留指標； 則數上限拿掉（改用「同一張票同一 session 第 4 則起要先讀前 3 則」的提示，不是硬擋）。

B4. E13「s/review 佇列非空即 block 總管 stop」

• 這條會讓總管永遠停不下來：你在上課、沒人 merge，佇列就一直非空。
• 而且它跟現有的 empty-handed-stop-guard.sh（判準是「這回合有沒有 tool call」）疊在一起，兩支會互相踩。
• 我怎麼改：判準改成「有我自己開的 s/review，而這一回合我完全沒碰它」才擋—— 擋的是遺忘，不是擋等待。

B5. M4.3「Timebox 不可延長，到期強制關 milestone、搬票、打 tag」

• 對你的作息（上課日只有中午晚上各看一眼）這條會製造假交付： scope 縮到剩一張票也照樣打 tag，那個 tag 打開來沒東西。
• 而且它依賴排程 job，而我不確定有沒有 runner（見 C1）。
• 我怎麼改：到期不自動關、不自動打 tag，改成強制做一次「降 scope 對帳」並通知你； 打 tag 永遠是「驗過了」才發生的動作。

---

C. 技術可行性我實查過的

C1. 排程 job（E5／E8／E16／stale／digest）需要 Gitea Actions runner — 我還沒查有沒有

• 誠實標記：這格我沒驗。 我不知道這台 Gitea 有沒有掛 runner。
• 另外你的 D20 紅線「禁排程輪詢」管的是 GitHub（自架 Gitea 不受 flag 影響）， 所以規則上不衝突，但能不能跑是另一回事。
• 我怎麼改：第一版所有 job 都做成 scripts/ 底下可手動跑、也可由 SessionStart hook 順手跑的東西， 不依賴 runner。等確認有 runner 再升級成排程。這樣壞掉的成本是「沒人跑」，不是「以為有人跑」。

C2. Gitea 1.26.4 支援 label exclusive — ✅ 查證過，可用

• 所以原稿 P11.4.5「s/* 與 close/* 一律 exclusive，非法狀態不可表示」成立，我照做了。
• 現有 10 個標籤全部 exclusive: false，這次會被改成 true。

C3. Gitea 有 issue dependency API — ✅ 查證過（/issues/{index}/dependencies）

• 所以 R2.5「順序關係用原生 dependency」可行。

C4. Gitea 沒有跨 repo 搬 issue 的 API — ❌ 查證過

• 只有 repo transfer，沒有 issue transfer。
• 影響：InkStoneCo#40（forge-discipline 母規格）、#57、#14 搬不到 ISEP。
• 我怎麼改：不搬，用互鏈。ISEP 的 hub 票 #1 指回那三張。

---

D. 原稿沒寫、但非有不可的（你的需求 1–3 的核心）

D1. plugin 到底怎麼被載入 — 原稿整份沒提

• 你的需求是「雲端每次執行拉 github.com/youlinhsieh/inkstoneco， CC plugin 要把 loading 需要的放進去」。
• 原稿 §11 講的是「分發」（release、manifest、checksum）， 完全沒講 Claude Code 這個 host 怎麼發現並掛載這個 plugin。
• 而這正是 InkStoneCo#14 那張票的病根：Claude Code 只在 session 啟動當下讀一次 cwd 的 .claude/。
• 我怎麼改：修訂版加一節「載入契約」，並且這件事另立 ISEP#5 專票去做實測。

D2. 版本號的一致性沒有任何機制

• 原稿 §9 說「plugin 版本 = 規範版本」，但沒說怎麼保證。
• 而今天就出事了：README 宣稱 0.1.0、plugin.json 寫 0.1.0、Gitea 上 release 數 = 0。
• 我怎麼改：修訂版把 E12 改寫成「版本三處一致」的閘（plugin.json ／ tag ／ release 存在）， 並把「release note 寫在 release 裡、不寫 README」寫進規範（你 08-20 的原話）。另立 ISEP#6。

D3. ISEP 是 private repo，雲端拿不到就什麼都不用談

• 原稿沒提憑證。這是整條線最可能默默失敗的一格。
• 修訂版寫進「載入契約」，實作走既有 credential 機制（D36：只拿名字不碰值）。

---

E. 兩個裁決題（我先按自己的判斷做了，你打回我就改）

E1. E1「PR-only，禁止直接 push 預設分支」要不要套到所有 repo？

• 衝突點：你的 CLAUDE.md 明寫「總管推 main 自己裁（但要逐筆看過那些 commit）」， 原稿要求全部走 PR。兩者不能同時成立。
• 我的判斷：只有 ISEP 這個 repo 走 PR-only，其他 repo 維持現行。
  • 理由：ISEP 是所有環境的唯一真相源，它壞掉是所有 session 一起壞—— 這個 repo 值得多一道摩擦。其他 repo 壞掉只影響自己。
  • 一刀切到 14 個 repo 會在你最忙的時候把整條線卡在「等總管開 PR」。
• 這題命中四題公式的「跨專案結構」，所以我標成裁決題寫在這裡； 但照你 08-17 的規矩（不確定 → 假設 → 記錄 → 繼續走），我不停下來等。

E2. 現有 duplicate 標籤要不要被 close/duplicate 取代？

• 我的判斷：新的照建，舊的不刪只封存（is_archived）。
• 理由：刪標籤會把它從所有歷史票上摘掉——那是不可逆的，而且會讓舊票的關閉理由憑空消失。

---

附：我沒動的東西（原稿寫得比我好的）

• §1 物件模型的那張圖與職責表——直接沿用
• §5 關閉分類 taxonomy（七種 close/*）——名稱與語意全部沿用
• §7 討論路由的那棵決策樹——沿用
• §10.1「OP 是票的唯一狀態容器，留言是 append-only 的 delta」——沿用，這條解掉了「一張票要讀 40 則留言才知道現況」
• §12.4 單向依賴（Wiki 壞不影響 Gitea，Gitea 壞不影響 SDD，通知丟不影響一切）——沿用