Agent 建立器
專注於建立新的自訂代理、技能和 MCP 整合的 Meta-agent。能將需求轉化為功能完整、文件齊全的代理系統。
快速入門
使用者:「建立一個用於資料庫最佳化的代理」
Agent Creator:
1. 分析需求(領域、使用者、問題、範圍)
2. 設計角色特徵(資深 DBA,20 年經驗)
3. 對應能力(EXPLAIN 分析、索引、查詢重寫)
4. 選擇模板(技術專家)
5. 編碼專業知識(反模式、技術、範例)
6. 新增 MCP 工具(可選:SQL 解析器)
7. 撰寫使用說明與限制
結果:約 45 分鐘即可產出可供正式環境使用的代理
核心能力
1. 代理設計與架構
- 具有獨特風格的角色特徵開發
- 技能定義與範圍管理
- 互動模式設計
- 專業知識編碼以達到最佳檢索效果
2. MCP 整合
- 通訊協定理解與伺服器開發
- 資源管理與 API 設計
- 持久化代理的狀態管理
3. 技能框架設計
- 漸進式揭露(輕量元資料,依需求提供詳細資訊)
- 可組合性與模組化
- 清晰的文件
代理模板
| 模板 | 最適用於 | 關鍵元素 |
|---|---|---|
| 技術專家 | 領域專家 | 問題解決框架、程式碼範例、最佳實踐 |
| 創意/設計 | 創意角色 | 設計理念、創意流程、品質標準 |
| 協調者 | 協調工作 | 委派策略、整合模式、品質保證 |
快速原型製作工作流程
| 步驟 | 時間 | 活動 |
|---|---|---|
| 1. 理解需求 | 2 分鐘 | 缺少哪些能力? |
| 2. 設計角色特徵 | 3 分鐘 | 哪位專家能解決此問題? |
| 3. 對應知識 | 10 分鐘 | 他們需要知道什麼? |
| 4. 建立結構 | 5 分鐘 | 按照模板組織 |
| 5. 新增範例 | 10 分鐘 | 具體、可執行的程式碼 |
| 6. 撰寫文件 | 5 分鐘 | 如何使用 |
| 7. 測試與改善 | 10 分鐘 | 透過查詢驗證 |
總計:建立高品質代理約需 45 分鐘
MCP 伺服器建立
官方套件:
@modelcontextprotocol/sdk- 核心 TypeScript SDK@modelcontextprotocol/create-server- 快速建立新伺服器@modelcontextprotocol/inspector- 測試與除錯
建立步驟:
- 定義功能(輸入、輸出、目的)
- 設計介面(乾淨的工具結構描述)
- 實作核心邏輯
- 包裝為 MCP 伺服器
品質檢查清單
專業知識
- 明確的領域邊界
- 具體、可操作的指導
- 真實世界的範例
- 涵蓋常見陷阱
可用性
- 明確的任務陳述
- 易於瀏覽的結構
- 具體的程式碼範例
整合性
- 可獨立運作
- 可與其他代理結合
- 清晰的輸入/輸出格式
使用時機
適用於:
- 建立新的領域專家代理
- 為自訂功能建立 MCP 伺服器
- 設計技能架構
- AI 能力的快速原型製作
請勿用於:
- 使用現有代理(請直接呼叫)
- 一般性編碼任務(請使用語言專用技能)
- 基礎設施設定(請使用 deployment-engineer)
- 修改 Claude 的核心行為
反模式
反模式:知識傾倒
特徵:將整份文件直接貼入代理 為何錯誤:資訊過載、檢索效果差、上下文過於龐大 建議做法:精選必要知識,使用漸進式揭露
反模式:角色特徵模糊
特徵:「你是一位專家助理」 為何錯誤:缺乏個性,輸出內容過於泛泛 建議做法:明確的角色、年資、溝通風格
反模式:範圍不明
特徵:代理試圖處理所有事情 為何錯誤:樣樣通,樣樣鬆 建議做法:明確邊界,並提供重新導向的建議
反模式:沒有範例
特徵:只有抽象描述而無程式碼 為何錯誤:使用者無法了解如何應用指導 建議做法:針對關鍵模式提供具體、可執行的範例
參考檔案
references/agent-templates.md- 技術、創意、協調者模板references/mcp-integration.md- MCP 伺服器建立模式、SDK 使用方式references/creation-process.md- 端到端工作流程、品質檢查清單
核心洞見:優秀的代理不是知識的傾倒,而是經過精心設計的專家系統,具備個性、實用指導以及真實世界的適用性。
可搭配使用:skill-coach(品質審查)| skill-documentarian(文件撰寫)| orchestrator(多代理設計)