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

2026-08-24T06:49:58Z

jiantw83 commented

2026-08-24 06:49:58 +00:00

PR 描述範本

摘要

需求描述：同步 marketplace.json 與正典註冊表，並將 hooks-install 技能的 CLI 佈線邏輯抽離為腳本（jsc-meta:skill-check 稽核修正）
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`.agents/plugins/marketplace.json`	與 `plugins/jsc` 正典 marketplace 註冊表不同步，補上缺漏的頂層 `description`、`owner.description`，以及全部 11 個外掛的 per-plugin `description` 欄位
`.claude-plugin/marketplace.json`	修正 jsc-meta 描述的標點不一致（斜線改為中文頓號），與正典風格一致
`tools/wire-cli.sh`（新增）	將原本內嵌於 SKILL.md 的各 CLI（codex／copilot／antigravity／kiro）佈線步驟抽離為獨立、冪等的腳本，輸出機器可讀的 `status=wired\|degraded\|skipped reason=...` 與對應結束碼
`skills/hooks-install/SKILL.md`	符合 jsc-meta:skill-check 稽核準則：確定性程序邏輯應由腳本執行，不應留給子代理每次自行解讀 prose；改為呼叫 `tools/wire-cli.sh {cli}` 並讀取其 status／結束碼
`README.md`	新增 `tools/wire-cli.sh` 工具說明列，改寫 hooks-install skill 描述段落以反映新的腳本驅動流程
`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`	版本號自 0.0.3 升級為 0.0.4，對應本次行為變更

設計重點

確定性的、依 CLI 而定的佈線程序（設定檔編輯、wrapper 別名安裝、標記區塊冪等取代）應該封裝在腳本裡，而不是留在 SKILL.md 的 prose 中讓子代理每次重新解讀；腳本以固定的 status= 首行與結束碼回報結果，讓技能可以直接判讀而不必自行重算佈線結果。

測試結果

tools/wire-cli.sh 已在隔離的 sandbox（獨立 HOME／PATH）中針對 claude、codex、kiro 等 CLI 引數逐一測試過，確認各分支行為與 status／結束碼皆符合預期。
已確認重複執行（idempotency）不會造成標記區塊重複疊加或內容毀損。
已跑過 ste100-lint，結果乾淨無違規。
以上測試皆已於前次處理中完成驗證。

前置 Push Request

無

# PR 描述範本 ## 摘要 - 需求描述：同步 marketplace.json 與正典註冊表，並將 hooks-install 技能的 CLI 佈線邏輯抽離為腳本（jsc-meta:skill-check 稽核修正） - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `.agents/plugins/marketplace.json` | 與 `plugins/jsc` 正典 marketplace 註冊表不同步，補上缺漏的頂層 `description`、`owner.description`，以及全部 11 個外掛的 per-plugin `description` 欄位 | | `.claude-plugin/marketplace.json` | 修正 jsc-meta 描述的標點不一致（斜線改為中文頓號），與正典風格一致 | | `tools/wire-cli.sh`（新增） | 將原本內嵌於 SKILL.md 的各 CLI（codex／copilot／antigravity／kiro）佈線步驟抽離為獨立、冪等的腳本，輸出機器可讀的 `status=wired\|degraded\|skipped reason=...` 與對應結束碼 | | `skills/hooks-install/SKILL.md` | 符合 jsc-meta:skill-check 稽核準則：確定性程序邏輯應由腳本執行，不應留給子代理每次自行解讀 prose；改為呼叫 `tools/wire-cli.sh {cli}` 並讀取其 status／結束碼 | | `README.md` | 新增 `tools/wire-cli.sh` 工具說明列，改寫 hooks-install skill 描述段落以反映新的腳本驅動流程 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 版本號自 0.0.3 升級為 0.0.4，對應本次行為變更 | ## 設計重點 - 確定性的、依 CLI 而定的佈線程序（設定檔編輯、wrapper 別名安裝、標記區塊冪等取代）應該封裝在腳本裡，而不是留在 SKILL.md 的 prose 中讓子代理每次重新解讀；腳本以固定的 `status=` 首行與結束碼回報結果，讓技能可以直接判讀而不必自行重算佈線結果。 ## 測試結果 - `tools/wire-cli.sh` 已在隔離的 sandbox（獨立 HOME／PATH）中針對 claude、codex、kiro 等 CLI 引數逐一測試過，確認各分支行為與 status／結束碼皆符合預期。 - 已確認重複執行（idempotency）不會造成標記區塊重複疊加或內容毀損。 - 已跑過 ste100-lint，結果乾淨無違規。 - 以上測試皆已於前次處理中完成驗證。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-24 06:49:59 +00:00

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

為什麼：
`.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 邏輯或執行行為。

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

為什麼：
`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 佈線行為。

admin approved these changes 2026-08-24 07:58:36 +00:00

admin merged commit b8d0be9c10 into develop

2026-08-24 07:58:40 +00:00

admin deleted branch fix/sync-marketplace-and-hooks-install-script

2026-08-24 07:58:40 +00:00

jiantw83 referenced this pull request

2026-08-24 08:10:32 +00:00

發佈 jsc-hooks 0.0.5：SDLC 階段閘門程式化與包裝啟動器 #8

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/hooks#6