@@ -31,7 +31,8 @@ Marketplace 統一為 `jsc`（
| `tools/config-spec.tsv` | 設定規格表：每個環境變數與設定檔一列，標明必要或選擇、預設值、驗證方式、修法。體檢與設定共用這一份，新增設定時要同步補一列 |
| `tools/config-spec.tsv` | 設定規格表：每個環境變數與設定檔一列，標明必要或選擇、預設值、驗證方式、修法。體檢與設定共用這一份，新增設定時要同步補一列 |
| `tools/scan-config.sh` | 依規格表盤點設定現況（`scan {global\|project\|all}` 印 TSV 與 summary、`spec` 印規格表、`orphans` 找出漏登錄的變數）；`-o` 為離線模式，需要連 Gitea 的檢查一律標 skipped。唯讀，不寫任何設定；帶 TOKEN 的項目只印 set 或 unset |
| `tools/scan-config.sh` | 依規格表盤點設定現況（`scan {global\|project\|all}` 印 TSV 與 summary、`spec` 印規格表、`orphans` 找出漏登錄的變數）；`-o` 為離線模式，需要連 Gitea 的檢查一律標 skipped。唯讀，不寫任何設定；帶 TOKEN 的項目只印 set 或 unset |
| `tools/apply-config.sh` | 把設定寫進 shell rc 檔（`set {KEY} {VALUE}` 、`unset {KEY}` ）或建立目錄（`mkdir {PATH}` ）；`show` 印出目前設定，`rcfiles` 印出會寫入的檔案。內容一律收在 `# jsc-config` 標記段落之間，整段重寫不疊加，段落外不動。動檔案前先備份到 `$JSC_HOME/backup/config/{yyyyMMdd_HHmmss}/` ，備份失敗就不寫；寫完重讀驗證。fish 自動改用 `set -gx` 語法 |
| `tools/apply-config.sh` | 把設定寫進 shell rc 檔（`set {KEY} {VALUE}` 、`unset {KEY}` ）或建立目錄（`mkdir {PATH}` ）；`show` 印出目前設定，`rcfiles` 印出會寫入的檔案。內容一律收在 `# jsc-config` 標記段落之間，整段重寫不疊加，段落外不動。動檔案前先備份到 `$JSC_HOME/backup/config/{yyyyMMdd_HHmmss}/` ，備份失敗就不寫；寫完重讀驗證。fish 自動改用 `set -gx` 語法 |
| `tools/model-tags.sh` | 解析 `references/model-tags.md` 的能力標籤與 SDLC 階段必要標籤（`dump` 、`sync` 、`stage {階段}` 、`model {模型 id}` 、`gate {階段} {模型 id}` ）；`sync` 寫出 `$JSC_HOME/model-tags.tsv` 供 `jsc-hooks` 的 sdlc-gate 讀取 |
| `tools/model-tags.sh` | 解析 `references/model-tags.md` 的能力標籤與 SDLC 階段必要標籤（`dump` 、`sync` 、`stage {階段}` 、`model {模型 id}` 、`gate {階段} {模型 id}` ）；`sync` 寫出 `$JSC_HOME/model-tags.tsv` 供 `jsc-hooks` 的 sdlc-gate 讀取。 `gate` 的結束碼 0 為 PASS、1 為缺標籤、2 為模型或階段不在表上， `/jsc-cli:delegate` 依這三碼決定收下或退回 |
| `tools/build-todo.sh` | 把三支檢查腳本的輸出合併成一張「待修項目」表（`--config` 收 `scan-config.sh scan` 、`--wiring {cli}=` 收 `wire-cli.sh status` 、`--version` 收 `version-guard.sh report` ）；類別固定排成 missing、invalid、unwired、落後，一項都沒有時仍印一列「無」。`/jsc-cli:doctor` 與 `/jsc-cli:setup` 共用這一份合併規則，兩邊各寫一次就會各自漂移 |
## Skills 目錄
## Skills 目錄
@@ -41,23 +42,23 @@ Marketplace 統一為 `jsc`（
### `models`
### `models`
用 `tools/list-models.sh` 讀出各已安裝 CLI 可使用的模型並加上能力標籤（ `references/model-tags.md` ） `tools/model-tags.sh sync` 把標籤表寫進 `$JSC_HOME/model-tags.tsv` 供 sdlc-gate 讀取，列出 SDLC 各階段的必要標籤（plan、analyze 需 `reasoning-max` ； `coding` ； ，並用 `tools/model-config.sh` 列出各階段的偏好模型鏈 。`jsc-sdlc` 閘門一律以能力標籤判定，偏好鏈只用來建議切換目標。
**三支腳本併行取得資料 ** ： `tools/detect-clis.sh` 取已安裝 CLI、 `tools/list-models.sh` 讀出各 CLI 可使用的模型、 `tools/model-config.sh list` 取各階段的偏好模型鏈。接著依 `references/model-tags.md` 加上能力標籤 ，用 `tools/model-tags.sh sync` 把標籤表寫進 `$JSC_HOME/model-tags.tsv` 供 sdlc-gate 讀取，並 列出 SDLC 各階段的必要標籤（plan、analyze 需 `reasoning-max` ； `coding` ； `jsc-sdlc` 閘門一律以能力標籤判定，偏好鏈只用來建議切換目標。
### `delegate`
### `delegate`
把單一明確任務交給另一個已安裝的 AI agent CLI 當作 subagent 執行。可指定目標 CLI，也可依任務需求用能力標籤篩選模型，或強制指定模型。每個目標分開派工，預設只讀，並回傳結構化結果 供主 agent 驗證與彙整 。此技能不負責模型盤點或 plugin 部署。
把單一明確任務交給另一個已安裝的 AI agent CLI 當作 subagent 執行。CLI 清單一律取自 `tools/detect-clis.sh` ，模型夠不夠格一律由 `tools/model-tags.sh gate` 的結束碼判定，不讓模型自評標籤。可指定目標 CLI，也可依任務需求用能力標籤篩選模型，或強制指定模型。每個目標分開派工，預設只讀，寫入範圍以路徑清單明列；回傳採固定的 TSV 契約（ `result` 、 `summary` 、 `criterion` 、 `wrote` 、 `error` ）， 供主 agent 逐項 驗證。此技能不負責模型盤點或 plugin 部署。
### `deploy`
### `deploy`
技能庫批次安裝、更新、解除安裝：偵測 CLI → **先比對各 plugin 的本機與已發佈版本並列表，只要有任一個落後就把「更新」設為推薦選項 ** → 決策樹選模式 → 每個 CLI 一個 sub agent 呼叫 `tools/deploy.sh` 執行原生 plugin 指令（統一 marketplace `jsc` ， `jsc-{domain}@jsc` ）→ update 前逐一檢查 `jsc.requires` ，版本不符就跳過該 domain 並回報缺哪一版 → Codex 更新 `jsc-cli` 與 `jsc-hooks` 時保留舊快取相容連結 → install、update 後呼叫 `jsc-hooks:hooks-install` ， 並把每支 CLI 的 smoke 結果納入部署成敗 。domain 名單動態取自 `plugins/meta` 的 marketplace.json，不硬編碼。
技能庫批次安裝、更新、解除安裝：** 偵測 CLI、版本建議、marketplace domain 清單三者併行取得** → 秀出 `jsc-hooks/hooks/version-guard.sh report` 的版本證據表，再依 `recommend` 的一行結論（ `recommend<TAB>{update|none|unverifiable}` ，只印這一行，不混印表格）標出推薦選項；輸出裡找不到 `recommend` 行就退回 `report` 自行推導並在回報寫明是降級路徑 → 決策樹選模式（呼叫方已確認過模式就沿用，不重問） → 每個 CLI 一個 sub agent， `tools/deploy.sh` 執行原生 plugin 指令（統一 marketplace `jsc` ， `jsc-{domain}@jsc` ）→ update 前逐一檢查 `jsc.requires` ，版本不符就跳過該 domain 並回報缺哪一版 → Codex 更新 `jsc-cli` 與 `jsc-hooks` 時保留舊快取相容連結 → install、update 後把偵測到的 CLI 清單交給 `jsc-hooks:hooks-install` ， 取它的彙總結果，只自行加判一條「smoke 出現 `No such file` 一律視為更新失敗」 。domain 名單動態取自 `plugins/meta` 的 marketplace.json，不硬編碼。
### `doctor`
### `doctor`
一次體檢執行環境，只讀不改。四項檢查：技能版本（`jsc-hooks/hooks/version-guard.sh report` ）、Hook 接線（`jsc-hooks/tools/wire-cli.sh status` ，唯讀子命令）、全域設定與自我 設定（`tools/scan-config.sh` 比對 `tools/config-spec.tsv` ）。每項各出一張表， 整份結果寫進 wiki `CHECK_{HASH}` ， `HASH` 取 `{主機名}/{登入帳號}` ，只保留最新一次。修復交給 `/jsc-cli:setup` ，體檢本身不動任何設定。
一次體檢執行環境，只讀不改。四項檢查**同時啟動，各一個 sub agent** ：技能版本（`jsc-hooks/hooks/version-guard.sh report` ）、Hook 接線（`jsc-hooks/tools/wire-cli.sh status` ，唯讀子命令）、設定現況 （ `tools/scan-config.sh scan all ` 比對 `tools/config-spec.tsv` ，一次掃完全域與專案兩個範圍）、漏登錄變數（ `scan-config.sh orphans` ）。唯讀契約下放程式層：呼叫 `wire-cli.sh` 一律帶 `JSC_READONLY=1` ，打錯子命令也不會改到機器。每項各出一張表，專案那張一定寫出掃的是哪個目錄；待修項目由 `tools/build-todo.sh` 合併三份輸出並排序。 整份結果寫進 wiki `CHECK_{HASH}` ， `HASH` 取 `{主機名}/{登入帳號}` ，只保留最新一次。修復交給 `/jsc-cli:setup` ，體檢本身不動任何設定。
### `setup`
### `setup`
修復 `/jsc-cli:doctor` 找出的問題，一次一項，逐項確認才動手。待修清單優先讀 wiki `CHECK_{HASH}` ，沒有頁面就當場重掃一份 。依修法分流：`auto` 用 `tools/apply-config.sh` 直接寫、`ask` 先用決策樹問到值再寫、`manual` 印出步驟交給操作者。複合修復交回原主：版本落後找 `/jsc-cli:deploy` 、hook 未接線找 `/jsc-hooks:hooks-install` 、缺 `model-tags.tsv` 找 `/jsc-cli:models` 。每一項 寫完都 重驗一次， 最後覆寫 CHECK 頁。
修復 `/jsc-cli:doctor` 找出的問題，一次一項，逐項確認才動手。待修清單優先讀 wiki `CHECK_{HASH}` ，沒有頁面就當場重掃： `tools/build-todo.sh` 合併成同一張表 。依修法分流：`auto` 用 `tools/apply-config.sh` 直接寫、`ask` 先用決策樹問到值再寫、`manual` 印出步驟交給操作者。複合修復交回原主：版本落後找 `/jsc-cli:deploy` （連同已確認的模式與版本報告一起傳過去，不讓它重問重查） 、hook 未接線找 `/jsc-hooks:hooks-install` 、缺 `model-tags.tsv` 找 `/jsc-cli:models` 。逐項確認維持循序，** 寫完的 重驗併行**；環境變數類只驗「rc 段落裡確實有那一行」，環境層面交給下一次 `/jsc-cli:doctor` 。 最後覆寫 CHECK 頁。
<!-- JSC-SKILLS:END -->
<!-- JSC-SKILLS:END -->