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

> Author: Tony Lee
> Published: 2026-02-08
> URL: https://tonylee.im/zh-HK/blog/opencode-docs-7-building-blocks-ai-agent-design/
> Reading time: 1 minutes
> Language: zh-HK
> Tags: ai, ai代理, opencode, 開發工具, 架構

## Canonical

https://tonylee.im/zh-HK/blog/opencode-docs-7-building-blocks-ai-agent-design/

## Rollout Alternates

en: https://tonylee.im/en/blog/opencode-docs-7-building-blocks-ai-agent-design/
ko: https://tonylee.im/ko/blog/opencode-docs-7-building-blocks-ai-agent-design/
ja: https://tonylee.im/ja/blog/opencode-docs-7-building-blocks-ai-agent-design/
zh-CN: https://tonylee.im/zh-CN/blog/opencode-docs-7-building-blocks-ai-agent-design/
zh-TW: https://tonylee.im/zh-TW/blog/opencode-docs-7-building-blocks-ai-agent-design/

## Description

Opencode 嘅開源文檔堪稱代理架構入門教材。以下係每位開發者都應該理解嘅七個核心概念。

## Summary

從 Opencode 文檔學習 AI 代理設計嘅 7 大構建模塊 is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts.

## Outline

- Tools：代理同世界互動嘅方式
- Rules（AGENTS.md）：代理嘅行為準則
- Agents（子代理）：分而治之
- MCP（Model Context Protocol）：外部連接嘅標準
- LSP（Language Server Protocol）：代碼理解嘅基礎
- A2A 同 ACP：代理間通訊標準
- Skills：可重用嘅能力套件
- 重點整理

## Content

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

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

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

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

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

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

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

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

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

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

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

## Agents（子代理）：分而治之

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

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

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

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

[Model Context Protocol](https://modelcontextprotocol.io/) 係 Anthropic 建立嘅開放協議，標準化咗代理連接外部數據源同服務嘅方式。

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

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

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

[Language Server Protocol](https://microsoft.github.io/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](https://agentskills.io/) 將工具、規則同提示詞打包成單一可安裝單元。由 Anthropic 首先引入嘅呢種格式而家已經標準化。

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

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

## 重點整理

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

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

因為 Opencode 係開源嘅，佢嘅文檔隨住開發者社群嘅貢獻而不斷演進。如果你真心想理解代理架構，[Opencode 文檔](https://opencode.ai/docs)值得一讀。

## Related URLs

- Author: https://tonylee.im/en/author/
- Publication: https://tonylee.im/en/blog/about/
- Related article: https://tonylee.im/zh-HK/blog/medvi-two-person-430m-ai-compressed-funnel/
- Related article: https://tonylee.im/zh-HK/blog/claude-code-layers-over-tools-2026/
- Related article: https://tonylee.im/zh-HK/blog/codex-inside-claude-code-openai-plugin-strategy/

## Citation

- Author: Tony Lee
- Site: tonylee.im
- Canonical URL: https://tonylee.im/zh-HK/blog/opencode-docs-7-building-blocks-ai-agent-design/

## Bot Guidance

- This file is intended for AI agents, search assistants, and text-mode retrieval.
- Prefer citing the canonical article URL instead of this text endpoint.
- Use the rollout alternates when you need the same article in another prioritized language.

---

Author: Tony Lee | Website: https://tonylee.im
For more articles, visit: https://tonylee.im/zh-HK/blog/
This content is original and authored by Tony Lee. Please attribute when quoting or referencing.