feat(hooks): 補上合併超集 hooks.json 並升版 0.0.11 #15

Merged
admin merged 3 commits from develop into master 2026-07-28 08:17:22 +00:00
Member

變更內容

Commit 說明
377121d 新增 hooks/hooks.json(合併超集載體)
729e6e7 三份 manifest 升版 0.0.10 → 0.0.11

code 本身沒有 hook 腳本,此檔僅作為超集載體,讓 code 贏得 hook 註冊時 worklog 與角色功能仍完整可用。

背景

三個 plugin repo(codedocgeneric)的 plugin.json 名稱都是 jsc,Claude Code 以 plugin 名稱為鍵註冊 hooks,同名時只保留一份,且無法預期哪一份會贏。實測本工作階段 stop_hook_summaryhookCount 為 2(單一 plugin 的 hooks.json + 使用者 settings.json 的後援 hook),而非三個 plugin 疊加的 3 —— 證實只有一份 plugin hooks.json 生效。

因此三個 repo 的 hooks/hooks.json 必須是同一份合併超集(worklog 的 Stop + role 的 SessionStartStop),否則贏得註冊的那一份缺少的 hook 會靜默失效。每個 hook 指令也不得假設 CLAUDE_PLUGIN_ROOT 指向擁有該腳本的 plugin,需先試 $CLAUDE_PLUGIN_ROOT,找不到再依「擁有者 marketplace 優先 → 全 cache 後援」搜尋 ~/.claude~/.codex 快取。

版號

origin/master 現行 0.0.10 → 本 PR 0.0.11,plugin.json.claude-plugin/plugin.json.codex-plugin/plugin.json 三份同步。hooks/hooks.json 為新增檔案,需升版才會重建版本化快取目錄並被載入。

🤖 Generated with Claude Code

## 變更內容 | Commit | 說明 | | --- | --- | | `377121d` | 新增 `hooks/hooks.json`(合併超集載體) | | `729e6e7` | 三份 manifest 升版 0.0.10 → 0.0.11 | `code` 本身沒有 hook 腳本,此檔僅作為超集載體,讓 `code` 贏得 hook 註冊時 worklog 與角色功能仍完整可用。 ## 背景 三個 plugin repo(`code`/`doc`/`generic`)的 `plugin.json` 名稱都是 `jsc`,Claude Code **以 plugin 名稱為鍵註冊 hooks**,同名時只保留一份,且無法預期哪一份會贏。實測本工作階段 `stop_hook_summary` 的 `hookCount` 為 2(單一 plugin 的 hooks.json + 使用者 `settings.json` 的後援 hook),而非三個 plugin 疊加的 3 —— 證實只有一份 plugin hooks.json 生效。 因此三個 repo 的 `hooks/hooks.json` **必須是同一份合併超集**(worklog 的 `Stop` + role 的 `SessionStart`/`Stop`),否則贏得註冊的那一份缺少的 hook 會靜默失效。每個 hook 指令也不得假設 `CLAUDE_PLUGIN_ROOT` 指向擁有該腳本的 plugin,需先試 `$CLAUDE_PLUGIN_ROOT`,找不到再依「擁有者 marketplace 優先 → 全 cache 後援」搜尋 `~/.claude`/`~/.codex` 快取。 ## 版號 `origin/master` 現行 0.0.10 → 本 PR 0.0.11,`plugin.json`/`.claude-plugin/plugin.json`/`.codex-plugin/plugin.json` 三份同步。`hooks/hooks.json` 為新增檔案,需升版才會重建版本化快取目錄並被載入。 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jiantw83 added 2 commits 2026-07-28 06:30:52 +00:00
三個 repo 的 plugin.json 名稱都是 jsc,Claude Code 以 plugin 名稱為鍵註冊
hooks,同名時只保留一份(實測 stop_hook_summary 的 hookCount 為 1),無法
預期哪一份會贏。因此每個 repo 都必須帶同一份合併超集,否則贏的那份缺少的
hook 會靜默失效。

code 本身沒有 hook 腳本,此檔僅作為超集載體:SessionStart 載入角色、Stop
執行 worklog 與角色記憶記錄;指令先試 CLAUDE_PLUGIN_ROOT,找不到再依
「擁有者 marketplace 優先 → 全 cache 後援」搜尋 ~/.claude 與 ~/.codex 快取。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
hooks/hooks.json 為新增檔案,需升版才會重建版本化快取目錄並被載入。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
admin approved these changes 2026-07-28 08:14:42 +00:00
Dismissed
jiantw83 added 1 commit 2026-07-28 08:16:32 +00:00
admin approved these changes 2026-07-28 08:17:19 +00:00
admin merged commit c9a422caae into master 2026-07-28 08:17:22 +00:00
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/code#15