同一套 AI 工作流,怎麼讓四種 AI 工具共用?我做了一個 plugin marketplace
同一條規則,例如「commit(程式改動的存檔紀錄)訊息要用某種格式」,我得在 Claude Code、Codex 這些 AI 工具各設定一次,換一台電腦又要再來一遍。設定放在不同地方,改了這邊忘了那邊,AI 也就時對時錯。
plugharbor 就是為了解決這件事:把所有 skill(教 AI 做某件事的說明書)、規則和 hook(在特定時機自動執行的小程式)收進同一個 plugin marketplace(可以一次安裝一整批 plugin 的清單),四種 AI 命令列工具(Claude Code、Codex、pi、agy,都是在終端機裡用的 AI 助理)共用同一份,Mac 和 Windows 兩台電腦各跑一行安裝腳本 bootstrap.sh 就裝好。2026 年 10 月 30 日開始做,到 11 月 18 日累積 334 個 commit,有 commit 的日子是 17 天。
它是什麼
plugharbor 目前有 14 個 plugin,分成兩層。分法很簡單:每個專案都要的裝在 user 層(你的電腦上所有專案都會載入),視專案才需要的裝在專案層(只有那個專案載入),不要全裝。
| 層 | plugin | 管什麼 |
|---|---|---|
| user 層 | toolkit | hook、危險指令攔截(guard)、派工(把工作分給別的 AI 去做)、收集「使用者糾正 AI」的回饋 |
| user 層 | workspace | commit、worktree、無人值守、context 治理 |
| user 層 | research | AI 情報雷達(定期整理 AI 圈新消息)、評估並吸收外部 plugin 的做法 |
| user 層 | browser-docs | 用瀏覽器實機操作系統 |
| 專案層 | lifecycle、tickets、discovery、delivery | 開發流程、票務(追蹤待辦工作的票)、需求與會議、操作手冊與示範影片 |
| 專案層 | backend、frontend、database、ui-ux、desktop | 各類技術的慣例(附 .NET、Vue 等附錄) |
| 專案層 | blog | 這個網站自己的流程 |
四種 AI 工具可以單獨用,也可以混用。混用的目標是讓它們互相協調、挑最合適的模型、顧到 token 用量(AI 計費用的字數單位)。
這個 repo(存放專案檔案的資料夾)之後主要是 AI 回來修改,所以 AGENTS.md(寫給 AI 看的專案守則)裡有一份「改動原則」:只寫通用內容、每個改動要有起因、改之前先查有沒有重疊。
幾個做出來的功能
- 無人值守:下指令後 AI 連續推進工作,直到使用者回來為止。沒人在場時,AI 遇到要使用者選擇的問題,就照它標的「推薦」選項做,並記進「待確認」清單等人回來看;刪除檔案這類不可逆的操作照舊停下來等人。
- 自動駕駛:在無人值守之上,改成照
docs/roadmap.md(一份按優先順序排好、標出哪項被哪項擋住的待辦清單)一段一段往下做,除非人中途介入或暫停。 - session 塔台:同一個專案開了多個 session,彼此不知道對方在做什麼。塔台讓每個 session 開工前登記、落地前核對,要併進主線(
main分支)前,如果有別的 session 的改動衝突,就直接擋下。 - 回饋閉環:hook 把「使用者糾正 AI」的紀錄收起來,改完規則後登記一條「待驗指標」(寫明判準、到期日),到期回頭看糾正有沒有變少。
- 工具故障不靜默:自動作業中某個工具壞了,不悄悄換成較差的做法繼續,而是在報告標紅並推播通知。
這些功能大多來自實際踩到的坑,例如自動駕駛卡在刪檔指令(rm)的確認提示、對話太長被壓縮之後 AI 改用英文回答、某個封鎖的到期時間印成沒標時區的 UTC 時間而被誤判成已解除。每個坑都有對應的修正。
我拆掉了自己寫的開發流程 plugin
lifecycle 是我最早設計的開發流程:需求、設計、驗收、發版,每個階段都有一份文件(FRD、SAD、BFS、FFS 四份規格)。它是為專案經理(PM)、系統分析師(SA)、測試(QA)、工程師分工的團隊設計的,一個人用其實沒有那麼多角色。
11 月 15 日我請 AI 讀另一個專案 Formwright(我的個人專案)從頭到尾的 session 紀錄,統計用了哪些 plugin 和 skill,因為我覺得那邊的流程很順手,想跟 lifecycle 比較。結果是:
- 約兩週的 session 紀錄裡,lifecycle 的 22 個 skill 只有 7 個被叫出來用過,15 個一次都沒有。
- Formwright 的 24 個 session 裡,lifecycle 只被用到一支用來管理清單的腳本(執行 165 次),skill 一個都沒叫。
(數字來自 plugharbor 的設計文件與 git log。)
- 真正撐起流程的是外部的 superpowers plugin,加上 workspace 和 toolkit。
我在 superpowers 和 lifecycle 之間做取捨:我覺得 superpowers 的效果與能力比較好,但它沒有 lifecycle 才有的票務管理這類技能。所以做法是:
- 把四份規格文件改成跟 superpowers 同格式的一份設計文件,固定有「驗收」一節。因為如果之後有團隊一起用,成員的電腦不一定都裝了 superpowers,沒裝也要能用同樣的結構。
- 把 lifecycle 裡票務、需求與會議、操作手冊這幾塊,拆成 tickets、discovery、delivery 三個獨立 plugin。
- 兩個都裝時,流程聽 superpowers 的,設定與跟其他 plugin 銜接的地方聽 lifecycle 的。
- 設計文件裡寫了一條「反目標」(做到了反而算失敗的事):現在順手的流程如果多出必經步驟、或團隊成員得改個人設定才能用,就算失敗。
這個問題是靠盤點 session 紀錄才看出來的,光憑印象,我還以為這 22 個 skill 都有在用。
刻意不做的事
- 很多想法標「等事故再做」:repo 的功能清單(
docs/feature.md)裡有 7 項這樣標。意思是改 skill 必須有實際出過的問題(事故)或使用統計當證據,只是預防的改動先不做。 - .NET 工具鏈不自己寫:.NET 是微軟的開發平台;需要時直接裝微軟官方的 dotnet/skills,自己只管架構與慣例。
- 每日背景版的 AI 情報雷達停掉了:它是 research plugin 裡每個工作日早上自動跑的版本,我自己都沒在看。
目前進度
功能清單 35 項,完成 25 項,另 1 項決定不做。票務 skill 從沒實測過,我正拿兩個個人專案同時跑 GitHub Issues/Projects 和 repo 內清單兩種做法,觀察期是 11 月 16 日到 11 月 30 日,目前還沒有結果。
收穫
- 工具的設定放在一個地方,改一次就四種工具都生效,不用在每個工具各改一遍。
- 自己設計的東西有沒有人用,要看使用紀錄,不能靠印象。
- 好用的現成工具(superpowers)能做到的,不必硬自己再寫一套,專心補它沒有的部分。
名詞解釋
- plugin marketplace:一個放著許多 plugin 的清單,Claude Code 可以從裡面一次裝多個。
- plugin:把 skill、規則、hook 打包在一起、可以安裝的套件。
- skill:一份寫給 AI 看的說明書,告訴它某類工作該怎麼做。
- hook:在特定時機(例如 AI 要執行指令前)自動跑的小程式,可以用來檢查或攔截。
- guard:攔截危險指令的 hook,例如擋下
git add .。 - session:和 AI 的一次連續對話。
- context:AI 這一次對話裡一次能讀進去的內容。
- token:AI 計算用量的單位,大致可以想成字數。
- Claude Code、Codex、pi、agy:四種在終端機(命令列)裡用的 AI 助理工具。
- commit:把程式改動存成一個紀錄點。
- repo:存放一個專案所有檔案與修改紀錄的資料夾。
- main:專案的主線分支,正式的程式放在這裡。
- rm:終端機裡刪除檔案的指令。
- roadmap:按優先順序排好的待辦清單。
- 派工:把一件工作交給另一個 AI session 或 AI 工具去做。
- FRD、SAD、BFS、FFS:四份開發規格文件(功能需求、系統分析設計、功能規格等)的縮寫。
- superpowers:一個外部的 Claude Code plugin,提供設計、規劃、實作、審查的一套流程。
- worktree:同一個專案同時開多份工作資料夾,各自做不同分支。