Communitygithub.com

SamuelChien/mega-skills-collection

代理設計師 - 多代理系統架構設計工具包

mega-skills-collection 是什麼?

Agent Designer 是一個全面的工具包,用於設計、架構和評估多代理系統。它提供了結構化的方法來處理代理架構模式、工具設計原則、通訊策略和性能評估框架,以構建穩健且可擴展的 AI 代理系統。此技能支援多種著名平台,如 Claude Code 和 Cursor,其設計模式涵蓋單一代理、監督式、群體、層級和流水線架構,開發者可根據任務複雜度和系統需求選擇最合適的模式。此外,它還詳細定義了代理角色規範(如協調員、專家、介面及監控代理)、工具設計原則(包括輸入驗證、錯誤處理和冪等性)、通訊模式(訊息傳遞、共享狀態與事件驅動架構)以及安全防護措施(人類參與循環、輸入/輸出過濾)等,確保系統在複雜任務中的可靠性、安全性與性能。最後,它提供了完整的評估框架、編排策略、記憶模式、擴展考量與故障處理機制,對於任何從事多代理系統開發的工程師來說,都是一個極具價值的參考資源。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-designer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

代理設計師 - 多代理系統架構

層級: 強大 類別: 工程 標籤: AI 代理、架構、系統設計、編排、多代理系統

概述

Agent Designer 是一個全面的工具包,用於設計、架構和評估多代理系統。它提供了結構化的方法來處理代理架構模式、工具設計原則、溝通策略和性能評估框架,以構建穩健、可擴展的 AI 代理系統。

核心能力

1. 代理架構模式

單一代理模式

  • 使用案例: 簡單、範圍明確的聚焦任務
  • 優點: 複雜度最低、易於除錯、行為可預測
  • 缺點: 可擴展性有限、單點故障
  • 實施方式: 直接的使用者與代理互動,並提供全面的工具存取

監督模式

  • 使用案例: 具有集中控制的階層式任務分解
  • 架構: 一個監督代理協調多個專家代理
  • 優點: 清晰的指令結構、集中決策
  • 缺點: 監督者瓶頸、複雜的協調邏輯
  • 實施方式: 監督者接收任務,委派給專家,彙總結果

群體模式

  • 使用案例: 透過點對點協作進行分散式問題解決
  • 架構: 具有共享目標的多個自治代理
  • 優點: 高度並行、容錯能力、湧現智慧
  • 缺點: 複雜的協調、潛在衝突、較難預測
  • 實施方式: 代理發現、共識機制、分散式任務分配

層級模式

  • 使用案例: 具有多個組織層級的複雜系統
  • 架構: 樹狀結構,在不同層級設有管理者與工作者
  • 優點: 自然的組織映射、清晰的責任劃分
  • 缺點: 通訊負擔、每個層級潛在的瓶頸
  • 實施方式: 具有反饋迴圈的多層級委派

流水線模式

  • 使用案例: 具有專門階段的序列處理
  • 架構: 代理依序排列在處理流水線中
  • 優點: 清晰的資料流、每個階段的專門最佳化
  • 缺點: 序列瓶頸、僵化的處理順序
  • 實施方式: 階段間使用訊息佇列、狀態交接

2. 代理角色定義

角色規範框架

  • 身份: 名稱、目的陳述、核心能力
  • 責任: 主要任務、決策邊界、成功標準
  • 能力: 所需工具、知識領域、處理限制
  • 介面: 輸入/輸出格式、通訊協定
  • 限制: 安全邊界、資源限制、操作準則

常見代理原型

協調代理

  • 編排多代理工作流程
  • 制定高階決策和資源分配
  • 監控系統健康狀況與性能
  • 處理升級事宜與衝突解決

專家代理

  • 在特定領域(程式碼、資料、研究)具備深厚專業知識
  • 為專業任務最佳化的工具和知識
  • 在狹窄範圍內提供高品質輸出
  • 針對範圍外請求制定清晰的交接協議

介面代理

  • 處理外部互動(使用者、API、系統)
  • 協定轉換與格式轉換
  • 身份驗證與授權管理
  • 使用者體驗最佳化

監控代理

  • 系統健康監控與警報
  • 性能指標收集與分析
  • 異常偵測與報告
  • 法規遵循與稽核軌跡維護

3. 工具設計原則

結構設計

  • 輸入驗證: 強型別、必填與選用參數
  • 輸出一致性: 標準化回應格式、錯誤處理
  • 文件: 清晰的描述、使用範例、邊界情況
  • 版本控制: 向後相容、遷移路徑

錯誤處理模式

  • 優雅降級: 當相依服務失效時提供部分功能
  • 重試邏輯: 指數退避、斷路器、最大嘗試次數
  • 錯誤傳播: 結構化錯誤回應、錯誤分類
  • 復原策略: 後備方法、替代方案

冪等性要求

  • 安全操作: 無副作用的讀取操作
  • 冪等寫入: 相同操作可安全重複執行
  • 狀態管理: 版本追蹤、衝突解決
  • 原子性: 全有或全無的操作完成

4. 溝通模式

訊息傳遞

  • 非同步訊息傳遞: 解耦代理、訊息佇列
  • 訊息格式: 帶有元資料的結構化負載
  • 傳遞保證: 至少一次、恰好一次語義
  • 路由: 直接傳訊、發布-訂閱、廣播

共享狀態

  • 狀態儲存: 集中式資料儲存庫
  • 一致性模型: 強一致性、最終一致性、弱一致性
  • 存取模式: 讀取密集、寫入密集、混合工作負載
  • 衝突解決: 最後寫入者勝出、合併策略

事件驅動架構

  • 事件溯源: 不可變事件日誌、狀態重建
  • 事件類型: 領域事件、系統事件、整合事件
  • 事件處理: 即時、批次、串流處理
  • 事件結構: 版本化事件格式、向後相容

5. 防護與安全

輸入驗證

  • 結構強制: 必填欄位、類型檢查、格式驗證
  • 內容過濾: 有害內容偵測、PII 清洗
  • 速率限制: 請求節流、資源配額
  • 身份驗證: 身份驗證、授權檢查

輸出過濾

  • 內容審查: 移除有害內容、品質檢查
  • 一致性驗證: 邏輯檢查、限制驗證
  • 格式化: 標準化輸出格式、乾淨呈現
  • 稽核日誌: 決策軌跡、法規遵循記錄

人類參與循環

  • 核准工作流程: 關鍵決策檢查點
  • 升級觸發器: 信心閾值、風險評估
  • 覆寫機制: 人類判斷優先
  • 反饋迴圈: 人類修正改善系統行為

6. 評估框架

任務完成指標

  • 成功率: 成功完成任務的百分比
  • 部分完成: 複雜任務的進度衡量
  • 任務分類: 依任務類型區分成功標準
  • 失敗分析: 根本原因識別與分類

品質評估

  • 輸出品質: 準確性、相關性、完整性衡量
  • 一致性: 針對類似輸入的反應變異性
  • 連貫性: 邏輯流程與內在一致性
  • 使用者滿意度: 反饋分數、使用模式

成本分析

  • Token 使用量: 每個任務的輸入/輸出 token 消耗
  • API 成本: 外部服務使用與費用
  • 運算資源: CPU、記憶體、儲存使用率
  • 時間價值: 每成功完成任務的成本

延遲分佈

  • 回應時間: 端到端任務完成時間
  • 處理階段: 每個階段的瓶頸識別
  • 佇列時間: 處理管線中的等待時間
  • 資源競爭: 並行操作的影響

7. 編排策略

集中式編排

  • 工作流程引擎: 中央協調器管理所有代理
  • 狀態管理: 集中的工作流程狀態追蹤
  • 決策邏輯: 複雜的路由與分支規則
  • 監控: 全面掌握所有操作的可見性

去中心化編排

  • 點對點: 代理之間直接協調
  • 服務發現: 動態代理註冊與查詢
  • 共識協議: 分散式決策制定
  • 容錯能力: 無單點故障

混合方法

  • 領域邊界: 領域內集中化,跨領域聯邦化
  • 層級協調: 多個編排層級
  • 情境依賴: 根據任務類型選擇策略
  • 負載平衡: 分佈協調責任

8. 記憶模式

短期記憶

  • 上下文視窗: 當前任務的工作記憶
  • 對話狀態: 進行中互動的臨時資料
  • 快取管理: 性能最佳化策略
  • 記憶壓力: 處理容量限制

長期記憶

  • 持久儲存: 跨對話的持久資料
  • 知識庫: 累積的領域知識
  • 經驗重播: 從過去互動中學習
  • 記憶整合: 從短期轉移到長期

共享記憶

  • 協作知識: 跨代理的共享學習
  • 同步: 一致性維護策略
  • 存取控制: 基於權限的記憶體存取
  • 記憶分割: 代理群組之間的隔離

9. 擴展考量

水平擴展

  • 代理複製: 相同代理類型的多個實例
  • 負載分佈: 跨代理實例的請求路由
  • 資源池化: 共享的運算與儲存資源
  • 地理分佈: 多區域部署

垂直擴展

  • 能力增強: 更強大的個別代理
  • 工具擴展: 每個代理更廣泛的工具存取
  • 上下文擴展: 更大的工作記憶體容量
  • 處理能力: 每個代理更高的吞吐量

性能最佳化

  • 快取策略: 回應快取、工具結果快取
  • 並行處理: 並行任務執行
  • 資源最佳化: 高效的資源使用
  • 瓶頸消除: 系統性性能調優

10. 故障處理

重試機制

  • 指數退避: 重試之間增加延遲
  • 抖動: 隨機延遲變化以防止驚群效應
  • 最大嘗試次數: 有界的重試行為
  • 重試條件: 暫時性與永久性故障分類

後備策略

  • 優雅降級: 當系統失效時提供簡化功能
  • 替代方法: 為相同目標採用不同方法
  • 預設回應: 安全的後備行為
  • 使用者溝通: 清晰的故障訊息

斷路器

  • 故障偵測: 監控故障率與回應時間
  • 狀態管理: 開啟、關閉、半開啟斷路器狀態
  • 復原測試: 逐步恢復正常操作
  • 防止級聯故障: 保護上游系統

實施指南

架構決策流程

  1. 需求分析: 了解系統目標、限制、規模
  2. 模式選擇: 選擇合適的架構模式
  3. 代理設計: 定義角色、職責、介面
  4. 工具架構: 設計工具結構與錯誤處理
  5. 通訊設計: 選擇訊息模式與協定
  6. 安全實施: 建立防護與驗證
  7. 評估規劃: 定義成功指標與監控
  8. 部署策略: 規劃擴展與故障處理

品質保證

  • 測試策略: 單元測試、整合測試和系統測試方法
  • 監控: 即時系統健康狀態與性能追蹤
  • 文件: 架構文件與操作手冊
  • 安全審查: 威脅建模與安全評估

持續改進

  • 性能監控: 持續的系統效能分析
  • 使用者反饋: 納入使用者體驗改進
  • A/B 測試: 針對系統改進的控制實驗
  • 知識庫更新: 持續學習與適應

此技能為設計穩健、可擴展的多代理系統奠定了基礎,能夠在保持安全性、可靠性和規模性能的同時,處理複雜任務。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相關技能