plugins/hooks
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
105 Commits 12 Branches 0 Tags
f6335180facaf4078d77a2c9d3aa0f9522142f5e
Commit Graph
27 Commits
Author SHA1 Message Date
jiantw83 0556512ebf chore(hooks): 三份 manifest 版本升到 0.2.6 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 從 0.2.5 升到 0.2.6，三份同步，description 不動。

Why：這一輪改掉重啟閘門的狀態檔路徑與範圍，是使用者裝上去就會拿到的行為變更。版本不升，`version-guard.sh` 的版本前置檢查與 `jsc-cli:deploy` 的落後判定都看不出本機還是舊版，機器上就不會被提示更新。

How：只改版號一個欄位。三份必須一致：`plugin.json` 給 marketplace、`.claude-plugin` 給 claude、`.codex-plugin` 給 codex，任一份落後都會讓那一路的版本比對抓錯。修的是既有行為的缺陷、沒有新增子命令也沒有改變呼叫介面，所以走修訂號。

Who：`jsc-hooks` 的三份 plugin manifest，配合這一輪重啟閘門的修正發佈。
 2026-08-27 18:49:58 +08:00
jiantw83 7d67538a2a docs(hooks-install): 豁免清單補齊為九支，與實作和準則對齊 
What：`skills/hooks-install/SKILL.md` 的 Notes 段落，重啟閘門的豁免技能清單從六支補到九支，補上 `jsc-ask:ask`、`jsc-git:pr`、`jsc-git:commit`，並寫明「閘門認技能名不認呼叫鏈」以及清單的唯一來源在 `hooks/restart-gate.sh`。

Why：這三支是使用者在同一輪追問後才裁定加入的，實作 `hooks/restart-gate.sh` 與準則 `guidelines.md`「部署後重啟閘門」都已經是九支，只有這份技能文件還停在六支。技能文件是接線時唯一會被讀到的說明，少列三支會讓人以為 `deploy` 問模式、收尾開 PR 都會被擋，反而去下逃生門。

How：只改那一行，補上三支與兩句說明，並指向清單的唯一來源，避免下次又各自維護一份。三份 manifest 版本同步升到 0.2.5。

Who：`jsc-hooks:hooks-install` 技能文件，以及部署後重啟閘門這條規則的說明一致性。
 2026-08-27 16:49:02 +08:00
jiantw83 4f92c48e10 chore(manifest): 三份 manifest 版本升到 0.2.4，描述補齊八支 hook 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.2.3 改為 0.2.4，`description` 的 hook 清單從五支補齊到八支，補上註解範圍守門、繁中編碼守門與部署後強制重啟。

Why：本次新增第八支 hook `restart-gate.sh` 並接進 `hooks.json`，`session-timer.sh` 多了清除閘門這件事，接線與冒煙也跟著改，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。`description` 原本只列到「版本前置檢查」，而註解範圍與繁中編碼兩支早就在跑了，`README.md` 與 `AGENTS.md` 也都寫了八支——manifest 是各 CLI 安裝時唯一看得到的說明，落後就會讓人以為這個外掛只有五支 hook。

How：三份只改 `version` 與 `description` 兩個欄位，其餘內容不動，三份保持同一版號與同一段描述。

Who：`jsc-hooks` 外掛的套件描述檔。
 2026-08-27 16:34:17 +08:00
jiantw83 be75cc4bed chore(manifest): 三份 manifest 版本升到 0.2.3 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.2.2 改為 0.2.3。

Why：本次新增 `wp-claim`、`wp-unclaim` 兩個子命令並改了鎖檔格式，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-hooks` 外掛的套件描述檔。
 2026-08-27 11:20:28 +08:00
jiantw83 667b60c8e9 feat(manifest): 三份 manifest 版本升到 0.2.2 
What：三份 manifest 由 0.2.1 升到 0.2.2。

Why：字表擴充後偵測能力大幅改變，本機沒跟著升版，version-guard.sh 就判不出落後，
使用者不會收到更新提示，繼續用覆蓋率只有兩成的舊字表。

How：以 jsc-meta 的 sync-skill-manifest.sh 統一 bump，三份同步成同一個值。

Who：非程式碼輸出的繁中無亂碼檢查。
 2026-08-27 09:53:55 +08:00
jiantw83 aee2f19699 feat(manifest): 三份 manifest 版本升到 0.2.1 
What：把 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest 的版本由 0.2.0 升到 0.2.1。

Why：0.2.0 已隨前一支 PR 發佈出去，本次新增的第七支 hook 與五個 CLI 的接線沒有跟著升版，`version-guard.sh` 就看不出本機落後，使用者不會收到更新提示。

How：以 jsc-meta 的 `sync-skill-manifest.sh` 統一 bump，patch 進位，三份同步成同一個值。

Who：繁中與編碼檢查 hook 的跨 CLI 支援。
 2026-08-27 09:50:03 +08:00
jiantw83 542f0aab2c feat(manifest): 三份 manifest 版本升到 0.2.0 
What：把 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份
manifest 的版本由 0.1.9 升到 0.2.0。

Why：0.1.9 已隨前一支 PR 發佈出去，本次新增的 sweep 模式與四支 CLI 的接線
沒有跟著升版，version-guard.sh 就看不出本機落後，使用者不會收到更新提示。

How：以 jsc-meta 的 sync-skill-manifest.sh 統一 bump，minor 進位、patch 歸零，
三份同步成同一個值。

Who：註解範圍檢查 hook 的跨 CLI 支援。
 2026-08-27 09:20:44 +08:00
jiantw83 7690b697c7 feat(manifest): 三份 manifest 版本升到 0.1.9 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest 的 `version` 由 0.1.8 升到 0.1.9。

Why：本次新增了第六支 hook，屬於功能增修。版本不升，`version-guard.sh` 的版本前置檢查與 `jsc-cli:deploy` 的更新判斷都看不出本機落後，使用者不會收到更新提示。

How：三份檔案同步改同一個版本號，維持三份 manifest 版本一致的既有慣例。

Who：`jsc-hooks` 的發佈中繼資料，供 `hooks/version-guard.sh` 與 `jsc-cli:deploy` 比對版本。
 2026-08-26 19:01:36 +08:00
jiantw83 f1bcdc3d72 feat(wire-cli): 新增唯讀的接線盤點子命令 
What: wire-cli.sh 新增 status 子命令，只讀設定檔判斷 jsc 標記段落在不在，不寫檔也不執行 hook。每個接線點印一行 item，以 status=wired、degraded、unwired、skipped 回報。
Why: 體檢類技能要問「hook 接線在不在」，但既有三個子命令都會動到環境：不帶子命令會重新接線、purge 會刪掉、smoke 會真的執行 hook。體檢不該有副作用。
How: 沿用底下接線區塊的同一組檔案位置與標記字串，共用 has_block、toml_root_key、json_top_key 三個判讀函式。codex 的 notify 另外單獨檢查是否落在根層，標記在、鍵被歸進表裡時 codex 讀不到，等同沒接。
Who: 供 jsc-cli:doctor 呼叫的接線檢查。
 2026-08-26 10:44:47 +08:00
jiantw83 65d3c13d22 chore(hooks): 三份 manifest 同步升版到 0.1.7 2026-08-25 18:59:29 +08:00
jiantw83 e62511b57f chore(hooks): 三份 manifest 同步升版到 0.1.6 2026-08-25 18:18:10 +08:00
jiantw83 ad2f944a66 fix(hooks): 修正版本號為單位數格式 2026-08-25 16:39:49 +08:00
jiantw83 c68292acbc feat(hooks): 自動接手失敗接線與修復流程 2026-08-25 16:33:38 +08:00
jiantw83andClaude Opus 5 2982ca4e9f chore(hooks): 三份 manifest 同步升版並同步 marketplace 正本 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 99f5747b9e chore(plugin 版本): 三份 manifest 升版至 0.0.9 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 13:03:17 +08:00
jiantw83andClaude Opus 5 3b0c8f0e33 chore(plugin 版本): 三份 manifest 升版至 0.0.8 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 11:52:38 +08:00
jiantw83andClaude Opus 5 9b6cfb9d2e chore(plugin 版本): 三份 manifest 升版至 0.0.7 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:54:19 +08:00
jiantw83andClaude Opus 5 fdde05e825 chore(plugin 版本): 三份 manifest 升版至 0.0.6 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 cacd234869 chore(plugin 版本): 三份 manifest 升版至 0.0.5 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 16:05:18 +08:00
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
jiantw83andClaude Fable 5 aae0516cb5 chore(manifest): 三份 manifest 升版至 0.0.3 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本由 0.0.2 升至 0.0.3，描述補上「SDLC 模型鎖」。
Why：本次新增 SDLC 模型鎖 hook 與 wrapper 工具屬功能擴充，需升版讓各 CLI 的 plugin 更新機制抓到新版本，描述也要反映新能力。
How：三份 manifest 同步改 version 與 description，維持欄位結構不變。
Who：透過 jsc marketplace 安裝 jsc-hooks 的所有 AI CLI 與 jsc-cli:deploy 佈署流程。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:37:08 +08:00
jiantw83andClaude Fable 5 97fdeb9211 fix(hooks): 移除 manifest 重複的 hooks 設定並升版至 0.0.2 
What（改了什麼）：
刪除 .claude-plugin/plugin.json 中的 "hooks": "./hooks/hooks.json" 欄位，
並將 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json
三份 manifest 的版本號從 0.0.1 升到 0.0.2。

Why（為什麼改）：
claude plugin list 回報 jsc-hooks 載入失敗（Hook load failed:
Duplicate hooks file detected）。Claude Code 會自動載入標準路徑
hooks/hooks.json，manifest 再宣告同一份檔案就造成重複載入，
manifest.hooks 只該用來宣告額外的 hook 檔。

How（怎麼改）：
移除多餘的 manifest.hooks 欄位，讓 hooks/hooks.json 只透過標準
自動載入機制載入一次；同步升版三份 manifest 以觸發各 CLI 的
plugin update，並以 python3 -m json.tool 驗證三份 JSON 格式正確。

Who（影響哪個功能／使用者）：
影響 jsc-hooks 外掛的所有使用者。修正後外掛可在 claude CLI 正常
載入，STE100 語言強制、工時計時、技能用量記錄等 hooks 恢復生效。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 08:31:12 +00:00
jiantw83andClaude Fable 5 805befc13c chore(hooks): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:47 +08:00
jiantw83andClaude Fable 5 c628361f52 chore(hooks): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:36 +08:00
jiantw83andClaude Fable 5 18a22ce640 chore(hooks): 修正範本 manifest 與移除 hello 範例符合 hooks 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00
jiantw83 57c7191108 Initial commit 2026-08-21 04:42:09 +00:00