Article
自己做的 AI Agent 越改越亂怎麼辦?我用「主幹+外掛」讓它好維護
自己做的 AI Agent 越改越亂,我的解法是把它分成主幹和外掛兩層。每個功能都會用到的共同能力留在主幹,像對話保存、人設載入、設定與權限;只有部分情境才用的功能一律做成外掛,可以整組停用,資料也保留著。這樣加新功能有固定的地方接,不好用就關掉那個外掛,主幹不用跟著改。我 2026 年 8 月把自己的 Agent 改成這樣,10 月重做時也沿用。
這篇是自建 Agent 系列裡講「模組化好維護」的分支。為什麼要自己做 Agent,寫在 自己做 AI Agent 的上千小時心得;Agent 的工具要怎麼開給 Claude、ChatGPT 用,看 用 MCP 雙向擴充自己的 Agent;還在入門的話,先讀 AI Agent 是什麼。
我早期的 Agent 為什麼會亂
2026 年 8 月初,我花了好幾天大改自己的 Agent。早期我把所有功能都硬塞在系統底下,功能之間互相引用,牽連得很深。
那時的狀況是這樣。想修一個小地方,要先搞清楚它被哪些地方用到;想拿掉一個試過覺得沒用的功能,發現它已經跟別的東西纏在一起。
更早之前我用 OpenClaw,只能靠 Skill 和記憶去校正 AI 的行為,地端開源模型又比雲端模型容易出錯,加一條規則常常顧此失彼。自己做 Agent 之後,我才有機會從架構上處理這件事。
主幹放什麼,外掛放什麼
我現在的分法很單純,判斷標準是「是不是每個功能都會用到」。
| 放哪裡 | 放什麼 | 例子 |
|---|---|---|
| 主幹 | 每個功能都會用到的共同能力 | 對話與保存、人設載入、設定與權限、網頁主控台的外殼 |
| 外掛 | 只有部分情境用得到的功能 | 個人帳本、新聞情報、健康記錄、天氣與出行、開發進度 |
有幾樣東西我刻意不做成外掛,包括訊息主流程、人設載入、設定讀寫和安全機制。這些一壞全壞,放在主幹才好管。
外掛和主幹之間只透過一個「載入與註冊」的接點溝通。每個外掛有自己的資料夾和一份說明檔,寫清楚它叫什麼、提供哪些工具。主幹照著清單載入,不需要知道外掛內部怎麼做。
我在 2026 年 9 月整理課程時算過,舊的那隻 Agent 有 27 個外掛,其中 26 個是開著的。
改成外掛之後,日常維護差在哪
試新東西比較放心
看到新的開源工具或想到新功能,我就開一個新外掛來試。跑得順就留著,不如預期就停用或整個刪掉,主幹不受影響。
出錯比較好找
某個外掛壞了,問題通常就在那個資料夾裡。我會在主控台看每個外掛現在是開是關、有沒有在跑,不用靠猜。
上下文比較省
外掛的工具和說明只在用得到時才載入,不會每一輪都塞進提示詞。我的 Agent 用地端開源模型,上下文省下來,模型比較不容易漏掉重要指令。
重做一次之後,我學到的兩件事
2026 年 10 月,我把開發上千小時的舊 Agent 退役,花三週重做一隻新的。模組化的分法沿用,但有兩件事我做得不一樣。
外掛只做用得到的
舊的那隻是邊做邊實驗,想到可能有用就做成外掛。學到很多,但很多系統只用過一次。雖然是模組化,這些沒在用的外掛還是潛在風險。新的那隻只做會用到的。
指令和報錯寫到 AI 不用猜
外掛分得再乾淨,AI 看不懂錯在哪也修不好。我現在要求報錯寫清楚哪裡錯、為什麼錯,開發的 AI 就能自己反覆試、自己修,改完自己測過才交給我。
自己動手時,可以先照這個順序
- 列出 Agent 現在所有的功能。
- 每一項問自己「是不是每個功能都會用到」,是的留主幹,其他的標成外掛候選。
- 先挑一個最獨立的功能改成外掛,確認關掉它之後主幹照常運作。
- 再一個一個搬,每搬一個就測一次。
這套分法不限 AI Agent,n8n 工作流、自己寫的小工具、任何會越長越大的系統都能用同樣的思路。外掛要開給外部 AI 用,Claude Code 的接法可以看 Claude Code 接 MCP 教學。
常見問題 FAQ
為什麼自己做的 AI Agent 會越改越亂?
最常見的原因是所有功能都直接寫在主系統裡。功能一多就互相引用,改一個小地方會牽動其他功能,想拿掉一個不好用的功能也分不乾淨。
哪些功能應該留在主幹,哪些做成外掛?
每個功能都會用到的共同能力留在主幹,例如對話與保存、人設載入、設定與權限、安全機制。只有部分情境用得到的功能做成外掛,例如記帳、新聞情報、健康記錄、天氣,可以整組啟用或停用。
做成外掛之後,是不是功能越多越好?
我自己的經驗是相反方向。外掛讓你加功能比較安全,但用不到的外掛還是要維護,也是潛在風險。我重做一次之後,只留真的會用到的。