fulin 的自製 Claude Code plugin monorepo。核心是 plugin-manager——一個「管理所有自製 plugin」的 meta-plugin;本 repo 同時也是它管理出來的 marketplace。
解決的痛:Claude Code 官方做法常是「一個 plugin = 一個 git repo」。寫 500 個自製 plugin 就有 500 個 repo,無法維護。
plugin-manager 的解法:所有自製 plugin 全收進同一個 monorepo(就是本 repo 的 plugins/),永遠只有 1 個 repo 要維護。它再提供一套指令管理這些 plugin 的納管、版本、發布、與專案啟用。
| 指令 | 做什麼 |
|---|---|
/plugin-manager-adopt |
把你在某專案 .claude/skills/ 隨手寫的自製 skill,搬進 monorepo(move + 原位 symlink,真身永遠一份,零不同步)。agent 整包納管見 scripts/adopt-agents.js |
/plugin-manager-bump |
(開發端)改既有自製 plugin 後 bump 版本號(plugin.json + registry 同步 + CHANGELOG),讓更新能被偵測 |
/plugin-manager-publish |
一鍵 commit + push 整個 monorepo。不管改了 1 個還是 50 個 plugin,只推一次 |
/plugin-manager-update |
(使用端)把這台電腦所有專案與 user 層已裝的 fulin plugin 批次更新到 marketplace 最新版(先 dry-run 給你看,核可後才套用;巢狀專案漏更新會自動重裝補救) |
/setup-plugins |
偵測當前專案(讀 CLAUDE.md 為主訊號)→ 推薦該裝哪些 plugin(profile / 自訂)→ 核可後由 Claude 直接跑 claude plugin install --scope project 裝好(venv 概念,per-project 隔離)。不手寫 settings——啟用宣告由 install CLI 依 scope 自己寫。含 upgrade(偵測落後版本)與外部 plugin 推薦(recommends.json,會推廣)/挑裝 |
/plugin-manager-clone-env |
把整套環境(marketplace + plugin + 啟用狀態,含自製與第三方)擷取快照、在新機器/新專案復現。說「複製我的環境」即觸發 |
跟 Claude 說「複製我的環境」「環境復現」即觸發。Claude 幫你擷取快照(export-env.js → env-snapshot.json)並產生復現指令鏈(restore-env.js,--enabled-only 只列啟用中的);實際安裝那幾步 claude plugin marketplace add + claude plugin install 是非互動 CLI,你核可後由 Claude 直接跑;最後的 /reload-plugins(或重開 session)由你自己做。自製 monorepo 在新機器會提示先 clone + init。
- monorepo(所有自製 plugin 的家):一個 repo、一個 marketplace、
plugins/底下放全部。 - move + symlink(真身一份):adopt 把 skill 真身搬進 monorepo,原專案留 symlink 指回——改任一邊都是改同一份檔,永不打架。
- 兩份清單,隱私分明:
- registry(
~/.claude/plugin-manager/,家目錄、不進 git)的selfMade:你自製 plugin 的版本 / dirty(個人本機狀態,由 adopt/bump/publish-finalize 維護)。 - recommends.json(plugin 內、進 git、會推廣):你精選的別人做的外部 plugin(只記來源/用途/tag,不複製別人程式碼)。別人裝你的 repo 就看到,
/setup-plugins時可挑裝。
- registry(
詳細教學(含完整實例):plugins/plugin-manager/README.md
工作規範(真身單一份、改 skill 必發布、commit message 註明 skill、版本號慣例、plugin 指令分工):plugins/plugin-manager/CONVENTIONS.md
/plugin marketplace add abs1294/fulin-claude-plugins
/plugin install plugin-manager@fulin-plugins
/reload-plugins
裝好後 /plugin-manager-adopt、/plugin-manager-bump、/plugin-manager-publish、/plugin-manager-update、/setup-plugins 就會出現。其他 plugin(見下)依需要再各自 /plugin install。
首次初始化(只做一次):所有指令靠 ~/.claude/plugin-manager/config.json 定位你的 monorepo,第一次要先建好:
node "<你 clone 的 repo>/plugins/plugin-manager/scripts/init.js" <owner> <github-owner/repo>monorepo 路徑自動偵測(從腳本位置回推),不必手填。它建好 config.json + registry.json(已存在不覆蓋)。這個固定路徑的 config 就是「任何 session、任何專案」都能定位 monorepo 的錨點。
輸入框的互動指令
/plugin沒有update子指令;更新已裝 plugin 用非互動 CLI(Claude 可直接跑):claude plugin marketplace update fulin-plugins刷新 →claude plugin update <name>@fulin-plugins --scope <該安裝的 scope>(scope 用claude plugin list --json查),跑完重開 session 才生效(或在/pluginUI 開 Enable auto-update)。整台電腦一次更新用/plugin-manager-update。上面的安裝三行也可改成請 Claude 跑claude plugin marketplace add …+claude plugin install …,/reload-plugins仍要你自己打。
前置依賴:plugin-manager 需 Node.js;狀態存本機 ~/.claude/plugin-manager/(config.json + registry.json,不進 plugin、不進 git)。
這些是被 plugin-manager 管理的一般 plugin,依需要各自安裝:
| plugin | 用途 | 前置依賴 |
|---|---|---|
| git-commit | 並行審查模式的 Git Commit 流程(使用者確認 message + Codex + code-reviewer 三軌)→ commit → push;自帶通用版 code-reviewer agent(C 軌,專案有同名 agent 時專案層優先) |
Codex CLI(缺則該軌略過) |
| qa-webwright | webwright 驅動的 QA 測試框架:QA Agent 設計測試計畫,主 Agent code-as-action 執行 + 截圖自我驗證 | webwright plugin + playwright install firefox,詳 plugins/qa-webwright/README.md |
| goal2 | goal 引擎啟動器+quota 排程,兩個 skill:goal(推導可測量完成條件→確認或逾時自動採納→以 claude -p 子程序跑官方 /goal 引擎做到完成,長任務壓縮不忘目標、可終止);delaylocal(排到 5h quota 重置後無人值守執行,完成發 LINE)。plugin 名取 goal2 以避開內建 /goal | Node.js;LINE 憑證放本機(不進 git),詳 plugins/goal2/README.md |
| supplier-agents | Winbond 供應商平台 DDD 開發 agent 組(backend-architect/engineer、frontend-engineer、code-reviewer、qa-engineer,共 5 個 agent) | 無(裝了 plugin 即自動載入其 agents) |
| red-blue-review | 中文紅藍對抗:對任何命題(決策/架構/程式碼/plugin配置/文件…)先提出對抗面向給你核可,再對每個面向派一個紅方做 Red 攻→Blue 守→收斂,最終回報逐面向對標提案,產出強化版 + go/no-go。說「紅藍對抗 X」即觸發 | 無 |
| self-heal | 降低並自動接力 tool call 失敗:每輪注入 XML 收尾提醒 hook + self-heal scheduler 接力規約(卡住自己續、完成則終止) | 無 |
| cc-statusline | 資訊密度高的 status line:目錄/repo/model/成本/用量/quota/agents/skills/memory+MCP/近期編輯/歷史多欄顯示,含寬字對齊;可用 /cc-statusline-rows 逐列開關。裝完需設 settings.json 的 statusLine(plugin 無法自動設,官方限制)——說「幫我設定 statusline」走 /cc-statusline-setup(先問再寫)或手動加。設完要做一次寬度目視校正(widthMargin,因機器而異;右端被切就從預設 4 每次加 2),詳 plugins/cc-statusline/README.md |
Node.js |
| deliver-report | 把工作成果變成對外產物,六個 skill:deliver-report 寫交付訊息/逐題回覆信(動筆前先定四件事——檔案是主體還是佐證、有沒有對方的問題要回、單一收件人還是多類分眾、內文密度,形狀自然長出來;含三種形狀與四個範例);test-report-docx 產測試報告 DOCX 給 PM/客戶簽核轉發(九條鐵則+段落構件庫);daily-report 掃當日 session 按專案分組摘要、人工核可後經 Gmail 寄出;to-checklist 把要對方拍板的待決事項整理成確認清單 PDF;msproject-wbs 產 MS Project 可直接匯入的 WBS 時程 XML(MSPDI 七雷編碼+順序自檢),並可轉成交付用 XLSX(產檔前自動自檢);check-before 對指定文件做交付前易讀性自檢(同一支檢查已接進其他 subskill 的產檔/寄送腳本自動跑)。六者共通:嚴禁 AI/內部流程/異動紀錄字眼、預設讀者不懂技術。含易讀性十五條鐵則+Stop hook 機械閘,日報另有寄送前 content_guard 硬閘 | Python 3(日報/報告/WBS 轉 XLSX);Node.js(WBS 生成、自檢);Gmail 憑證放家目錄不進 git,詳 plugins/deliver-report/README.md |
| fable-quote | 產生「寓意科技」格式的正式軟體開發報價單 .docx:套已脫敏的公司標準模板(版式/乙方資料/通用條款內建),只填客戶資料與專案 JSON,明細列動態展開、含稅總計自動算。說「做報價單 / 寓意報價 / 幫客戶出報價」即觸發 | Python 3 + python-docx |
| harness | 開發流程制度安裝器與制度健檢。/harness:init 在任何軟體開發專案裝上一套工作紀律:前置檢查→盤點(技術面+這個專案在做什麼)→攤開核對→訪談(先確認哪個環境是正式、專案進度與用語,再問流程設定)→五層生成(制度文件+依盤點從形狀目錄推導的可執行 hook+通用 agent+知識筆記+settings)→init-verify 腳本驗收+冷啟探針(新 session 實測 hook 真的會擋)→三張流程圖;階段順序由狀態檔與 Stop hook 把關。裝好之後有學習迴路:每累積一段工作量,背景起一個只能讀檔的反思子程序,從對話紀錄提出 memory/知識筆記/規則的提案,由腳本依分級落地(低風險的驗證後自動寫、改既有的寫入並在下次開場列出讓你否決、改規則的只進待核清單),同類問題第 2 次出現自動提出升格,並統計哪些規則與 memory 沒被用到。/harness:review 從實際對話紀錄檢查流程有沒有起作用,列出待核提案、淘汰候選與版本差距。開發流程骨幹全帶、事故型條款不帶;引擎在 plugin、實例在專案(plugin 更新不覆蓋實例)。產出是骨架+長出資產的路徑,收尾回報會明列「你還沒有的」 |
Node.js(hook 用);Codex CLI(commit 第二審查軌);學習迴路需要找得到 claude 執行檔(PATH、~/.local/bin,或設 HARNESS_CLAUDE_BIN) |
| travel-advisor | 旅遊行程顧問與現場導遊:四道強制閘門(選項盤點→硬約束過濾→查證完備→範圍宣告)把 136 則實際踩過的坑編碼成規則;旅伴參數(孕婦/長輩)與地區從設定檔讀不寫死;附現場定位腳本(Google Maps 即時位置分享→座標,不開瀏覽器)與 Gate-V 判準驗證器。不常用,需要時才裝到專案;設定檔與行程狀態檔含個資,已 .gitignore | Python 3(腳本);Node.js+Playwright(verify-gatev.js,走系統 Chrome) |
| cbm-guard | codebase-memory-mcp(程式碼知識圖譜)查詢的機械閘:它的數字很容易看起來很成功——精確、可複製、有來源,唯獨是錯的。在查詢當下攔截五類會誤導的用法(EXISTS 綁定變數位置錯→結果恆為全部或零且不報錯、計數沒跑對照組、節點數被當成實體數、孤兒查詢高估數倍、Route 節點在 attribute routing 框架下建不出來),並把「框架反射入口被誤判成死碼」泛化成設定(MediatR/EF Core/Spring/Angular 皆同型)。另含索引新鮮度檢查——cbm 的查詢結果不帶新鮮度標記,對過期索引查會拿到已刪除的檔案且看起來完全正常。零設定即可用,專案事實(實測數字/替代工具/已標註的孤兒檔)走 cbm-guard.config.json |
Node.js(hook)+ Python 3(新鮮度檢查);需 codebase-memory-mcp |
| session-board | 本機 session 看板:一個只聽本機的網頁,左邊是這台電腦所有 Claude Code session 的清單(依資料夾分組,標示輪到你/執行中),右邊是對話。可以直接在頁面上開新對話(選資料夾)、打字、核准或拒絕 Claude 要做的動作,重啟後接續原本的對話;終端機視窗裡的 session 可以看對話、切到它的視窗,或搬進看板。說「開 session 看板」或 /session-board 啟動。單一 Node 程序、零相依(資料存在 Node 內建的 SQLite)、免建置,詳 plugins/session-board/README.md |
Node.js;僅支援 Windows+Windows Terminal;摘要標題來自 cc-statusline(沒裝則用 Claude Code 自己取的標題) |
.claude-plugin/marketplace.json 列出下列 plugin(source: ./plugins/<name>)
plugins/
├─ plugin-manager/ ⭐ 主角:自製 plugin 集中管理器
│ ├─ skills/ adopt · bump · publish · update · clone-env · setup-plugins
│ ├─ profiles.json 可推廣的 plugin 套餐 + 偵測規則(detect)
│ ├─ scripts/ init · adopt · adopt-agents · bump-version · upgrade-check · update-all · publish-status · publish-finalize · register-external · export-env · restore-env
│ └─ CONVENTIONS.md
├─ git-commit/ 並行審查 Git Commit 流程(含通用版 code-reviewer agent)
├─ qa-webwright/ QA 測試框架 plugin
├─ goal2/ /goal 引擎啟動器+quota 排程(goal · delaylocal 兩 skill;共用 lib/ 與 references/;LINE 憑證以 .gitignore 排除)
├─ supplier-agents/ 供應商平台 DDD 開發 agent 組(5 個 agent)
├─ red-blue-review/ 中文紅藍對抗(多面向對抗式審查)
├─ self-heal/ tool call 失敗自動接力(XML 收尾 hook + scheduler)
├─ cc-statusline/ 高資訊密度 status line(需手動接 settings.json)
├─ deliver-report/ 對外產物六件套(交付訊息/測試報告 DOCX/工作日報/確認清單/交付前自檢/WBS 時程)
├─ fable-quote/ 寓意科技報價單產生器(模板套版、含稅自動算)
├─ harness/ 開發流程制度安裝器與健檢(/harness:init 五層生成+階段閘+init-verify+冷啟探針;學習迴路;/harness:review;hook 範本、agent 與知識容器骨架、條件式入口提醒)
├─ cbm-guard/ codebase-memory-mcp 查詢機械閘(七類判準+索引新鮮度;專案相依走 config,零設定亦可用)
├─ travel-advisor/ 旅遊行程顧問與現場導遊(四道閘門+旅伴設定檔+現場定位腳本;需要時才裝)
└─ session-board/ 本機 session 看板(單一 Node 程序的本機網頁;左清單右對話,可直接對話、切終端機視窗;僅 Windows)
- 所有 skill 真身只有 monorepo 一份;各專案/user-scope 原位以 symlink/junction 指回。
- 開發期靠 symlink 即時迭代(改 = 改 monorepo 真身,免發布即生效),一個段落完成就
/plugin-manager-publish。 - 改了任何 skill 都要記得 publish 到 remote,否則 monorepo 落後本機。完整規範見
plugins/plugin-manager/CONVENTIONS.md。
維護提醒:新增/移除 skill 或 plugin 時,務必同步更新本 README 的表與「結構」,並隨 monorepo 一起 publish;commit message 須註明改了哪個 skill。
fulin