inkstone/ISEP
2
0
Fork 0
Code Issues 18 Pull Requests 1 Actions Packages Projects Releases 22 Wiki Activity
22 Commits 64 Branches 24 Tags
1dfc4e373a058c00ff894b6bd9edad48050ab9b8
Commit Graph

22 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Leo 1dfc4e373a v0.2.1：43 支閘的白話盤點、測試手冊、補上兩個被抓到的洞 
leo 2026-08-20 問「InkStoneCo#40 加入了嗎？如果是這樣我應該可以白話文看到 hooks 的內容？」
答案是不行——43 支閘沒有任何白話清單。這一版補上。

docs/hooks-inventory.md   43 支逐支一行，按「你會在什麼時候撞到它」分 9 組
                          抽驗 5 支逐行核對源碼；順帶抓到 3 支有檔案沒註冊
docs/TESTING.md           A1-A8 + B1-B5，每格都有「怎麼跑/該看到什麼/什麼算失敗」
scripts/test-*.sh         兩支閘的測試，共 21 條，全過

兩個實撞的洞：
- release-tag-guard 的排除清單是前綴比對，x 整條放行
  （A8 那個新 session 抓到的，總管複驗屬實）。改用 #23 驗證過的判準：
  關鍵字要在指令位置才算執行。補 3 條複合指令測試，8/8。
  ⇒ 這是 InkStoneCo#36「包一層就繞過去」的同一個病，發生在同一天新寫的閘上。
- scripts/ticket 寫死只認名叫 gitea 的 remote，在 ISEP（remote 叫 origin）整個跑不起來
  ⇒「開票前先搜」那道閘在新 repo 等於不存在。改成掃所有指向本站的 remote + 環境變數 fallback。

A8 已通過：新 session 裡 plugin 的閘真的觸發（exit 2、tag 未建立、訊息來自 plugin 路徑）。

文件漂移訂正：plugin.json 與 README 寫 42 支/52 條，實際 43 支/53 條。

兩支新閘補上 #40 §1 要求的三行中文檔頭。
🔴 但仍違反 #40 §3「新規則一律先 warn」——兩支都是 block。理由記在 #40 留言，等 leo 裁。
 2026-08-20 17:08:00 +08:00
claude-code bb72b22f10 Merge pull request '開票的側門也封上（Gitea API 直接開票要有搜尋戳記）' (#26) from fix/ticket-api-bypass into main 
開票側門閘
 2026-08-20 08:44:16 +00:00
Leo 2cd3af2764 開票的側門也封上：Gitea API 直接開票要有搜尋戳記 
leo 2026-08-20 問「如何防止」。

規範早就有（leo 2026-08-16「開票前先去搜尋要開在哪裡」），閘也早就有——
但它長在 scripts/ticket 這支工具裡，而總管當天走 API 這條側門，
一口氣開了 12 張與舊票重疊的票，事後全部只能關掉指回舊票。
⇒ 同一個動作有兩條路，只封了一條。

本支封的是動作：Bash 指令只要打到 issues 集合端點且帶 POST，就要有新鮮的搜尋戳記
（與 scripts/ticket 共用 /tmp/.ticket-where-ok，30 分鐘）。

判準刻意簡單：端點 + 一個裸字 POST。原本寫成逐個比對 -X POST／"POST"／req("POST"，
實測第二種就因為跳脫引號逃掉——那正是 leo 08-17 說的「自然語言的變體無限，
blacklist 追不完」。端點已經確定是開票那條，純讀取不會出現 POST，一個字就夠。

實測 13 條：4 種該擋全擋、8 種不該擋（GET／留言／改標籤／關票／scripts\/ticket／
文字提到／grep 自己／撈清單）全放行、有戳記時放行。
 2026-08-20 16:43:49 +08:00
claude-code 2fb18e9f48 Merge pull request '治理 M4.7：降 scope 必須留痕在里程碑描述上' (#25) from leaf/24-descope into main 
治理 M4.7
 2026-08-20 08:33:28 +00:00
Leo aec7f3a980 治理 M4.7：把票移出里程碑必須寫進里程碑描述（closes #24 的規範面） 
leo 2026-08-20 抓到：v0.2.0 顯示 100%，但那是把 #5 移出去之後的 100%，
畫面上看不出降 scope 發生過。

與 §3.4（審核完沒關票 ⇒ 數字偏低）是同一個病的兩面——
畫面上的數字不等於實際狀態，而 leo 只看得到畫面。

禁的不是降 scope（卡人閘時降 scope 是 M4.3 要的），禁的是降得無聲無息。
痕跡要留在他會經過的地方＝里程碑描述，不是票裡、不是對話裡。
 2026-08-20 16:33:08 +08:00
claude-code 34e7c45eb4 Merge pull request 'release: v0.2.0' (#23) from release/v0.2.0 into main 
release v0.2.0 前置
 2026-08-20 06:12:38 +00:00
Leo 500b95d80d release: v0.2.0（版本號、author、描述與實際內容對齊） 
plugin.json / marketplace.json 的 version 與 author 同步；描述改成實際清點的數字
（42 支閘 52 條註冊、7 command、2 skill、25 腳本、治理規範、標籤真相源）。
claude plugin validate 由「1 warning」變成完全通過。

milestone inkstone/ISEP v0.2.0 已 5/5 關閉；#5 因卡在只有 leo 能做的
Cloud environment 設定（#21），照 M4.3 降 scope 移出本版。
 2026-08-20 14:12:34 +08:00
claude-code 7b96f238b6 Merge pull request '雲端載入契約：機制與文件（refs #5，尚未啟用）' (#22) from leaf/5-cloud into main 
審核通過：雲端載入機制（refs #5，成果待 #21）
 2026-08-20 05:42:35 +00:00
Leo 627f924342 docs(cloud): 雲端 session 用 claude plugin marketplace 裝真身 ISEP，不再複製薄殼 
inkstone/ISEP#5 —— 用 code-on-web 的 Setup script（session 啟動前跑）+
claude plugin marketplace add/install 把 ISEP 裝成 user-scope plugin，
內容 100% 來自 ISEP repo HEAD，滿足 docs/governance §11.3 三條硬規則。

本機隔離 $HOME 實測兩輪（token-in-URL、git url.insteadOf 重寫兩種認證寫法皆可行），
skills/commands/hooks 逐條數字對上 ISEP 當時的 main HEAD（含途中 main 前進，
下次 marketplace update 立刻拿到新內容，證明非快照複製）。

明確未驗：真實 code-on-web session、hook runtime 攔截、7 天 environment 快照
新鮮度窗口——皆記在 docs/cloud-session-bootstrap.md「沒驗到的」段。

不動 youlinhsieh/inkstoneco（新機制不需要它）、不 push GitHub、不 push main。
 2026-08-20 13:41:35 +08:00
claude-code 5c3dea6e6c Merge pull request '本機 dogfooding：ISEP 裝成 plugin＋記下兩份閘並存的中間狀態' (#20) from leaf/18-dogfood into main 
審核通過：closes #18
 2026-08-20 05:39:55 +00:00
Leo c5e82c2617 本機 dogfooding：ISEP 已裝成 plugin，並記下「兩份閘都在跑」的中間狀態（closes #18） 
leo 2026-08-20：「你要做的就是這組設定你自己可以 dogfooding」。
實查發現本機根本沒裝 ISEP——repo 做好了但沒人在用它。

已做：claude plugin marketplace add + install，list 看得到 isep@inkstone (enabled)，
details 列出 9 個 skill／5 個 hook 事件／always-on ~410 tok。

刻意沒做：拆掉 InkStoneCo/.claude 那份。兩者逐支比對過是等價的（新的只多
release-tag-guard.sh），但 plugin 的 hook 是啟動時載入，這個 session 驗不到它會觸發。
沒驗到就拆，最壞情況是下個 session 零個閘。退場步驟開在 #19。
 2026-08-20 13:39:39 +08:00
claude-code 065bb8f729 Merge pull request '版本只存在於 release：README 去版本宣稱＋一致性腳本＋打 tag 閘' (#10) from leaf/6-release into main 
審核通過：closes #6
 2026-08-20 05:10:16 +00:00
Leo e4e3d69acf fix(release): 版本只有 Gitea Releases 答得出來，不再靠 README 自報（inkstone/ISEP#6） 
現況：README.md 宣稱「狀態 0.1.0」，但 repo release_counter=0、一個 tag
都沒打。leo 當場指出這是違規，命中規範自己的 E12（宣稱交付但沒有 tag）；
leo 補充：「release 不是寫在 readme，要放在 release 裡」。

改法（結構性防漂移，不是靠人記得同步）：
- README.md 不再自行宣告版本號，改成指向 Gitea Releases 頁面
- .claude-plugin/plugin.json 的 version 改回哨兵值 0.0.0
  （=誠實承認目前沒有一個經過驗證、掛在 Releases 上的版本；
  真正打 tag 那天才跟 tag 一起同步成那個號碼）
- 新增 scripts/check-version-consistency.sh：隨時可跑的一致性檢查
  （plugin.json version 是否等於最新 tag／README 是否偷偷自報版本）
- 新增 hooks/release-tag-guard.sh：PreToolUse Bash 閘，在真正打 git tag
  的那一刻擋下與 plugin.json 不一致的版本號，註冊進 hooks.json

紅線：本次不打 tag、不建 release——那是總管驗過整個 milestone 之後的動作，
這裡交的是機制與草稿。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
 2026-08-20 13:10:00 +08:00
claude-code ff705c2313 Merge pull request 'labels.yaml 唯一真相源 ＋ 冪等同步腳本 ＋ 14 repo 全部對齊' (#9) from leaf/4-labels into main 
審核通過：closes #4
 2026-08-20 05:08:05 +00:00
claude-code d238b72882 Merge pull request 'ISEP 自己的 wiki 骨架' (#8) from leaf/3-wiki into main 
審核通過：closes #3
 2026-08-20 05:08:02 +00:00
claude-code 4a8f3093da Merge pull request '治理規範進 docs/：原稿存檔＋修訂版 v0.6.0＋分歧書' (#7) from leaf/2-docs into main 
審核通過：closes #2
 2026-08-20 05:08:00 +00:00
Leo 09979b2357 自我審核修訂：ISEP 的人閘放在 release 不放在每個 PR 
原本寫『ISEP 自身的修改 PR 必經人閘』——照字面走每個 PR 都要 leo 點頭，
他就變成瓶頸（違北極星 §1）。但完全拿掉，代理就能悄悄放寬管自己的規則。

改成：總管可 merge（loop 不停），但每個 release note 必須逐條列出這一版
改了哪些治理規則與哪些閘，release 就是那道人閘。
＝把同步的逐 PR 審批改成非同步的逐版本審批。
 2026-08-20 13:04:29 +08:00
Leo 3b763c829c 審核修訂：wiki 不再自行宣稱版本號（違治理 M4.6，版本只存在於 release） 2026-08-20 13:03:27 +08:00
Leo 54e479900a 新增標籤唯一真相源 + 冪等同步腳本，全 org 14 個 repo 對齊（inkstone/ISEP#4） 
labels.yaml：23 個標籤定義（名稱／顏色／描述／exclusive），已是 ISEP repo 現行實況。
scripts/gitea-labels-sync.sh：讀 labels.yaml 對齊任一/全部受治理 repo——
缺的建、改的還原（僅 color/description/exclusive，不改名）、多出來的只告警不刪，
兩次連跑第二次必為 no-op（已實測 0 created/0 updated）。

實跑對帳：14 個 repo 首跑 253 created + 46 updated；重跑 0/0（冪等）；
InkStoneCo / Arcrun / content-pipeline 三個抽查點逐欄核對與 labels.yaml 完全一致；
arcrun-rag 留有 6 個 Gitea 預設英文標籤（bug/enhancement/help wanted/invalid/question/wontfix），
按規約只告警不刪。
 2026-08-20 13:03:12 +08:00
Leo 50876ffa4f 治理規範進 docs/：claude.ai 原稿存檔＋總管修訂版 v0.6.0＋逐條分歧書 
leo 交辦：把 claude.ai 寫的治理規範整理進 ISEP，並且「查看是否合理，提出意見⋯⋯
改一版你的版本」。原稿作者看不到 codebase，標籤名／hook 名／既有鐵律有實錯。

三份文件：
- _draft-claude-ai-v0.5.0.md  原稿，一字未改，加存檔標頭
- sdd-gitea-governance.md     v0.6.0 現行版
- DIVERGENCE-v0.5.0-to-v0.6.0.md  我改了哪 14 處、為什麼

修訂重點（實查 2026-08-20 的現場，不是推測）：
- 標籤名幾乎全是憑空的：gate/human・s/review・close/*・hub・type/* 現場一個都不存在。
  Human 不改名（leo 08-17 才改過，改名會廢掉他的看板習慣），另加 human/exec 當第二維度。
- 狀態機三態擴成七態：原稿會擠掉 s/triage・s/backlog・s/pending・s/stage，
  而那四個態上掛著 179 張 open 票。s/review 與 s/stage 是兩件事，不可互相取代。
- E1–E16 的 hook 全是憑空命名，改成標註「已有 <實際檔名> / 待建」——
  E14 其實已經有了（subagent-claim-worksheet.sh），重造就是第 42 支互相打架的閘。
- 刪掉「薄殼只裝 shell-safe 子集」：那是舊薄殼模型的殘留，正是 InkStoneCo#57 的成因，
  而且與原稿自己的 P11.2.1/P11.2.4 自相矛盾。
- 排程 job 第一版一律不依賴 Gitea Actions runner（有沒有 runner 未經查證，
  依賴不確定存在的東西，壞掉的形式是「以為有人在跑」）。
- 補上原稿整份沒有的「載入契約」一節——那正是 leo 需求 3 的核心，也是 InkStoneCo#14 的根因。
- 補上 M4.6：release note 寫在 release 裡不寫 README（leo 2026-08-20 當場指正）。
- 補上 §3.4 總管收工義務：審核通過的當下就關票（leo 2026-08-20 指出上次 milestone 0% 的病）。

兩個裁決題已按判斷先做、理由寫在 DIVERGENCE §E，leo 可打回：
PR-only 只套 ISEP 不套全部 repo；舊的 duplicate 標籤封存不刪。
 2026-08-20 13:02:28 +08:00
Leo 45bf7b4a52 ISEP #3：裝一套自己的 wiki，接手 session 不必回頭翻 InkStoneCo 
骨架照 inkstone/system-dev-template 的 wiki template 裝（三層＋標籤橫切：
INDEX/TAXONOMY/status/mistakes/principles + cards/<bucket>/），不自創格式。

內容只記 ISEP 自己的事：
- 真身薄殼合一（為什麼環境設定收斂成一個 plugin）
- hook 路徑規約（${CLAUDE_PLUGIN_ROOT} vs $CLAUDE_PROJECT_DIR）
- repo 邊界與紅線（wiki 是這條紅線目前唯一開的例外，且例外本身也劃了邊界）

不複製 InkStoneCo 頂層 wiki 的任何內容——複製即 fork，fork 即漂移。

實測：hooks/session-start-recall.sh 以 ISEP 為 cwd 執行，exit 0，principles/mistakes
兩段真的印出剛寫的內容；wiki-secret-scan.sh 對全部新檔案掃過，exit 0；
wiki-recall/update/capture 三支 command 描述的路徑全部存在。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-20 13:00:36 +08:00
Leo c2638668e3 ISEP 0.1.0：環境設定收成一個 plugin，本機與雲端共用一份 
leo 2026-08-20：「同一個 plugin 你用，薄殼也用，保證兩邊同步」
              「我要你幫雲端做薄殼，永遠都有問題，你要做的就是這組設定
                你自己可以 dogfooding」

搬進來：41 支 hook（51 條註冊）／7 支 command／2 支 skill／23 支腳本。
不搬 .env、wiki、docs——那些是知識不是環境。

51 條 hook 路徑全部從 $CLAUDE_PROJECT_DIR/.claude/hooks/ 改成 ${CLAUDE_PLUGIN_ROOT}/hooks/，
零漏網。那正是薄殼一直壞掉的根：雲端 cwd 不是真身，寫死路徑就斷。

尚未驗證：Claude Code 能不能從私有 Gitea repo 裝 marketplace（要憑證）。
下一步就是在本機實際裝一次，通了才動雲端 bootstrap.sh。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-20 11:41:46 +08:00