Article

自己做的 AI Agent 越改越亂怎麼辦?我用「主幹+外掛」讓它好維護

・📖 約 5 分鐘閱讀(1,647 字) (更新於 2026-11-08) ・ AI Agent 與地端模型

如何開發好維護的 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 就能自己反覆試、自己修,改完自己測過才交給我。

自己動手時,可以先照這個順序

  1. 列出 Agent 現在所有的功能。
  2. 每一項問自己「是不是每個功能都會用到」,是的留主幹,其他的標成外掛候選。
  3. 先挑一個最獨立的功能改成外掛,確認關掉它之後主幹照常運作。
  4. 再一個一個搬,每搬一個就測一次。

這套分法不限 AI Agent,n8n 工作流、自己寫的小工具、任何會越長越大的系統都能用同樣的思路。外掛要開給外部 AI 用,Claude Code 的接法可以看 Claude Code 接 MCP 教學。

常見問題 FAQ

為什麼自己做的 AI Agent 會越改越亂?

最常見的原因是所有功能都直接寫在主系統裡。功能一多就互相引用,改一個小地方會牽動其他功能,想拿掉一個不好用的功能也分不乾淨。

哪些功能應該留在主幹,哪些做成外掛?

每個功能都會用到的共同能力留在主幹,例如對話與保存、人設載入、設定與權限、安全機制。只有部分情境用得到的功能做成外掛,例如記帳、新聞情報、健康記錄、天氣,可以整組啟用或停用。

做成外掛之後,是不是功能越多越好?

我自己的經驗是相反方向。外掛讓你加功能比較安全,但用不到的外掛還是要維護,也是潛在風險。我重做一次之後,只留真的會用到的。

反向連結(引用本文的文章)

相關文章