refactor(plugin 命名空間): plugin 更名 jsc-doc、hooks 只註冊 worklog #42

2026-07-28T09:08:14Z

jiantw83 commented

2026-07-28 09:08:14 +00:00

目的

把 plugin 命名空間分離，根治「同名 plugin 只註冊一份 hooks」造成的隱性失效與維護負擔。

背景

code／doc／generic（含未安裝的 code-review／template）的 plugin.json 名稱原本都是 jsc。Claude Code 以 plugin 名稱為鍵註冊 hooks，同名時只保留一份且無法預期哪一份會贏，因此三份 hooks/hooks.json 過去必須維持同一份合併超集 —— 任一 repo 漏同步，缺少的 hook 會靜默失效。

實測本次改動前 stop_hook_summary 的 hookCount 為 3（plugin 的 worklog + role_capture 各 1，加使用者 settings.json 後援 1），確認同名確實只生效一份。

改動

項目	內容
plugin 名稱	`jsc` → `jsc-code`／`jsc-doc`／`jsc-generic`／`jsc-review`／`jsc-template`，五份 manifest 同步
hooks 拆分	各 plugin 只註冊自己擁有的 hook；`jsc-generic` 管 role、`jsc-doc` 管 worklog、`jsc-code` 不再需要 `hooks.json`
skill 名稱	去掉與 plugin 名重複的領域前綴（`code-action-docker` → `action-docker`、`doc-funcs` → `funcs`）
指令引用	全庫 831 處 `/jsc:` 改為對應命名空間前綴

注意

改名等同新 plugin，合併後需移除舊 plugin 再安裝新 plugin，並重開工作階段。

🤖 Generated with Claude Code

## 目的把 plugin 命名空間分離，根治「同名 plugin 只註冊一份 hooks」造成的隱性失效與維護負擔。 ## 背景 `code`／`doc`／`generic`（含未安裝的 `code-review`／`template`）的 `plugin.json` 名稱原本都是 `jsc`。Claude Code 以 plugin 名稱為鍵註冊 hooks，同名時只保留一份且無法預期哪一份會贏，因此三份 `hooks/hooks.json` 過去必須維持同一份合併超集 —— 任一 repo 漏同步，缺少的 hook 會**靜默失效**。實測本次改動前 `stop_hook_summary` 的 `hookCount` 為 3（plugin 的 worklog + role_capture 各 1，加使用者 settings.json 後援 1），確認同名確實只生效一份。 ## 改動 | 項目 | 內容 | | --- | --- | | plugin 名稱 | `jsc` → `jsc-code`／`jsc-doc`／`jsc-generic`／`jsc-review`／`jsc-template`，五份 manifest 同步 | | hooks 拆分 | 各 plugin 只註冊自己擁有的 hook；`jsc-generic` 管 role、`jsc-doc` 管 worklog、`jsc-code` 不再需要 `hooks.json` | | skill 名稱 | 去掉與 plugin 名重複的領域前綴（`code-action-docker` → `action-docker`、`doc-funcs` → `funcs`） | | 指令引用 | 全庫 831 處 `/jsc:` 改為對應命名空間前綴 | ## 注意改名等同新 plugin，合併後需**移除舊 plugin 再安裝新 plugin**，並重開工作階段。 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jiantw83 added 1 commit 2026-07-28 09:08:14 +00:00

refactor(plugin 命名空間): plugin 更名 jsc-doc、hooks 只註冊自己擁有的 worklog 67106b22c3

- 五份 manifest 的 name 由 jsc 改為 jsc-doc
- skill 目錄去掉重複的 doc- 前綴共 5 個（doc-funcs → funcs 等），worklog 名稱不變，frontmatter name 同步
- hooks/hooks.json 由合併超集改為只註冊 Stop（worklog）：role 的 hook 交還 jsc-generic，避免改名後重複執行
- hook 腳本搜尋路徑與文件內 cache 路徑改指 jsc-doc
- 指令引用改為 /jsc-doc: 前綴；跨 plugin 引用指向 /jsc-code:、/jsc-generic:
- 保留 .docs/doc-funcs-index.md 等產物檔名不變（非 skill 識別名）
- 版號 0.2.6 → 0.2.7

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

jiantw83 added 1 commit 2026-07-28 09:15:32 +00:00

chore(plugin 版本): 更名視為新 plugin，版號重置 0.0.1 814e81e037

plugin 更名後，各助理以 <plugin 名>@<marketplace 名> 作為安裝識別鍵，
新名與舊名是兩筆獨立條目：舊 plugin 會被移除、新 plugin 為首次安裝，
兩者之間不存在版本比較，因此不會發生版本倒退，「版本單調遞增」不適用。

依 spec-plugin-version「新 plugin 首發 0.0.1」，三份 manifest 版號一律重置為 0.0.1，
不沿用舊名 jsc 的版本序列。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

admin approved these changes 2026-07-28 09:17:27 +00:00

admin merged commit e9c021adbe into master

2026-07-28 09:17:29 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#42