Merge pull request '新增 WP-01 十項定案規格與 TODO.md 校正清單文件' (#79) from docs/wp01-baseline-decisions/delivery-spec into docs/wp01-baseline-decisions/main

Reviewed-on: #79

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc-meta",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "技能組自我管理：新建、更新、刪除技能與技能準則",
   "skills": "./skills",
   "author": {

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc-meta",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "技能組自我管理：新建、更新、刪除技能與技能準則",
   "skills": "./skills",
   "jsc": {

plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc-meta",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "技能組自我管理：新建、更新、刪除技能與技能準則",
   "skills": "./skills/",
   "jsc": {

references/behaviors.md

@@ -7,10 +7,10 @@
 | 項目 | 內容 |
 | --- | --- |
 | 觸發時機 | 手上沒有異動需求，要對整組技能做例行或臨時稽核時用。帶著異動需求要改多支技能走 skillset-update、只改一支走 skill-update |
-| 關鍵步驟 | 先跑 sync-domains.sh 同步全部 domain 存取庫、再平行跑三組審查（第一組平行跑腳本檢查、frontmatter 檢查、行為清單檢查、語言檢查、連結寫法檢查、wiki 規則檢查、頁名樣式檢查、委派清單檢查與 hook smoke，其中委派清單檢查跑 check-delegate.sh 整輪一次、不逐 domain 跑，退出 0 時 stdout 上的 seed 與版本落後只是提示、不算不合規，退出 1 的缺列多列空欄、死掉的 next 與填錯的 probe 逐項當不合規報，退出 3 記成「無委派清單可查」也不算通過，第二組以 sub agent 逐 domain 對 guidelines 檢查清單稽核，第三組先用 wiki-repo SKILLSET 與 hash-id 讀回各 domain SKILLSET_{HASH} 上已決議的優化建議再以 sub agent 分六個面向審查流程與成本；讀取回 7、8 或存取庫解不出來時只停掉該 domain 的第三組，第一組、第二組與後續步驟照跑）、合併三組結果並用決策樹逐項確認（第二組留白的九項由第一組的結論補上，其中頁名樣式與 wiki 規則兩項是整輪一份，同一個結論填進每個 domain；委派清單檢查不是檢查清單那九項之一，整輪自成一條結論，只有它的不合規進決策樹、提示不進；優化建議記下決議與決議日期）、以平行 sub agent 套用確認過的修正並跑 sync-skill-manifest.sh、由主 agent 自己改 delegate-spec.tsv 補上或刪掉判定列（缺列先用 delegate-criteria.md 的決策樹問過再寫，origin 記 judged，填錯的 probe 回該技能的存取庫核對過再改寫，切不出唯讀入口就寫成 pending；那個檔整組技能共用一份，交給平行 sub agent 寫會互相蓋掉）、跑 sync-marketplace.sh 同步兩份正本 marketplace、重跑三組驗證直到接受的修正全通過、每個受影響存取庫各開一條 PR、最後以平行 sub agent 逐 domain 把本輪稽核結果附加到 SKILLSET_{HASH}，再取 wiki-url 的絕對網址、把頁上與列上的每個連結交給 link-check.sh 驗證、退出 0 才用 wiki-contents.sh upsert SKILLSET 2 "SKILLSET_{HASH}" 把自己那一個 H2 區塊寫進 CONTENTS 存取庫的 SKILLSET_CONTENTS（目錄頁一律大標題加條列，鍵是 H2 標題也就是內容頁頁名，第四個參數是區塊檔），最後呼叫 jsc-hooks/tools/report-status.sh skill-end jsc-meta:skill-check 寫一筆收尾事件（五種 status 依本輪實際結果選，中途停下的輪次也要寫；腳本不在就安靜跳過，不影響本輪結局） |
+| 關鍵步驟 | 先跑 sync-domains.sh 同步全部 domain 存取庫、再平行跑三組審查（第一組平行跑腳本檢查、frontmatter 檢查、行為清單檢查、語言檢查、連結寫法檢查、腳本路徑檢查、wiki 規則檢查、頁名樣式檢查、委派清單檢查與 hook smoke，其中委派清單檢查跑 check-delegate.sh 整輪一次、不逐 domain 跑，退出 0 時 stdout 上的 seed 與版本落後只是提示、不算不合規，退出 1 的缺列多列空欄、死掉的 next 與填錯的 probe 逐項當不合規報，退出 3 記成「無委派清單可查」也不算通過，第二組以 sub agent 逐 domain 對 guidelines 檢查清單稽核，第三組先用 wiki-repo SKILLSET 與 hash-id 讀回各 domain SKILLSET_{HASH} 上已決議的優化建議再以 sub agent 分六個面向審查流程與成本；讀取回 7、8 或存取庫解不出來時只停掉該 domain 的第三組，第一組、第二組與後續步驟照跑）、合併三組結果並用決策樹逐項確認（第二組留白的九項由第一組的結論補上，其中頁名樣式與 wiki 規則兩項是整輪一份，同一個結論填進每個 domain；委派清單檢查不是檢查清單那九項之一，整輪自成一條結論，只有它的不合規進決策樹、提示不進；優化建議記下決議與決議日期）、以平行 sub agent 套用確認過的修正並跑 sync-skill-manifest.sh、由主 agent 自己改 delegate-spec.tsv 補上或刪掉判定列（缺列先用 delegate-criteria.md 的決策樹問過再寫，origin 記 judged，填錯的 probe 回該技能的存取庫核對過再改寫，切不出唯讀入口就寫成 pending；那個檔整組技能共用一份，交給平行 sub agent 寫會互相蓋掉）、跑 sync-marketplace.sh 同步兩份正本 marketplace、重跑三組驗證直到接受的修正全通過、每個受影響存取庫各開一條 PR、最後以平行 sub agent 逐 domain 把本輪稽核結果附加到 SKILLSET_{HASH}，再取 wiki-url 的絕對網址、把頁上與列上的每個連結交給 link-check.sh 驗證、退出 0 才用 wiki-contents.sh upsert SKILLSET 2 "SKILLSET_{HASH}" 把自己那一個 H2 區塊寫進 CONTENTS 存取庫的 SKILLSET_CONTENTS（目錄頁一律大標題加條列，鍵是 H2 標題也就是內容頁頁名，第四個參數是區塊檔），最後呼叫 jsc-hooks/tools/report-status.sh skill-end jsc-meta:skill-check 寫一筆收尾事件（五種 status 依本輪實際結果選，中途停下的輪次也要寫；腳本不在就安靜跳過，不影響本輪結局） |
-| 外部呼叫 | tools/sync-domains.sh、jsc-hooks/tools/report-status.sh skill-end、tools/lint-scripts.sh、tools/lint-frontmatter.sh、tools/check-behaviors.sh、tools/ste100-lint.sh、tools/check-link-format.sh、tools/check-page-name.sh、tools/check-delegate.sh、tools/sync-skill-manifest.sh、tools/sync-marketplace.sh、jsc-gitea/tools/check-wiki-rules.sh、jsc-gitea/tools/link-check.sh、jsc-gitea/tools/gitea.sh 的 wiki-repo、hash-id 與 wiki-url、jsc-gitea/tools/wiki-contents.sh upsert（目錄頁自己那個區塊）、jsc-cli/tools/detect-clis.sh、jsc-hooks/tools/wire-cli.sh smoke、jsc-ask:ask、jsc-git:pr、jsc-gitea:wiki、templates/skillset-page.md、templates/skillset-contents.md |
+| 外部呼叫 | tools/sync-domains.sh、jsc-hooks/tools/report-status.sh skill-end、tools/lint-scripts.sh、tools/lint-frontmatter.sh、tools/check-behaviors.sh、tools/ste100-lint.sh、tools/check-link-format.sh、tools/check-skill-paths.sh、tools/check-page-name.sh、tools/check-delegate.sh、tools/sync-skill-manifest.sh、tools/sync-marketplace.sh、jsc-gitea/tools/check-wiki-rules.sh、jsc-gitea/tools/link-check.sh、jsc-gitea/tools/gitea.sh 的 wiki-repo、hash-id 與 wiki-url、jsc-gitea/tools/wiki-contents.sh upsert（目錄頁自己那個區塊）、jsc-cli/tools/detect-clis.sh、jsc-hooks/tools/wire-cli.sh smoke、jsc-ask:ask、jsc-git:pr、jsc-gitea:wiki、templates/skillset-page.md、templates/skillset-contents.md |
 | 完成條件 | 每個 domain 都有腳本檢查、frontmatter 檢查、行為清單檢查、語言檢查與連結寫法檢查的結論（連結寫法檢查退出 3 是「什麼都沒掃」，不算通過），wiki 規則檢查、頁名樣式檢查與委派清單檢查各有一次結論（frontmatter 檢查退出 3 是「什麼都沒掃」、頁名樣式檢查退出 3 是「什麼都沒查」、委派清單檢查退出 3 是「無委派清單可查」，都不算通過；委派清單檢查退出 0 時的提示要與不合規分開記）、每個 domain 的檢查清單在合併後補齊且那兩項整輪一份的結論在每個 domain 都填上同一個值、讀不到已決議清單的 domain 記成「本輪未取得已決議清單，優化建議暫不提出」、每項不合規與每項優化建議都有決策紀錄且優化建議帶決議日期、接受的修正重驗通過、每個受影響存取庫都拿到 PR 網址、寫進 wiki 的每個連結都先經 link-check.sh 退出 0、每個受影響 domain 的 wiki 頁都寫成功，或列為未寫入並附完整內容、本輪的 skill-end 事件已寫入，或據實記成腳本不在這台機器上 |
-| 可驗證跡象 | $JSC_HOME/usage/events.jsonl 多一行 kind=skill、phase=end、name=jsc-meta:skill-check 的 skill-end 事件（本輪唯一必留的跡象，腳本不在時才沒有）、受影響存取庫留下檔案改動、改到行為的技能連帶改寫該存取庫的 references/behaviors.md、每個 domain 的 lint-frontmatter.sh、ste100-lint.sh 與 check-link-format.sh 退出 0、check-page-name.sh 退出 0、check-delegate.sh 退出 0、本輪修過的判定列留在 plugins/meta 的 tools/delegate-spec.tsv、README 的「Skills 目錄」重寫、三份 manifest 版本號提升、兩份 marketplace 檔逐位元一致、每個受影響存取庫一條 PR、每個受影響 domain 的 SKILLSET_{HASH} 各附加一節，並由 wiki-contents.sh upsert 退出 0 在 SKILLSET_CONTENTS 留下自己那一個 `## SKILLSET_{HASH}` 區塊、區塊裡以 `- 異動頁：[SKILLSET_{HASH}]({連結})` 的絕對網址指向該內容頁；本輪無 domain 被改動時，改成 plugins/meta 那一頁記「本輪無發現」 |
+| 可驗證跡象 | $JSC_HOME/usage/events.jsonl 多一行 kind=skill、phase=end、name=jsc-meta:skill-check 的 skill-end 事件（本輪唯一必留的跡象，腳本不在時才沒有）、受影響存取庫留下檔案改動、改到行為的技能連帶改寫該存取庫的 references/behaviors.md、每個 domain 的 lint-frontmatter.sh、ste100-lint.sh 與 check-link-format.sh 退出 0、check-skill-paths.sh 退出 0（unrooted 與 unknown 只是提示）、check-page-name.sh 退出 0、check-delegate.sh 退出 0、本輪修過的判定列留在 plugins/meta 的 tools/delegate-spec.tsv、README 的「Skills 目錄」重寫、三份 manifest 版本號提升、兩份 marketplace 檔逐位元一致、每個受影響存取庫一條 PR、每個受影響 domain 的 SKILLSET_{HASH} 各附加一節，並由 wiki-contents.sh upsert 退出 0 在 SKILLSET_CONTENTS 留下自己那一個 `## SKILLSET_{HASH}` 區塊、區塊裡以 `- 異動頁：[SKILLSET_{HASH}]({連結})` 的絕對網址指向該內容頁；本輪無 domain 被改動時，改成 plugins/meta 那一頁記「本輪無發現」 |
 
 ## skill-delete
 

references/wp01-baseline-decisions.md

@@ -0,0 +1,188 @@
+# 十項定案規格
+
+這份文件收錄分析頁裡十項技術裁定的定案內容，每項附出處與具體例子，供後續工作包直接引用，不必回頭翻找分析頁全文。
+
+## N-01：雜湊輸入分隔符
+
+**裁決**：多個欄位（例如計畫名稱與存取庫路徑）要接成一個雜湊輸入字串時，固定用直線號 `|` 當分隔符。組法收在 `hash-id` 的 `key` 子命令這個單一入口，各技能不再自己接字串。
+
+**出處**：「工作分解結構（WBS）」層1 共用腳本表格，工作包名稱「hash-id 加 key 子命令：分隔符 `|`、四道正規化、組法收單一入口」；測試計畫「雜湊組法收單一入口」小節第一個 TDD 循環，斷言 `hash-id key "我的計畫" "plugins/sdlc"` 與 `hash-id "我的計畫|plugins/sdlc"` 輸出同一個 40 碼雜湊。
+
+**例外**：本份分析頁自己的雜湊輸入不吃 `{owner}/{repo}`，只用計畫名稱，理由是這一輪盤點橫跨 11 個存取庫，綁任一個存取庫都是錯的。這是單一頁面的特例，不是分隔符定案本身跟著變。
+
+**例子**：
+```
+hash-id key "我的計畫" "plugins/sdlc"
+# 與下面這行輸出同一個 40 碼大寫 SHA-1
+hash-id "我的計畫|plugins/sdlc"
+```
+
+## N-02：計畫名稱正規化規則
+
+**裁決**：計畫名稱進雜湊前，固定套四道正規化，依序是：
+
+1. Unicode NFC 正規化
+2. 去除頭尾空白
+3. 內部連續空白壓成一個半形空白
+4. 英數字元全形轉半形
+
+大小寫不在正規化範圍內，維持原樣、視為不同名稱。
+
+**出處**：測試計畫「雜湊組法收單一入口」小節第二個 TDD 循環，斷言「我的 計畫」「我的　計畫」「我的計畫 」三種輸入正規化後相同，而「ABC 計畫」與「abc 計畫」不同；最小實作寫明四道正規化內容。
+
+**例子**：
+- `我的 計畫`、`我的　計畫`（全形空白）、`我的  計畫`（兩個半形空白）→ 正規化後同一個結果，雜湊相同，第二次建立同名計畫會被擋下
+- `ABC 計畫` 與 `abc 計畫` → 正規化後仍不同，雜湊不同，兩者當成不同計畫
+
+可直接貼進測試檔的指令：
+```
+hash-id key "我的 計畫" "plugins/sdlc"
+hash-id key "我的　計畫" "plugins/sdlc"
+hash-id key "我的  計畫" "plugins/sdlc"
+# 三行輸出同一個 40 碼雜湊
+
+hash-id key "ABC 計畫" "plugins/sdlc"
+hash-id key "abc 計畫" "plugins/sdlc"
+# 兩行輸出不同雜湊，這是反例，證明大小寫不會被正規化抹掉
+```
+
+## N-05：跨存取庫工作包編號起算
+
+**裁決**：每一份分析頁的工作包編號各自從 `WP-01` 起算，不跨頁連號。因此鎖定工作包不能只看編號，要在前面加上該分析頁自己的雜湊當複合鍵，兩份不同分析頁裡同編號的工作包才不會互搶同一把鎖。
+
+**出處**：「工作分解結構（WBS）」層2 技能行為表格，處理 analyze 頁名與跨庫的工作包名稱寫明「各頁 WP-01 起算」；對應 TDD 小節斷言兩份不同分析頁各自的「雜湊組法收單一入口」下游工作包不互相搶鎖，最小實作是把鎖鍵改成「`{分析頁雜湊}#WP-NN`」複合鍵。
+
+**例子**：分析頁 A 與分析頁 B 各有自己的第二個工作包。鎖鍵分別是 `{分析頁A雜湊}#WP-02` 與 `{分析頁B雜湊}#WP-02`，領取其中一個不影響另一個，兩邊各自從 1 起算。
+
+## N-07：`PLAN_CONTENTS` 存取庫欄格式
+
+**裁決**：`PLAN_CONTENTS` 目錄頁的存取庫欄改成清單，同一行、多個值用頓號分隔，不拆成多行子條列。
+
+**出處**：「工作分解結構（WBS）」層2 技能行為表格，工作包名稱「`PLAN_CONTENTS` 存取庫欄改清單，同行頓號分隔」；對應 TDD 小節斷言那一行 upsert 後讀得回多個值，最小實作是改範本並在寫入時以頓號串接。
+
+**例子**：
+```
+- 存取庫：plugins/sdlc、plugins/log
+```
+
+## L-03：年月週次進雜湊輸入
+
+**裁決**：工作日誌頁名的雜湊輸入改吃「年-月-週次」字串（例如 `2026-09-W1`），取代原本的 `{owner}/{repo}`。週次字串進的是雜湊輸入本身，不是先照舊算出雜湊再在頁名後面加後綴。
+
+**出處**：測試計畫「一週一頁工作日誌」小節第一個 TDD 循環，斷言三個不同存取庫、同一週的三筆日誌落在同一頁，且雜湊輸入不含 `{owner}/{repo}`，最小實作是「頁名改吃週次字串」。
+
+**例子**：`plugins/sdlc`、`plugins/log`、`plugins/meta` 三個存取庫在同一週（週五落在 2026-09-04）各寫一筆日誌。三筆都算出同一個雜湊、落在同一頁 `LOG_{hash(2026-09-W1)}`，各自在頁面內容裡帶自己的存取庫欄位。
+
+可直接貼進測試檔的指令：
+```
+worklog-target.sh week 2026-09-04
+# 輸出：2026-09-W1
+```
+
+邊界情況（反例，跨月份）：`2026-08-28` 是 8 月最後一個週五，算出 `2026-08-W4`；隔一週的 `2026-09-04` 只差 7 天，卻因為跨了月份算出 `2026-09-W1`。兩者雜湊不同、落在不同頁，不能因為「只差一週」就假設落在同一頁。
+```
+worklog-target.sh week 2026-08-28
+# 輸出：2026-08-W4
+```
+
+## L-05：舊日誌拆頁
+
+**裁決**：舊制一庫一頁的工作日誌，依每筆條目自己的日期拆進對應的週頁，不整頁原樣搬過去。拆頁動作可重跑不重複（用條目內容雜湊去重），拆不出日期的條目列進待處理清單，不猜日期也不丟棄。
+
+**出處**：「工作分解結構（WBS）」層3 搬遷與清理表格，工作包名稱「舊一庫一頁日誌依條目日期拆進各週頁，可重跑」，標明「不可逆」；對應 TDD 小節斷言含日期的條目落到正確週頁、沒日期的條目列進待處理清單且不丟掉，同一份輸入跑兩次不產生重複條目。
+
+**例子**：舊頁裡四筆條目：
+
+| 條目 | 日期 | 落頁 |
+| --- | --- | --- |
+| 條目一 | 2026-08-14 | `LOG_{hash(2026-08-W2)}` |
+| 條目二 | 2026-08-28 | `LOG_{hash(2026-08-W4)}` |
+| 條目三 | 2026-09-04 | `LOG_{hash(2026-09-W1)}` |
+| 條目四 | 無日期欄位 | 列進待處理清單，不猜週次 |
+
+三筆有日期的條目各自落進對應週頁；第四筆沒有日期，列進一份待處理清單交人工確認，不強行歸入任何一週。同一份舊頁重跑一次拆頁，用條目內容雜湊去重，不會讓已經拆過的四筆再多出一份——重跑後 `LOG_{hash(2026-08-W2)}` 頁裡條目一依然只有一份，不是兩份。
+
+## O-09：六條輸出原則裡哪幾條進得了 lint
+
+**裁決**：六條輸出原則裡，只有「避免書面語」與「問句要放句尾」這兩條寫成 `ste100-lint.sh` 裡的程式化判定；其餘四條要靠語意判斷，不硬塞進 lint。
+
+**出處**：「工作分解結構（WBS）」層2 技能行為表格，工作包名稱「`ste100-lint.sh` 補書面語詞彙與問句位置，加名詞展開寫法檢查」，註記「O-09 定案」；對應 TDD 小節有兩個判定，一個餵「請您進行身分驗證確認之動作」斷言抓得到書面語並建議改寫，另一個餵「請告訴我目的地，以便為您查詢班機」斷言抓得到問句不在句尾。
+
+**例子**：
+- 輸入「請您進行身分驗證確認之動作」→ 判定為書面語，建議改寫成「請幫我確認您的身分」
+- 輸入「請告訴我目的地，以便為您查詢班機」→ 判定為問句不在句尾，應改成先問句、後補充理由
+
+## A-12：關鍵路徑圖涵蓋所有工作包
+
+**裁決**：「涵蓋所有工作包」是指關鍵路徑圖上要畫出全部工作包，不是把 WBS 拆成每一包都串在同一條鏈上。圖裡只有真正的最長鏈標成關鍵路徑，其餘工作包照自己實際的相依邊掛上去，不為了「全部在一條鏈上」而編造假的先後順序。
+
+**出處**：分析頁「關鍵路徑（CPM）」節開頭：「本圖收進全部 55 個工作包（2026-09-07 裁示：關鍵路徑圖必須涵蓋所有工作包）」，並註明「`crit` 只標最長那一條鏈，其餘照自己的相依邊掛，不串成假的先後順序」。
+
+**例子**：55 個工作包全部畫進甘特圖；只有一條鏈（定案交付包 → 雜湊組法收單一入口 → 一週一頁工作日誌 → 舊日誌拆頁）標成關鍵路徑，其餘工作包各自照自己的相依關係接線，沒有相依的直接從錨點日期起排，不硬接到關鍵路徑上。
+
+可直接比對的斷言：
+- 甘特圖節點總數：55（等於分析頁工作包總數，一個都不能少）
+- 標 `crit` 的節點數：4（就是上面那條鏈），其餘 51 個工作包不掛 `crit`
+- 反例：沒有相依的工作包（例如一個獨立的小型修正包）不會被接在關鍵路徑任何一個節點後面，而是直接從錨點日期起排；如果檢查發現它被接進了那條 4 節點的鏈，就是誤把「涵蓋」做成了「全部串成一條鏈」
+
+## I-07：不監看時的相依判定
+
+**裁決**：implement 階段選擇不監看 PR 時，判斷某個工作包是否「已完成」要同時滿足兩個條件：狀態欄本身寫著「已完成」，而且那個工作包對應的 commit 真的在目前分支的歷史裡（用 `git merge-base --is-ancestor` 判定，狀態欄要多存一個 commit 欄位）。兩個條件都成立才放行，只滿足其中一條不算。
+
+這個判法跟「PR 已合併」不衝突：監看模式下 PR 合併之後，commit 自然會進到分支歷史裡，兩個條件同時成立；不監看模式下沒有實際等 PR 合併，改靠這兩個條件直接對真實的 git 歷史查驗，效果等同，但不必守著輪詢。
+
+**出處**：測試計畫「implement PR 監看二選一」小節第二個 TDD 循環，斷言相依包狀態欄寫「已完成」但其 commit 不在目前分支歷史裡時不放行，兩條都成立才放行；使用者故事驗收計畫「PR 沒人審把階段掛住」失敗流程一列寫明「相依判定改吃『狀態欄加 git 祖先』」。
+
+**例子**：某個工作包的狀態欄寫「已完成」、commit 欄記著一個 40 碼 SHA-1。查驗時執行 `git merge-base --is-ancestor {該commit} HEAD`；結束碼 0 才判定它真的完成，可以讓依賴它的下一包開工；結束碼非 0（commit 不在目前分支歷史）即使狀態欄寫完成也不放行。
+
+反例（另一半條件不成立）：狀態欄寫「進行中」，commit 欄記的 commit 其實已經是 HEAD 的祖先（`git merge-base --is-ancestor` 結束碼 0）。這種情況一樣不放行——兩個條件要同時成立，狀態欄沒寫「已完成」，光是 commit 在歷史裡也不夠。
+
+## I-09：同一張 PR 疊多個工作包要不要收斂
+
+**裁決**：不設上限，也不強制收斂。一張 PR 可以疊上任意數量的工作包；每次收尾時要印出目前這張 PR 疊了幾個工作包、累計改了幾行（用 `git diff --shortstat` 取得），讓疊加狀況看得見，但不會因為疊太多就被擋下。
+
+**出處**：「定案規格交付包」工作包的測試計畫小節，列出十項定案的簡表，其中一項寫明「I-09 不設上限」；「implement PR 監看二選一」小節第四個 TDD 循環，斷言每次收尾都印出目前這張 PR 疊了幾包、累計幾行，最小實作是取 `git diff --shortstat` 與領取紀錄。
+
+**例子**：同一張 PR 已經疊了 3 個工作包、累計改了 214 行。收尾時印出「本 PR 目前疊 3 包，累計 +180/-34 行」，然後照常繼續，不會因為已經疊了 3 包就強制先關閉這張 PR。
+
+## 無繼承例子的工作包：`analyze-check.sh` 三合一靜態檢核
+
+**說明**：這份文件收錄的十項技術定案加 F-01 決議，沒有一項對應到「三合一靜態檢核」這個工作包。逐一核對過 N-01、N-02、N-05、N-07、L-03、L-05、O-09、A-12、I-07、I-09、F-01，都不是這個工作包的裁決依據，硬套任何一項的例子都是誤導。
+
+**如實記錄**：這個工作包沒有從十項技術定案加 F-01 決議裡繼承到的例子，動工時要自己另外準備測試資料——具體要涵蓋哪三種靜態檢核、各自的正常輸入與異常輸入長什麼樣子，留給工作包自己在分析頁或動工當下決定，不在這份文件裡代寫。
+
+## F-01：五個未註冊存取庫的去向
+
+盤點 jsc 技能組時，發現五個存取庫檔案完整、能動，但沒登錄進 `plugins/meta` marketplace 正本的 `.claude-plugin/marketplace.json`。這一節記下五個存取庫各自的決議，供 E 表重寫直接引用。
+
+**裁決**：五個存取庫全部不納入正本，各自維持獨立系統。逐一列用途與決議：
+
+| 存取庫 | 一句話用途 | 決議 |
+| --- | --- | --- |
+| `plugins/code`（jsc-code） | .NET／NuGet 升版、Gitea AI review findings 修復、存取庫批次同步、`TARGET.md` 每日待辦 | 不納入正本，維持獨立系統 |
+| `plugins/doc`（jsc-doc） | Gitea 通知分組處理、docker 註解整理、議題分析與同步、工時日誌 | 不納入正本，維持獨立系統 |
+| `plugins/persona`（jsc-persona） | AI 人格化記憶聊天，跟 SDLC 技能組完全不相干的獨立系統 | 不納入正本，維持獨立系統 |
+| `plugins/shared`（jsc-shared） | 三十多支跨助理共用規格類技能（`spec-*`） | 不納入正本，維持獨立系統 |
+| `plugins/code-review`（呼叫前綴 `jsc:`，不是 `jsc-code-review:`） | 以 GitHub Actions 為基礎的 RPG 攻防式 `git diff` review，跟正本裡互動式的 `jsc-review` 是兩套不同東西 | 不納入正本，維持獨立系統 |
+
+**出處**：這一輪盤點（2026-09-07）裡使用者針對「五個未註冊存取庫逐一定去向」這一項待辦的明確答覆——五個全部不納入，不再逐一討論註冊、歸檔或刪除三選一。
+
+**對 E 表的具體影響**：`meta/tools/delegate-spec.tsv` 本身已經是對的——現有 35 列，不含這五個存取庫的任何技能，不必再修。真正還記著這幾支技能、需要訂正的是 `/root/plugins/TODO.md` 第 652～655 行那份 E 表（設計討論用的表格，跟 `delegate-spec.tsv` 是兩份不同的東西）。決議之後，TODO.md 那份 E 表要照下面的方式修正，實際改檔案交給 WP-36（或 TODO.md 自己校正清單裡已經開著的 F-02 項）：
+
+- **E-13**（TODO.md 第 652 行，`jsc-doc:notifications`，定期讀 Gitea 通知分組提醒）：整條移除。這支技能不會進正本，助理的技能清單裡永遠找不到它。
+- **E-14**（TODO.md 第 653 行，`jsc-code:review-resolve`，巡檢 findings 有沒有新的未處理項目）：整條移除，理由同上。
+- **E-15**（TODO.md 第 654 行，原列 `jsc-pkg:pkg-update`、`jsc-code:nuget`）：只留 `jsc-pkg:pkg-update` 那一半，`jsc-code:nuget` 那一半移除。
+- **E-16**（TODO.md 第 655 行，原列 `jsc-code:sync`、`jsc-gitea:repo-sync`）：只留 `jsc-gitea:repo-sync` 那一半，`jsc-code:sync` 那一半移除。
+- **M-20**（TODO.md 第 934 行，`jsc-code:target` 跟助理待辦簿的關係要收攏成一套，還是只巡檢它的系統排程）：這個問題本身不成立了。`jsc-code:target` 不在正本裡，助理的技能清單與委派判定清單都碰不到它，不會被觸發，也就沒有「兩份待辦互不知道」的風險。這一項直接關閉，不必再往下決議要收攏還是只巡檢。
+
+`plugins/persona`、`plugins/shared` 沒有被 TODO.md 那份 E 表任何一列引用，純粹是盤點時發現的閒置存取庫，記下「維持獨立、不納入」即可，不需要再對 E 表或委派判定清單做任何修正。
+
+**例子**：`meta/tools/delegate-spec.tsv` 現有 35 列，範圍剛好卡在 `ask` 到 `sdlc`，不含 `code`、`code-review`、`doc`、`persona`、`shared` 五個 domain 的任何一支技能——這份檔案本來就是決議之後該有的樣子，不必動它。要改的是 TODO.md 裡那份 E 表：核對 E-13 到 E-16、M-20 這五列，照上面的方式移除或裁半，不必再往回加東西，也不必幫已刪的那一半補回來。
+
+**不是價值判斷**：五個存取庫都是完整、能動的系統，不納入正本不代表它們沒用或做得不好。`persona` 是另一條產品線，人格化聊天跟 SDLC 開發流程沒有交集；`shared` 是跨助理共用規格技能，服務對象是所有助理而不是單一 SDLC 流程；`code`、`doc`、`code-review` 三個雖然功能上跟 jsc 技能組相近（都碰 Gitea、都碰程式碼），但各自的呼叫方式、維運節奏、目標使用情境都不同，例如 `code-review` 連呼叫前綴都還是舊的 `jsc:`，跟正本裡 `jsc-review` 的互動式流程本來就是兩套設計。維持獨立系統，讓 jsc 技能組正本只收它管得到、巡檢得到的技能，才是對的做法。
+
+## 跟 `wp01-todo-corrections.md` 的分工
+
+這份文件收十項技術定案跟 F-01 決議，都是這一輪盤點裡定下來、可以直接引用的規格內容。
+
+`TODO.md` 的狀態校正另外放在 [`wp01-todo-corrections.md`](wp01-todo-corrections.md)，不併進這份文件；不能開 PR 的完整理由見該文件開頭。

references/wp01-todo-corrections.md

@@ -0,0 +1,43 @@
+# TODO.md 狀態校正清單
+
+## 為什麼這份不走 PR
+
+`/root/plugins/TODO.md` 不在任何 git 存取庫底下。`/root/plugins` 本身不是 git 存取庫，`.git` 底下只有空的 `info/`。沒有存取庫，就沒有地方可以開分支、送 commit、開 PR。
+
+因此這份校正只能整理成清單，交給使用者參考。實際的檔案修改要靠使用者手動打開 `TODO.md`，對照下面的編號逐行更新。
+
+這份清單分兩節：第一節是十五項狀態校正，第二節是五項數字更新。兩節的來源都是同一輪盤點（2026-09-07，分析頁「核對結果：TODO.md 有 15 項狀態過期」與後面那段五項數字敘述），11 個存取庫各自以 `origin/develop` 為準逐一核對得出。
+
+## 第一節：十五項狀態校正
+
+15 項待辦裡，TODO.md 記的狀態跟實際狀態對不上。其中六項（F-06、W-04、R-04、G-02、G-03、G-07）是「早就做完卻還記著未動工」——照舊表動工會做白工，這六項要優先改。其餘九項是「部分完成」，TODO.md 記著未動工，實際已經做了一部分，剩下的落差寫在證據欄裡。
+
+| 編號 | TODO.md 原記 | 實際狀態 | 證據 |
+| --- | --- | --- | --- |
+| F-06 | `[ ]` 未動工 | 已完成 | `hooks/comment-scope.sh:91` 已含三種頁型 |
+| W-04 | `[ ]` 未動工 | 已完成 | `hooks/templates/error-contents.md:13` 起已是條列 |
+| R-04 | `[ ]` 未動工 | 已完成 | `wire-cli.sh:1394-2270`，十類 140 條自我斷言，五支 CLI 各有路徑 |
+| G-02 | `[ ]` 未動工 | 已完成 | `issue.sh:81-88` 只列既有標籤，`90-103` 對不到就回 4 |
+| G-03 | `[ ]` 未動工 | 已完成 | `issue.sh:202-204` 空集合就不寫進 payload |
+| G-07 | `[ ]` 未動工 | 已完成 | `wiki-to-issue/SKILL.md:25` 完成條件已要求回報實際標籤 |
+| W-02 | `[ ]` 未動工 | 部分完成 | `wiki-contents.sh:268-293` 的 `format` 子命令已是共用轉檔唯一實作 |
+| W-05 | `[ ]` 未動工 | 部分完成 | `wiki-contents.sh:168-174` 取不出鍵就中止（不猜已在），差頁型對照表 |
+| W-06 | `[ ]` 未動工 | 部分完成 | `check-contents-format.sh` 已在，但驗的是暫存檔，不是真實頁面 |
+| F-04 | `[ ]` 記六種缺庫 | 部分完成 | 站台已有 10 個 `knowledges/` 庫，只缺 LEARN、ERROR、REPORT、TOOLING、MAINTAIN 五種 |
+| F-05 | `[ ]` 未動工 | 部分完成 | `gitea.sh:70` 已指名要設哪個變數並回 3。新缺失：那句訊息是英文，還沒改成中文 |
+| N-08 | `[ ]` 未動工 | 部分完成 | `migrate-wiki.sh` 已在，且認兩代舊演算法，差第 150 行 `WANT` 沒有「計畫名稱」候選鍵 |
+| A-11 | `[ ]` 未動工 | 部分完成 | `analyze/SKILL.md:43` 內文已要求每則待辦寫出驗收依據，缺的只有程式化擋關 |
+| R-01 | `[ ]` 未動工 | 部分完成 | 三段抽出一段（`deploy-verify.md`），剩兩段仍逐字重複，其中一段 23 行四份相同（`skill-new/SKILL.md:68-90` 的「結束碼」路由表） |
+| F-03 | `[ ]` 記帶過期清單 | 部分完成 | `plugins/jsc` 兩份 marketplace 與正本 `diff` 為空，已於 2026-09-01 手動對齊。「過期」這個說法不成立，但去向仍未定 |
+
+## 第二節：五項數字更新
+
+以下五項是 TODO.md 裡記的數字跟現況對不上，不牽涉狀態欄，只是數字本身要改。
+
+| 項目 | TODO.md 原記 | 實際數字 |
+| --- | --- | --- |
+| `wire-cli.sh` 總行數 | 2629 行 | 2860 行 |
+| `implement/SKILL.md` 總行數 | 113 行 | 162 行 |
+| `skill-check` 的 `description` 字元數 | 819 字元 | 1318 字元 |
+| `delegate-spec.tsv` 裡 `probe` 欄未接線（`pending`）支數 | 7 支 | 8 支 |
+| `jsc-assist` 的 `jsc.requires` 項數 | 4 項 | 5 項 |

skills/skill-check/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-check
-description: Routine compliance, script, hook, flow-efficiency, and cost-efficiency audit of the whole jsc skill set with no change request in hand. Sync every domain repo from the Gitea canonical marketplace, then run three parallel groups - lint-scripts.sh plus lint-frontmatter.sh plus check-behaviors.sh plus ste100-lint.sh plus check-link-format.sh plus check-wiki-rules.sh plus check-page-name.sh plus check-delegate.sh plus hook smoke, the guidelines.md checklist audit, and an optimization review that first reads each domain's SKILLSET_{HASH} so suggestions already applied or deferred are never re-scanned or re-asked, then covers parallelism, tool extraction, repeated interaction, redundant checks, misplaced gates, and avoidable token, sub-agent, API, scan, or interaction cost. Confirm compliance fixes and optimization suggestions before applying them, recording each decision with its date, re-check until accepted fixes pass, then open a PR per affected repo via jsc-git pr. Close by appending the round's result to every changed domain's SKILLSET_{HASH} and its SKILLSET_CONTENTS block, or to the plugins/meta page when no domain was changed. Use for periodic or on-demand skill-set checks; not for applying a change request (use skillset-update) or editing one skill (use skill-update).
+description: Routine compliance, script, hook, flow-efficiency, and cost-efficiency audit of the whole jsc skill set with no change request in hand. Sync every domain repo from the Gitea canonical marketplace, then run three parallel groups - lint-scripts.sh plus lint-frontmatter.sh plus check-behaviors.sh plus ste100-lint.sh plus check-link-format.sh plus check-wiki-rules.sh plus check-page-name.sh plus check-delegate.sh plus check-skill-paths.sh plus hook smoke, the guidelines.md checklist audit, and an optimization review that first reads each domain's SKILLSET_{HASH} so suggestions already applied or deferred are never re-scanned or re-asked, then covers parallelism, tool extraction, repeated interaction, redundant checks, misplaced gates, and avoidable token, sub-agent, API, scan, or interaction cost. Confirm compliance fixes and optimization suggestions before applying them, recording each decision with its date, re-check until accepted fixes pass, then open a PR per affected repo via jsc-git pr. Close by appending the round's result to every changed domain's SKILLSET_{HASH} and its SKILLSET_CONTENTS block, or to the plugins/meta page when no domain was changed. Use for periodic or on-demand skill-set checks; not for applying a change request (use skillset-update) or editing one skill (use skill-update).
 ---
 
 # skill-check — audit compliance, flow efficiency, and cost efficiency
@@ -30,9 +30,10 @@ Single source of guidelines: [`../../references/guidelines.md`](../../references
       - 3 — nothing was checked, because `tools/delegate-spec.tsv` is missing, the root could not be derived, or `list-skills.sh` listed no skill. Record it as 「無委派清單可查」 with the cause from stderr and carry it into the step 3 merge; **exit 3 is never a pass**, because a check that read nothing reports neither a missing row nor an extra one.
 
       This verdict is **not** one of the guidelines.md audit-checklist items, so it stays out of the nine that step 3 merges into every domain's checklist and is reported on its own line, one line for the round.
-   8. For every shell script directly named by a SKILL.md, confirm the skill routes every exit code the script's header declares. `lint-scripts.sh` proves the script exists and declares its codes; this check is the other half — that the caller branches on each of them. Report evidence as `skill file:line -> script path`.
+   8. For every synced domain repo, run `tools/check-skill-paths.sh {domain-path}`. One run per domain, and the runs go **in parallel** alongside the other group 1 per-domain runs. It reads every `skills/*/SKILL.md` and `references/*.md` and resolves each `tools/…` or `hooks/…` script path written in them. `lint-scripts.sh` proves a script exists inside its own repo; this one proves the path as written reaches it. Route each exit code: 0 — no path in that domain points at a file that is not there, and the hint lines it printed are counted separately from failures; 1 — the `missing` lines name paths that resolve to nothing, so report each as a compliance failure with its file and line; 2 — usage error, the tool takes exactly one argument; 3 — nothing was scanned, because the domain path is missing or it has neither `skills/*/SKILL.md` nor `references/*.md`. Record exit 3 as 「無文件可掃」; exit 3 is **never** a pass. Its `unrooted` and `unknown` lines are hints, never failures — `unrooted` marks a path with no plugin directory name, which resolves against whatever the current directory happens to be, and `unknown` marks a cross-domain path whose repo is not on this machine. Carry the two hint counts into the report without turning them into decision-tree items: the whole skill set carries hundreds of `unrooted` paths, and promoting them to failures would turn every domain red at once, which reads the same as no report at all. This check exists because item 9 below was already supposed to catch this and could not: a human reading item 9 checks that the named script exists in `tools/`, which it does, and never asks whether the path as written reaches it — so the same defect passed review every round until a path exited 127 in front of someone. This verdict is **not** one of the guidelines.md audit-checklist items either, so it stays out of the nine that step 3 merges into every domain's checklist and is reported on its own line, one line per domain.
-   9. When the `jsc-hooks` domain is present, run `jsc-hooks/tools/wire-cli.sh smoke {cli}` for every CLI reported by `jsc-cli/tools/detect-clis.sh`; the per-CLI smokes run **in parallel**. When no CLI is detected, run `jsc-hooks/tools/wire-cli.sh smoke codex` as the minimum hook behavior check and label it 「預設 hook smoke」 in the report. Use `smoke`, not `purge` or rewiring actions, and set `JSC_READONLY=1` for the whole audit so a mistyped sub-command is refused in code (exit 6) instead of rewiring the machine; `status` and `smoke` are unaffected by that variable. Route each `smoke` exit code: 0 — the run passed its own assertions; 2 — usage error, so fix the CLI code and rerun; 4 — the smoke failed, which includes the script's own result-line count not matching what it expected. **Read the count from the script's `lines<TAB>{數量}` output line; never write the number into this skill.** The script counts its own result lines and asserts them, so a hardcoded number here goes stale the moment a hook or a decision path is added — an out-of-date count in a SKILL.md is exactly what misled the previous audit.
+   9. For every shell script directly named by a SKILL.md, confirm the skill routes every exit code the script's header declares. `lint-scripts.sh` proves the script exists and declares its codes; this check is the other half — that the caller branches on each of them. Report evidence as `skill file:line -> script path`.
-   10. When a hook or script smoke fails, route it as a compliance failure with script name, exit code, output summary, and proposed fix. Do not continue to report the affected hook as compliant.
+   10. When the `jsc-hooks` domain is present, run `jsc-hooks/tools/wire-cli.sh smoke {cli}` for every CLI reported by `jsc-cli/tools/detect-clis.sh`; the per-CLI smokes run **in parallel**. When no CLI is detected, run `jsc-hooks/tools/wire-cli.sh smoke codex` as the minimum hook behavior check and label it 「預設 hook smoke」 in the report. Use `smoke`, not `purge` or rewiring actions, and set `JSC_READONLY=1` for the whole audit so a mistyped sub-command is refused in code (exit 6) instead of rewiring the machine; `status` and `smoke` are unaffected by that variable. Route each `smoke` exit code: 0 — the run passed its own assertions; 2 — usage error, so fix the CLI code and rerun; 4 — the smoke failed, which includes the script's own result-line count not matching what it expected. **Read the count from the script's `lines<TAB>{數量}` output line; never write the number into this skill.** The script counts its own result lines and asserts them, so a hardcoded number here goes stale the moment a hook or a decision path is added — an out-of-date count in a SKILL.md is exactly what misled the previous audit.
+   11. When a hook or script smoke fails, route it as a compliance failure with script name, exit code, output summary, and proposed fix. Do not continue to report the affected hook as compliant.
 
    **Group 2 — audit every skill of every domain against the guidelines.md audit checklist.** This group MUST run as a sub agent, one sub agent per domain repo, and those sub agents run **in parallel**. Each sub agent reports its findings: skill, failed checklist item, evidence (file:line), proposed fix. Cover the checklist's four flow checks by name, not only the naming and language items:
    - Every step number, file path and section title the skill references — inside itself and in other files — really exists (the pointer points at something).
@@ -78,7 +79,7 @@ Single source of guidelines: [`../../references/guidelines.md`](../../references
 
    Each optimization finding reports skill, aspect, evidence (file:line), current flow step count, proposed flow step count, what time or interaction it saves, what cost it saves, current cost driver, proposed cost driver, whether correctness decreases, which protection would be weakened if any, the **決議** (`套用`, `延後` or `自訂`) recorded in step 3, and the **決議日期** that decision was made. The last two fields start empty and are filled in by step 3; they are what step 8 writes to the wiki and what the next round reads back, so a finding that reaches step 8 with either field empty is unfinished, not optional. Cost savings may be token volume, sub-agent count, API calls, file scans, full-repo audits, or user prompts. Keep optimization findings separate from compliance failures.
 
-   Completion condition for all three groups: every domain has a `lint-scripts.sh` verdict, a `lint-frontmatter.sh` verdict, a `check-behaviors.sh` verdict, an `ste100-lint.sh` verdict and a `check-link-format.sh` verdict, `check-wiki-rules.sh`, `check-page-name.sh` and `check-delegate.sh` each have one verdict for the whole run — `check-delegate.sh` carrying its hint lines separately from its failures, or 「無委派清單可查」 where it exited 3 — every script named by a SKILL.md has an exit-code-routing verdict, and every smoked CLI has a `smoke` exit code plus the `lines` value the script printed for it; every domain has a group 2 audit result that names a verdict for all checklist items — the four flow checks included, and the nine group 1 items left blank for the step 3 merge rather than re-scanned; and every one of the six aspects has returned a verdict for every domain whose settled list was read, 「無發現」 where an aspect found nothing and every settled entry of that domain excluded rather than re-reported — a domain whose pre-read failed carries 「本輪未取得已決議清單，優化建議暫不提出」 instead, and that sentence is a complete group 3 result for it.
+   Completion condition for all three groups: every domain has a `lint-scripts.sh` verdict, a `lint-frontmatter.sh` verdict, a `check-behaviors.sh` verdict, an `ste100-lint.sh` verdict, a `check-link-format.sh` verdict and a `check-skill-paths.sh` verdict — the last one carrying its `unrooted` and `unknown` hint counts separately from its failures — `check-wiki-rules.sh`, `check-page-name.sh` and `check-delegate.sh` each have one verdict for the whole run — `check-delegate.sh` carrying its hint lines separately from its failures, or 「無委派清單可查」 where it exited 3 — every script named by a SKILL.md has an exit-code-routing verdict, and every smoked CLI has a `smoke` exit code plus the `lines` value the script printed for it; every domain has a group 2 audit result that names a verdict for all checklist items — the four flow checks included, and the nine group 1 items left blank for the step 3 merge rather than re-scanned; and every one of the six aspects has returned a verdict for every domain whose settled list was read, 「無發現」 where an aspect found nothing and every settled entry of that domain excluded rather than re-reported — a domain whose pre-read failed carries 「本輪未取得已決議清單，優化建議暫不提出」 instead, and that sentence is a complete group 3 result for it.
 3. Merge the three groups, then present compliance failures and optimization findings separately via the `jsc-ask:ask` decision tree. Merging means one thing in code: fill the nine skipped checklist items of every group 2 sub agent report from the matching group 1 verdicts, so each domain ends with one complete checklist and no item counted twice. Seven of the nine are per-domain verdicts, one domain to one item. The other two — `check-page-name.sh` and `check-wiki-rules.sh` — are judged **once for the whole round**, and that one verdict goes into that same item of **every** domain's checklist; re-judging a whole-round item per domain is precisely the double counting this merge exists to stop. A domain that group 3 marked 「本輪未取得已決議清單，優化建議暫不提出」 still gets its full compliance checklist here; only its optimization findings are missing, and the merge report says so.
    - Compliance failure options: apply the proposed fix / skip / custom fix. Every option states its impact scope, for example skipping leaves the skill non-compliant until the next audit.
    - The `check-delegate.sh` failures join that same set, one decision-tree item per reported row, and they carry one extra note in their impact scope: fixing a missing row means running the delegation decision tree of [`../../references/delegate-criteria.md`](../../references/delegate-criteria.md) for that skill in step 4, which is more questions than most fixes. Its **hint** lines never become decision-tree items — a hint is a note about a row that is already there, and turning it into a question re-asks a settled judgement every round, which is the 「重複來回」 group 3 exists to catch.
@@ -93,7 +94,7 @@ Single source of guidelines: [`../../references/guidelines.md`](../../references
    - Exit 0 — every copy holds identical bytes; the script verifies that itself.
 
    Completion condition: the script exits 0 and prints the touched paths.
-6. Re-run the group 1 script, frontmatter, behavior-list, language, link-format, wiki-rule, page-name, delegation-list and hook validation, re-check the guidelines.md audit checklist for every touched skill, then re-run the optimization aspect that produced each accepted optimization. These three re-runs are as independent as the first pass, so run them **in parallel** and merge them the same way step 3 did. On any compliance failure, **return to step 3**: confirm and fix again, until all accepted compliance fixes pass. On an accepted optimization that does not produce the promised step reduction or cost reduction, or still weakens correctness beyond the recorded decision, return to step 3 for a new decision. Completion condition: `tools/lint-scripts.sh` exits 0 or 3 for every domain, `tools/lint-frontmatter.sh` exits 0 for every domain — exit 3 is 「什麼都沒掃」 and never counts as a pass — `tools/check-behaviors.sh` exits 0 for every domain, `tools/ste100-lint.sh` exits 0 for every domain, `tools/check-link-format.sh` exits 0 for every domain — its exit 3 is 「什麼都沒掃」 and never counts as a pass — `jsc-gitea/tools/check-wiki-rules.sh` exits 0, `tools/check-page-name.sh` exits 0 — its exit 3 is 「什麼都沒查」 and never counts as a pass — `tools/check-delegate.sh` exits 0, its remaining stdout lines counted as hints rather than failures and its exit 3 read as 「無委派清單可查」 and never as a pass, every hook smoke exits 0 with the `lines` count the script itself asserted, every domain's checklist passes in full — the two whole-round verdicts filled into each domain from the one run that produced them — and every accepted optimization has a matching verification result.
+6. Re-run the group 1 script, frontmatter, behavior-list, language, link-format, script-path, wiki-rule, page-name, delegation-list and hook validation, re-check the guidelines.md audit checklist for every touched skill, then re-run the optimization aspect that produced each accepted optimization. These three re-runs are as independent as the first pass, so run them **in parallel** and merge them the same way step 3 did. On any compliance failure, **return to step 3**: confirm and fix again, until all accepted compliance fixes pass. On an accepted optimization that does not produce the promised step reduction or cost reduction, or still weakens correctness beyond the recorded decision, return to step 3 for a new decision. Completion condition: `tools/lint-scripts.sh` exits 0 or 3 for every domain, `tools/lint-frontmatter.sh` exits 0 for every domain — exit 3 is 「什麼都沒掃」 and never counts as a pass — `tools/check-behaviors.sh` exits 0 for every domain, `tools/ste100-lint.sh` exits 0 for every domain, `tools/check-link-format.sh` exits 0 for every domain — its exit 3 is 「什麼都沒掃」 and never counts as a pass — `tools/check-skill-paths.sh` exits 0 for every domain — its exit 3 is 「什麼都沒掃」 and never counts as a pass, and its `unrooted` and `unknown` lines stay hints rather than becoming failures — `jsc-gitea/tools/check-wiki-rules.sh` exits 0, `tools/check-page-name.sh` exits 0 — its exit 3 is 「什麼都沒查」 and never counts as a pass — `tools/check-delegate.sh` exits 0, its remaining stdout lines counted as hints rather than failures and its exit 3 read as 「無委派清單可查」 and never as a pass, every hook smoke exits 0 with the `lines` count the script itself asserted, every domain's checklist passes in full — the two whole-round verdicts filled into each domain from the one run that produced them — and every accepted optimization has a matching verification result.
 7. Call `jsc-git:pr` once per affected domain repo to open a Push Request. Completion condition: every affected repo has a PR URL, and all URLs are reported in one table with the format in [`../../references/pr-report.md`](../../references/pr-report.md).
 8. Write the round's result to the wiki. This step **MUST run as a sub agent**, one sub agent per affected domain repo, and those sub agents run **in parallel**: each domain writes its own page, and no page waits on another.
 

tools/check-skill-paths.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env sh
+# check-skill-paths.sh — 檢查一個 domain 存取庫的文件裡，寫出來的腳本路徑解不解得出來。
+#
+# 用法: check-skill-paths.sh <domain-path>
+#
+# 檢查兩項（掃 {domain-path} 底下的 skills/*/SKILL.md 與 references/*.md）:
+#   一、帶 domain 名的路徑（jsc-{domain}/tools/x.sh、{domain}/hooks/x.sh）——那個檔案要
+#       真的在對應的存取庫底下。指到不存在的檔案算缺失。
+#   二、不帶 domain 名的路徑（tools/x.sh、hooks/x.sh）——檔案在這個存取庫底下就只算提示，
+#       不算缺失，理由見下面「為什麼不帶前綴只算提示」。檔案根本不在，才算缺失。
+#
+# 為什麼要有這支: lint-scripts.sh 掃的是 tools/ 與 hooks/ 目錄裡的檔案，它證明得了
+#   「這個存取庫裡有這支腳本、語法沒問題」，卻證明不了「文件裡寫的那條路徑解得出那支腳本」。
+#   兩件事差很遠。2026-09-04 實際踩到: 一份技能本文把自家腳本寫成不帶前綴的 tools/x.sh，
+#   而那支技能的基底目錄是 skills/{名稱}/，照字面解出來是 skills/{名稱}/tools/x.sh，
+#   結束碼 127。人工覆核那一輪看的是「tools/ 底下有沒有 x.sh」，有，於是就過了——
+#   覆核的問題問錯了，所以每一輪都會再過一次。
+#
+# 為什麼不帶前綴只算提示，不算缺失:
+#   不帶前綴的相對路徑會相對於**當下的工作目錄**解。在自己那個存取庫裡跑，剛好解得對；
+#   換一個工作目錄就解到別人的 tools/ 底下，或者解不出來。兩種都不會有明確的錯誤訊息，
+#   前者更糟——它會跑起來，跑的是另一支腳本。無人值守那一輪還多一層: 相對路徑進不了
+#   權限允許清單（那邊比對的是完整字面絕對路徑），會被靜靜擋掉。
+#   話說回來，這是整個技能組共通的寫法，一次上百處。把它判成缺失會讓每一個存取庫都紅，
+#   而一份全紅的報告跟沒有報告一樣。所以先量出來、指得出是哪幾行，改不改由人決定。
+#
+# 判定範圍與其極限: 只認 tools/ 與 hooks/ 兩個目錄底下的 *.sh。templates/ 與 references/
+#   底下的檔案不在這一支的範圍內——那些是資料不是入口，指錯了不會變成一支跑起來的別的程式。
+#   跨 domain 的路徑要那個 domain 的存取庫也在這台機器上才驗得到；不在就印成提示，
+#   不當缺失。這台機器沒裝，跟路徑寫錯，是兩件事。
+#
+# 輸出: 一行一項，格式 {檔案}:{行號}:{類別}:{路徑}（stdout）；統計摘要走 stderr。
+#   類別 missing=指到不存在的檔案，unrooted=不帶前綴、相對於工作目錄解，
+#   unknown=跨 domain 但那個存取庫不在這台機器上。
+# 結束碼: 0=掃到文件且沒有缺失（提示不算缺失）
+#         1=有缺失（missing 那幾行）
+#         2=用法錯誤（本腳本只吃一個參數）
+#         3=domain 路徑不存在，或底下一份可掃的文件都沒有——**什麼都沒掃**，不等於通過
+set -u
+
+usage() {
+  echo 'usage: check-skill-paths.sh <domain-path>' >&2
+  exit 2
+}
+
+[ "$#" -eq 1 ] || usage
+DOMAIN=${1%/}
+[ -n "$DOMAIN" ] || usage
+[ -d "$DOMAIN" ] || { echo "找不到 domain 路徑：$DOMAIN" >&2; exit 3; }
+
+HERE=$(CDPATH= cd -P -- "$(dirname -- "$0")" && pwd -P)
+# 根目錄推導與別的檢核腳本共用同一套規則。跨 domain 的路徑要靠它才找得到別的存取庫；
+# 推不出來不是致命的，那幾筆改印成 unknown 提示。
+ROOT=''
+if [ -f "$HERE/plugins-root.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$HERE/plugins-root.sh"
+  ROOT=$(jsc_plugins_root 2>/dev/null) || ROOT=''
+fi
+
+TMP=$(mktemp) || { echo "無法建立暫存檔" >&2; exit 3; }
+HITS=$(mktemp) || { rm -f "$TMP"; echo "無法建立暫存檔" >&2; exit 3; }
+trap 'rm -f "$TMP" "$HITS"' EXIT
+
+# skills/*/SKILL.md 與 references/*.md 兩處。README 不掃: 那裡的路徑是給人看的目錄，
+# 不是叫誰去跑的入口。
+find "$DOMAIN/skills" -type f -name 'SKILL.md' -print 2>/dev/null > "$TMP"
+find "$DOMAIN/references" -type f -name '*.md' -print 2>/dev/null >> "$TMP"
+sort -o "$TMP" "$TMP"
+[ -s "$TMP" ] || { echo "底下沒有 skills/*/SKILL.md 也沒有 references/*.md，無文件可掃：$DOMAIN" >&2; exit 3; }
+
+TOTAL=$(wc -l < "$TMP" | tr -d ' ')
+
+# 這個存取庫自己的 domain 名。目錄名可能帶 jsc- 前綴（安裝後）或不帶（工作目錄版面），
+# 兩種都要認得，否則自家的路徑會被當成跨 domain 而驗不到。
+SELF=$(basename -- "$DOMAIN")
+SELF=${SELF#jsc-}
+
+# 找某個 domain 的存取庫目錄。工作目錄版面不帶前綴、安裝後帶前綴，兩種都試。
+domain_dir() { # $1=domain 名
+  [ -n "$ROOT" ] || return 1
+  if [ -d "$ROOT/jsc-$1" ]; then printf '%s' "$ROOT/jsc-$1"; return 0; fi
+  if [ -d "$ROOT/$1" ]; then printf '%s' "$ROOT/$1"; return 0; fi
+  return 1
+}
+
+while IFS= read -r f; do
+  [ -n "$f" ] || continue
+
+  # 第一趟：帶 domain 名的路徑。前面可能還接著根目錄代入點（例如 {CURRENT}/），
+  # 那不影響判定——要驗的是 {domain}/{tools|hooks}/{檔名} 這一段。
+  grep -noE '(jsc-)?[a-z][a-z0-9-]*/(tools|hooks)/[a-z0-9-]+\.sh' "$f" 2>/dev/null |
+  while IFS=: read -r ln path; do
+    dom=${path%%/*}
+    dom=${dom#jsc-}
+    rest=${path#*/}
+    if [ "$dom" = "$SELF" ]; then
+      [ -f "$DOMAIN/$rest" ] || printf '%s:%s:missing:%s\n' "$f" "$ln" "$path"
+      continue
+    fi
+    if dir=$(domain_dir "$dom"); then
+      [ -f "$dir/$rest" ] || printf '%s:%s:missing:%s\n' "$f" "$ln" "$path"
+    else
+      printf '%s:%s:unknown:%s\n' "$f" "$ln" "$path"
+    fi
+  done
+
+  # 第二趟：不帶 domain 名的路徑。字元集把斜線排掉，第一趟已經算過的那幾筆才不會再算一次。
+  grep -noE '(^|[^-a-zA-Z0-9/_.{])(tools|hooks)/[a-z0-9-]+\.sh' "$f" 2>/dev/null |
+  while IFS=: read -r ln raw; do
+    path=$(printf '%s' "$raw" | sed 's|^[^t h]*||; s|^\(tools\|hooks\)|\1|')
+    case "$path" in
+      tools/*|hooks/*) ;;
+      *) path=${raw#?} ;;
+    esac
+    case "$path" in
+      tools/*|hooks/*) ;;
+      *) continue ;;
+    esac
+    if [ -f "$DOMAIN/$path" ]; then
+      printf '%s:%s:unrooted:%s\n' "$f" "$ln" "$path"
+    else
+      printf '%s:%s:missing:%s\n' "$f" "$ln" "$path"
+    fi
+  done
+done < "$TMP" | sort -u > "$HITS"
+
+N_MISS=$(grep -c ':missing:' "$HITS" 2>/dev/null || true)
+N_UNROOT=$(grep -c ':unrooted:' "$HITS" 2>/dev/null || true)
+N_UNKNOWN=$(grep -c ':unknown:' "$HITS" 2>/dev/null || true)
+: "${N_MISS:=0}" "${N_UNROOT:=0}" "${N_UNKNOWN:=0}"
+
+[ -s "$HITS" ] && cat "$HITS"
+
+if [ "$N_MISS" -gt 0 ]; then
+  echo "腳本路徑檢查有缺失：共掃 $TOTAL 份文件，$N_MISS 條指到不存在的檔案，另有 $N_UNROOT 條不帶 domain 名、$N_UNKNOWN 條跨 domain 但存取庫不在這台機器上" >&2
+  exit 1
+fi
+
+echo "腳本路徑檢查通過：共掃 $TOTAL 份文件，沒有指到不存在的檔案；另有 $N_UNROOT 條不帶 domain 名、$N_UNKNOWN 條跨 domain 但存取庫不在這台機器上，兩種都只是提示" >&2
+exit 0

tools/delegate-spec.tsv

@@ -44,6 +44,13 @@
 #                 例如 JSC_READONLY=1。另外兩個代入點，一個目標跑一次：{cli} 是助理偵測到的
 #                 CLI 代號，{repo} 是助理掃到的存取庫工作目錄。這三個以外的大括號一律算填錯——
 #                 代不進去的字面值會原樣送進指令。
+#                 結束碼只准表示過與不過，不准用來編碼狀態。這一條是後來補的，因為漏了它
+#                 就踩過一次：填進來的那一支用結束碼帶三種狀態（接好、接好但這支 CLI 做不到、
+#                 有東西沒接），而讀的那一邊照非零判失敗，於是有先天限制的那一支 CLI 每輪
+#                 讓那一筆失敗一次、一天 96 次，而沒有人修得動。失敗次數存在的理由是指出
+#                 「有一筆壞掉的項目每輪重試而沒人知道」，被修不動的數字填滿就等於用假的
+#                 壞掉把真的壞掉蓋掉。要填的那一支如果用結束碼帶狀態，先去那一邊加一個
+#                 只回過與不過的模式，不要在這一欄將就。
 #                 填之前一定要真的跑一次那一行，不能照技能文件的措辭抄。實際踩過兩次：
 #                 一次抄來的子命令那支腳本根本沒有，跑起來是用法錯誤；一次抄來的子命令會
 #                 在標準輸入沒人關閉時無限等待，換成同一支的另一個子命令才回得來。兩種都
@@ -78,7 +85,7 @@ gitea	html-style	none	-	-	版型與樣式是使用者的偏好，要逐項確認
 gitea	repo-sync	slice	patrol	盤點哪些存取庫落後遠端、哪些還沒同步下來	clone 與 update——會動工作目錄	at:now	every:1d	jsc-git:pr	0.2.5	seed	pending:repo-sync.sh 會 clone 與 pull，沒有唯讀子命令；盤點落後也要連遠端
 gitea	wiki	none	-	-	助理的手腳，不獨立排程。助理所有 wiki 讀寫都經過它，一律附加	-	-	jsc-gitea:html-export	0.2.5	seed	-
 gitea	wiki-to-issue	none	-	-	對外不可逆	-	-	jsc-sdlc:analyze	0.2.5	seed	-
-hooks	hooks-install	slice	patrol	wire-cli.sh status 唯讀盤點接線	重新接線	at:now	every:1d	jsc-hooks:repair	0.4.4	seed	JSC_READONLY=1 {root}/jsc-hooks/tools/wire-cli.sh status {cli}
+hooks	hooks-install	slice	patrol	wire-cli.sh status --verdict 唯讀盤點接線，先天限制不算失敗	重新接線	at:now	every:1d	jsc-hooks:repair	0.4.5	seed	JSC_READONLY=1 {root}/jsc-hooks/tools/wire-cli.sh status {cli} --verdict
 hooks	repair	slice	invoke	巡檢抓到 hook 錯誤就發動修復	診斷、改哪一支、開 PR，全照 repair 自己的流程	after:hook-error	every:1h	jsc-git:pr	0.4.4	seed	-
 log	learn	slice	patrol	發動技能前先查過去教訓，也就是 consult 那一段	記錄教訓的判斷。哪一次值得留下來要人說	at:now	every:1d	jsc-log:worklog	0.1.9	seed	pending:要連 wiki 讀 LEARN 目錄頁，得帶金鑰
 log	report	slice	invoke	週期到了就產週報、月報、年報	報告要不要改寫、要不要送人看	at:now	every:7d	jsc-log:learn	0.1.9	seed	-