從 Opencode 文檔學習 AI 代理設計嘅 7 大構建模塊

Opencode 正迅速成為繼 Claude Code 之後開發者討論得最多嘅 AI 編碼工具。喺韓國，Oh-my-opencode 嘅推動下採用速度好快，全球嘅開發者社群都喺密切關注。

但 Opencode 嘅真正價值唔止係編碼輔助。因為佢係開源嘅，你可以直接檢視代理係點樣設計 - 由工具註冊到子代理編排。開源項目受益於社群開發者嘅貢獻，即係話文檔反映咗代理架構領域最前沿嘅思考。

Opencode 文檔嘅 Configure 部分讀起嚟好似一本代理設計嘅入門教科書。以下係佢呈現嘅七大構建模塊，同埋每個模塊重要嘅原因。

Tools：代理同世界互動嘅方式

Tools 定義咗代理可以做乜嘢。每個工具都係一個獨立嘅能力 - 讀取檔案、寫入檔案、執行終端命令、搜尋網頁 - 註冊為可呼叫嘅函數。

• 你提供嘅工具集合決定咗代理嘅能力邊界
• 工具係語言模型同外部環境之間嘅介面
• 根據我嘅經驗，俾代理太多工具反而會適得其反：佢花喺揀用邊個工具嘅時間仲多過實際執行

設計原則好直接：冇工具嘅代理只係一個聊天機器人。擁有啱嘅工具嘅代理先可以成為自主工作者。

Rules（AGENTS.md）：代理嘅行為準則

AGENTS.md 係一種檔案格式，用嚟向代理傳達項目特定嘅上下文同約束。可以當佢係為 AI 而唔係人類寫嘅 README。

• 包含「冇測試唔准改代碼」「跟呢個資料夾結構」之類嘅指令
• AGENTS.md 標準已經俾超過 6 萬個開源項目採用
• 規則喺唔改變底層模型嘅情況下塑造代理嘅決策

冇規則，代理會將通用訓練內容直接套用到你嘅項目上。有咗規則，佢會反映你項目嘅慣例、約束同偏好。差別好大。

Agents（子代理）：分而治之

複雜任務拆分俾多個專業代理處理，比交俾單一通用代理更有效。

• 你可以定義角色特定嘅代理：Build、Plan、Review、Debug 等等
• 主代理制定計劃，子代理執行各個步驟
• 每個子代理喺專注嘅上下文中運行，減少咗長時間單一工作階段中嘅雜訊同偏移

呢個同將微服務原則應用於 AI 工作流一樣。專業化提升質素，隔離防止上下文污染。

MCP（Model Context Protocol）：外部連接嘅標準

Model Context Protocol 係 Anthropic 建立嘅開放協議，標準化咗代理連接外部數據源同服務嘅方式。

• 為數據庫、檔案系統、API 等整合提供一致嘅介面
• 唔使為每個服務寫自訂轉接器，MCP 為代理提供統一嘅外部存取方式
• 預計基於 MCP 層會出現日益增長嘅服務應用生態系統

MCP 解決咗實際嘅互通性問題。之前每個代理框架都發明咗自己連接外部工具嘅方式。MCP 令呢啲連接變得可攜帶、可組合。

LSP（Language Server Protocol）：代碼理解嘅基礎

Language Server Protocol 最初係為 IDE 設計嘅，但事實證明佢對需要瀏覽代碼庫嘅 AI 代理一樣有價值。

• LSP 提供跳轉到定義、搵參考、自動完成同診斷功能
• 喺 Opencode 中 LSP 整合仲係實驗功能，但代碼導覽精度有咗顯著提升
• 代理可以用 LSP 從語義層面理解代碼結構，而唔係純粹依賴文字搜尋

一個可以追蹤函數呼叫到佢嘅定義、追溯所有參考、理解類型層次結構嘅代理，同一個只做字串模式匹配嘅代理喺根本上處於唔同層次。

A2A 同 ACP：代理間通訊標準

當代理由唔同框架構建時，佢哋需要共享協議嚟協作。兩個標準正喺興起嚟填補呢個空白。

• A2A（Agent-to-Agent）：由 Google 建立並捐贈俾 Linux Foundation。定義咗代理點樣發現彼此、協商能力同交換訊息
• ACP（Agent Communication Protocol）：由 BeeAI 團隊構建，最近合併到咗 A2A 計劃中

兩者都處於早期階段，但佢哋代表咗多代理系統嘅基礎 - 嚟自唔同供應商同框架嘅代理可以無縫協作。類比就係 Web 嘅 HTTP - 一個令一切可互通嘅共享傳輸層。

Skills：可重用嘅能力套件

Agent Skills 將工具、規則同提示詞打包成單一可安裝單元。由 Anthropic 首先引入嘅呢種格式而家已經標準化。

• 代理喺需要特定能力時載入技能 - 好似代碼審查、TDD 工作流或安全分析
• 技能可跨項目同團隊共享，建立可重用代理行為嘅生態系統
• 呢個標誌住從消費文檔到消費技能嘅轉變：唔再閱讀點做，而係安裝做嘅能力

技能之於代理，就好似套件之於應用程式。佢哋將專業知識模塊化並令佢可分發。

重點整理

構建有效嘅 AI 代理唔在於知道所有可用嘅工具，而在於理解架構：代理點樣思考、點樣連接外部世界、點樣彼此協作。

呢七大構建模塊 - Tools、Rules、子代理、MCP、LSP、A2A/ACP、Skills - 構成咗代理設計嘅結構性詞彙。每個模塊解決一個獨特嘅關注點，佢哋共同定義咗一個設計良好嘅代理系統嘅樣貌。

因為 Opencode 係開源嘅，佢嘅文檔隨住開發者社群嘅貢獻而不斷演進。如果你真心想理解代理架構，Opencode 文檔值得一讀。