fix/sync-marketplace-and-hooks-install-script

Conversation 1 Commits 2 Files Changed 8

+188 -24

2 Commits

Author	SHA1	Message	Date
jiantw83	69eee91f27	feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本為什麼： `skills/hooks-install/SKILL.md` 原本直接內嵌各 CLI（codex／copilot／antigravity／kiro）的詳細佈線步驟，包含逐步設定檔修改、wrapper alias 安裝、以及 `<!-- jsc-hooks -->` 標記區塊的冪等替換邏輯，違反 jsc-meta:skill-check 稽核準則中「確定性程序邏輯應由腳本執行，不應留給子代理每次自行解讀 prose」的要求。做了什麼：新增腳本 `tools/wire-cli.sh {cli}`，將原本內嵌於 SKILL.md 的佈線邏輯全數抽出，並支援冪等執行（標記區塊替換、可安全重跑），輸出機器可讀的 `status=wired\|degraded\|skipped reason=...` 首行訊息與對應結束碼（0=wired、1=degraded、2=bad usage、3=skipped）。改寫 `skills/hooks-install/SKILL.md`，改為依偵測到的 CLI 呼叫此腳本，並讀取其 status／結束碼判斷結果，不再自行內含佈線步驟。同步更新 `README.md`：在工具表新增 `tools/wire-cli.sh` 說明列，並改寫 hooks-install skill 的描述段落，反映新的腳本驅動流程與 `status=` 回報慣例。三份外掛清單 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本號自 0.0.3 升級為 0.0.4，對應此行為變更。怎麼做：建立獨立腳本承載原本的 CLI 佈線程序邏輯，改造 SKILL.md 為呼叫腳本並解讀其標準化輸出，同步更新文件與版本號。影響範圍： `skills/hooks-install/SKILL.md`、`README.md`、`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、新增檔案 `tools/wire-cli.sh`；影響 hooks-install skill 的執行流程與所有安裝 jsc-hooks 外掛的 CLI 佈線行為。	2026-08-24 14:47:46 +08:00
jiantw83	c4909e1a1f	fix(marketplace): 修正 marketplace.json 與正典註冊表不同步的欄位缺漏為什麼： `.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json` 兩份檔案內容與 `plugins/jsc` 正典 marketplace 註冊表不一致，導致各 domain repo 的 marketplace 副本無法保持逐位元組同步。做了什麼：補上 `.agents/plugins/marketplace.json` 缺漏的頂層 `description`、`owner` 物件的 `description`，以及全部 11 個外掛（含 jsc-hooks 本身）缺漏的 per-plugin `description` 欄位；同時修正 `.claude-plugin/marketplace.json` 中 jsc-meta 描述的標點不一致問題，將斜線改為中文頓號，與正典風格一致。怎麼做：逐欄位比對正典 `plugins/jsc/marketplace.json` 內容，補齊並修正兩份檔案至與正典完全一致。影響範圍： `.claude-plugin/marketplace.json`、`.agents/plugins/marketplace.json`，屬全 repo 範圍的基礎設施修正，不影響任何 skill 邏輯或執行行為。	2026-08-24 14:47:36 +08:00

Author

SHA1

Message

Date

jiantw83

69eee91f27

feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本

為什麼：
`skills/hooks-install/SKILL.md` 原本直接內嵌各 CLI（codex／copilot／antigravity／kiro）的詳細佈線步驟，包含逐步設定檔修改、wrapper alias 安裝、以及 `<!-- jsc-hooks -->` 標記區塊的冪等替換邏輯，違反 jsc-meta:skill-check 稽核準則中「確定性程序邏輯應由腳本執行，不應留給子代理每次自行解讀 prose」的要求。

做了什麼：
新增腳本 `tools/wire-cli.sh {cli}`，將原本內嵌於 SKILL.md 的佈線邏輯全數抽出，並支援冪等執行（標記區塊替換、可安全重跑），輸出機器可讀的 `status=wired|degraded|skipped reason=...` 首行訊息與對應結束碼（0=wired、1=degraded、2=bad usage、3=skipped）。改寫 `skills/hooks-install/SKILL.md`，改為依偵測到的 CLI 呼叫此腳本，並讀取其 status／結束碼判斷結果，不再自行內含佈線步驟。同步更新 `README.md`：在工具表新增 `tools/wire-cli.sh` 說明列，並改寫 hooks-install skill 的描述段落，反映新的腳本驅動流程與 `status=` 回報慣例。三份外掛清單 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本號自 0.0.3 升級為 0.0.4，對應此行為變更。

怎麼做：
建立獨立腳本承載原本的 CLI 佈線程序邏輯，改造 SKILL.md 為呼叫腳本並解讀其標準化輸出，同步更新文件與版本號。

影響範圍：
`skills/hooks-install/SKILL.md`、`README.md`、`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、新增檔案 `tools/wire-cli.sh`；影響 hooks-install skill 的執行流程與所有安裝 jsc-hooks 外掛的 CLI 佈線行為。

2026-08-24 14:47:46 +08:00

jiantw83

c4909e1a1f

fix(marketplace): 修正 marketplace.json 與正典註冊表不同步的欄位缺漏

為什麼：
`.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json` 兩份檔案內容與 `plugins/jsc` 正典 marketplace 註冊表不一致，導致各 domain repo 的 marketplace 副本無法保持逐位元組同步。

做了什麼：
補上 `.agents/plugins/marketplace.json` 缺漏的頂層 `description`、`owner` 物件的 `description`，以及全部 11 個外掛（含 jsc-hooks 本身）缺漏的 per-plugin `description` 欄位；同時修正 `.claude-plugin/marketplace.json` 中 jsc-meta 描述的標點不一致問題，將斜線改為中文頓號，與正典風格一致。

怎麼做：
逐欄位比對正典 `plugins/jsc/marketplace.json` 內容，補齊並修正兩份檔案至與正典完全一致。

影響範圍：
`.claude-plugin/marketplace.json`、`.agents/plugins/marketplace.json`，屬全 repo 範圍的基礎設施修正，不影響任何 skill 邏輯或執行行為。

2026-08-24 14:47:36 +08:00

fix/sync-marketplace-and-hooks-install-script #6