isep-hand
7cacfdcf11
leo 2026-09-07：「一個 repo 只看得到一個資料夾」「禁止這樣產出一大堆資料夾」。 根因：line-needs-own-worktree.sh 教工人開在 repo 旁邊，「收工 remove」只寫在閘訊息裡、沒機制驗， 每條線留一份 ⇒ tech_projects/ 長出 ISEP-wt-117／InkStoneCo-wt-112…一排。規則在文字裡不在機器上。 - scripts/worktree（新）：open／close／list／sweep 四個動詞。分身住 <repo>/.worktrees/<票 repo>-<N> （走 .git/info/exclude，不動被追蹤的檔）；「推了沒」只有這一份判準（三態：有／沒有／問不到， 問不到不當成沒推也不收）；sweep 預設只列不動，--apply 只收「推了且乾淨」，--skip 是操作者點名。 - hooks/line-needs-own-worktree.sh：擋下時印 `scripts/worktree open`（絕對路徑，貼了就跑）； 同一支多掛 PostToolUse Agent|Task——從【工單】認出分身，推了收、沒推點名分支＋路徑（exit 2）， 不 force、不刪。+0 支、+1 條（61 支／86 條，當場數的）。 - docs/governance/worktree-placement.md（新）＋ principles 一行：禁令與閘互指。 - 測試：line-needs-own-worktree.test.sh 77→110（G 群：閘印的 open 那行原樣跑、旁邊不多任何東西； H 群：PostToolUse 推了收／沒推點名／安靜的方向）；scripts/test-worktree.sh 42 條（七個分身的 fixture， 名字照 leo 看到的那排）。舊閘跑新測試 90/110，紅的 20 條正是這次改到的行為。 - permissions-allow.json 加 worktree 四種形狀（出路在雲端被分類器擋就走不通）。 - README／plugin.json／hooks-inventory 的數字在這棵樹上實數：61 支、86 條、62 支腳本。 待總管定版（改了會被載入的東西）。沒碰 hooks/lib/mainline.py。 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0178ef1fGw3XeZtpN7LaZrm4
9 lines
1.2 KiB
Markdown
9 lines
1.2 KiB
Markdown
# 設計原則（行動前必服從，全文注入，一行一條）
|
||
|
||
- 只改 ISEP，不改 `InkStoneCo/.claude/hooks/`（那個目錄退場中）；改完兩邊各自 `/plugin update`。
|
||
- hook 指自己一律用 `${CLAUDE_PLUGIN_ROOT}`，不寫死絕對路徑；指專案內檔案（wiki／docs）才用 `$CLAUDE_PROJECT_DIR`。
|
||
- 本 repo 不放 `.env`／任何金鑰真身（D36「金鑰只有一個家」）；也不放 `_archive/`。
|
||
- ISEP 的 wiki 只記 ISEP 自己的事，不複製 InkStoneCo 的 wiki 內容（複製即 fork，fork 即漂移）。
|
||
- 環境（hooks／commands／skills／scripts）與知識（wiki／docs）雖然裝在同一個 repo，改動理由不同——環境變更要同步本機＋雲端兩份，知識變更只影響這個 repo 自己被讀到什麼。
|
||
- 一個 repo 在檔案系統上只有一個資料夾：一條線的分身（git worktree）住 `<repo>/.worktrees/`，禁止在專案目錄旁邊產出 `<repo>-wt-…`／`<repo>-ticket…` 這類同頭不同尾的資料夾；開用 `scripts/worktree open`、收工 `scripts/worktree close`，忘了收的由 `line-needs-own-worktree.sh`（PostToolUse）替你收（規約 `docs/governance/worktree-placement.md`，inkstone/ISEP#147）。
|