fix/remove-duplicate-hooks-manifest-entry #3

2026-08-21T08:31:13Z

jiantw83 commented

2026-08-21 08:31:13 +00:00

摘要

需求描述：修正 jsc-hooks 外掛在 claude CLI 載入失敗的問題。claude plugin list 回報 Hook load failed: Duplicate hooks file detected——標準路徑 hooks/hooks.json 已被自動載入，manifest 再宣告同一份檔案造成重複載入而使外掛整個載入失敗。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`.claude-plugin/plugin.json`	移除重複宣告的 `"hooks": "./hooks/hooks.json"` 欄位（標準 hooks/hooks.json 會自動載入，manifest.hooks 只該宣告額外 hook 檔）；版本 0.0.1 → 0.0.2
`plugin.json`	版本同步升到 0.0.2，讓各 CLI 的 plugin update 能抓到新版
`.codex-plugin/plugin.json`	版本同步升到 0.0.2，維持三份 manifest 版本一致

設計重點

只刪除多餘的 manifest.hooks 欄位，不動 hooks/hooks.json 本體：hooks 內容沒有問題，問題在同一份檔案被載入兩次。
三份 manifest（claude、codex、根目錄）版本一律同步升版，避免各 CLI 之間版本漂移。
修正後 STE100 語言強制、工時計時、技能用量記錄三組 hooks 可在 claude CLI 恢復生效。

測試結果

本地以 python3 -m json.tool 驗證 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest，JSON 格式全部正確。
claude 端的實際載入驗證需待本 PR 合併後，在各 CLI 執行 plugin update 更新到 0.0.2 版才能確認 claude plugin list 不再回報載入失敗。

前置 Push Request

無

## 摘要 - 需求描述：修正 jsc-hooks 外掛在 claude CLI 載入失敗的問題。`claude plugin list` 回報 `Hook load failed: Duplicate hooks file detected`——標準路徑 `hooks/hooks.json` 已被自動載入，manifest 再宣告同一份檔案造成重複載入而使外掛整個載入失敗。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `.claude-plugin/plugin.json` | 移除重複宣告的 `"hooks": "./hooks/hooks.json"` 欄位（標準 hooks/hooks.json 會自動載入，manifest.hooks 只該宣告額外 hook 檔）；版本 0.0.1 → 0.0.2 | | `plugin.json` | 版本同步升到 0.0.2，讓各 CLI 的 plugin update 能抓到新版 | | `.codex-plugin/plugin.json` | 版本同步升到 0.0.2，維持三份 manifest 版本一致 | ## 設計重點 - 只刪除多餘的 `manifest.hooks` 欄位，不動 `hooks/hooks.json` 本體：hooks 內容沒有問題，問題在同一份檔案被載入兩次。 - 三份 manifest（claude、codex、根目錄）版本一律同步升版，避免各 CLI 之間版本漂移。 - 修正後 STE100 語言強制、工時計時、技能用量記錄三組 hooks 可在 claude CLI 恢復生效。 ## 測試結果 - 本地以 `python3 -m json.tool` 驗證 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest，JSON 格式全部正確。 - claude 端的實際載入驗證需待本 PR 合併後，在各 CLI 執行 plugin update 更新到 0.0.2 版才能確認 `claude plugin list` 不再回報載入失敗。 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-08-21 08:31:13 +00:00

fix(hooks): 移除 manifest 重複的 hooks 設定並升版至 0.0.2 97fdeb9211

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>

admin approved these changes 2026-08-21 09:11:34 +00:00

admin merged commit 37c2856893 into develop

2026-08-21 09:11:39 +00:00

admin deleted branch fix/remove-duplicate-hooks-manifest-entry

2026-08-21 09:11:39 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/hooks#3