Communitygithub.com

Agent Designer - マルチエージェントシステムアーキテクチャ

マルチエージェントシステムを設計、構築、評価するための包括的なツールキット。アーキテクチャパターン、ツール設計原則、コミュニケーション戦略、パフォーマンス評価フレームワークを提供します。

Agent Designer - マルチエージェントシステムアーキテクチャ とは?

Agent Designerは、開発者が堅牢でスケーラブルなマルチエージェントAIシステムを設計・構築するための詳細なガイドです。シングルエージェント、スーパーバイザー、スウォーム、階層型、パイプラインといった主要なアーキテクチャパターンをカバーし、それぞれのユースケース、メリット、デメリット、実装方法を説明します。また、エージェントの役割定義、ツール設計の原則(スキーマ設計、エラーハンドリング、冪等性)、非同期メッセージングやイベント駆動型アーキテクチャなどのコミュニケーションパターン、安全性のためのガードレール、タスク完了率やコスト分析を含む評価フレームワークについても詳述しています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、小規模なプロトタイプから大規模な本番システムまで、複雑なタスクを処理できるマルチエージェントシステムの設計基盤を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-designer

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Agent Designer - マルチエージェントシステムアーキテクチャ は何をしますか?

Tier: POWERFUL
カテゴリ: エンジニアリング
タグ: AIエージェント, アーキテクチャ, システム設計, オーケストレーション, マルチエージェントシステム

概要

Agent Designerは、マルチエージェントシステムの設計、アーキテクチャ、評価のための包括的なツールキットです。堅牢でスケーラブルなAIエージェントシステムを構築するための、エージェントアーキテクチャパターン、ツール設計原則、コミュニケーション戦略、パフォーマンス評価フレームワークへの構造化されたアプローチを提供します。

コア機能

1. エージェントアーキテクチャパターン

シングルエージェントパターン

  • ユースケース: 明確な境界を持つシンプルで焦点を絞ったタスク
  • メリット: 最小限の複雑さ、デバッグの容易さ、予測可能な動作
  • デメリット: スケーラビリティの制限、単一障害点
  • 実装: ユーザーとエージェントの直接的なやり取りと包括的なツールアクセス

スーパーバイザーパターン

  • ユースケース: 集中制御による階層的なタスク分解
  • アーキテクチャ: 複数の専門エージェントを調整する1つのスーパーバイザーエージェント
  • メリット: 明確な命令構造、集中型の意思決定
  • デメリット: スーパーバイザーのボトルネック、複雑な調整ロジック
  • 実装: スーパーバイザーがタスクを受領し、専門家に委任し、結果を集約

スウォームパターン

  • ユースケース: ピアツーピアのコラボレーションによる分散型問題解決
  • アーキテクチャ: 共通の目標を持つ複数の自律エージェント
  • メリット: 高い並列性、フォールトトレランス、創発的知能
  • デメリット: 複雑な調整、潜在的な競合、予測の難しさ
  • 実装: エージェント発見、合意形成メカニズム、分散タスク割り当て

階層型パターン

  • ユースケース: 複数の組織階層を持つ複雑なシステム
  • アーキテクチャ: 異なるレベルにマネージャーとワーカーを持つツリー構造
  • メリット: 自然な組織マッピング、明確な責任
  • デメリット: 通信オーバーヘッド、各レベルでの潜在的なボトルネック
  • 実装: フィードバックループを伴うマルチレベルの委任

パイプラインパターン

  • ユースケース: 特殊なステージによる逐次処理
  • アーキテクチャ: 処理パイプラインに配置されたエージェント
  • メリット: 明確なデータフロー、ステージごとの最適化
  • デメリット: 逐次的なボトルネック、固定された処理順序
  • 実装: ステージ間のメッセージキュー、状態の引き継ぎ

2. エージェントの役割定義

役割仕様フレームワーク

  • アイデンティティ: 名前、目的ステートメント、コアコンピテンシー
  • 責任: 主要タスク、意思決定の境界、成功基準
  • 能力: 必要なツール、知識領域、処理制限
  • インターフェース: 入出力形式、通信プロトコル
  • 制約: セキュリティ境界、リソース制限、運用ガイドライン

一般的なエージェントアーキタイプ

コーディネーターエージェント

  • マルチエージェントワークフローを調整
  • 高レベルの意思決定とリソース割り当てを実行
  • システムの健全性とパフォーマンスを監視
  • エスカレーションと競合解決を処理

スペシャリストエージェント

  • 特定のドメイン(コード、データ、研究)における深い専門性
  • 専門タスクに最適化されたツールと知識
  • 狭い範囲内での高品質な出力
  • 範囲外のリクエストに対する明確な引き継ぎプロトコル

インターフェースエージェント

  • 外部とのやり取り(ユーザー、API、システム)を処理
  • プロトコル変換とフォーマット変換
  • 認証と認可管理
  • ユーザーエクスペリエンスの最適化

モニターエージェント

  • システム健全性の監視とアラート
  • パフォーマンスメトリクスの収集と分析
  • 異常検知とレポート
  • コンプライアンスと監査証跡の維持

3. ツール設計原則

スキーマ設計

  • 入力検証: 強い型付け、必須パラメータとオプションパラメータ
  • 出力の一貫性: 標準化されたレスポンス形式、エラーハンドリング
  • ドキュメント: 明確な説明、使用例、エッジケース
  • バージョニング: 後方互換性、移行パス

エラーハンドリングパターン

  • グレースフルデグラデーション: 依存関係が失敗した場合の部分的な機能
  • リトライロジック: 指数バックオフ、サーキットブレーカー、最大試行回数
  • エラー伝播: 構造化されたエラーレスポンス、エラー分類
  • リカバリ戦略: フォールバックメソッド、代替アプローチ

冪等性要件

  • 安全な操作: 副作用のない読み取り操作
  • 冪等な書き込み: 同じ操作を安全に繰り返し可能
  • 状態管理: バージョン追跡、競合解決
  • 原子性: オールオアナッシングの操作完了

4. コミュニケーションパターン

メッセージパッシング

  • 非同期メッセージング: 疎結合エージェント、メッセージキュー
  • メッセージ形式: メタデータを含む構造化ペイロード
  • 配信保証: 最低1回、正確に1回のセマンティクス
  • ルーティング: ダイレクトメッセージング、パブリッシュ-サブスクライブ、ブロードキャスト

共有状態

  • 状態ストア: 集中型データリポジトリ
  • 一貫性モデル: 強整合性、結果整合性、弱整合性
  • アクセスパターン: 読み取り集中、書き込み集中、混合ワークロード
  • 競合解決: 最終書き込み優先、マージ戦略

イベント駆動型アーキテクチャ

  • イベントソーシング: 不変のイベントログ、状態の再構築
  • イベントタイプ: ドメインイベント、システムイベント、統合イベント
  • イベント処理: リアルタイム、バッチ、ストリーム処理
  • イベントスキーマ: バージョン管理されたイベント形式、後方互換性

5. ガードレールと安全性

入力検証

  • スキーマ強制: 必須フィールド、型チェック、形式検証
  • コンテンツフィルタリング: 有害コンテンツ検出、PIIスクラビング
  • レート制限: リクエストスロットリング、リソースクォータ
  • 認証: 本人確認、認可チェック

出力フィルタリング

  • コンテンツモデレーション: 有害コンテンツの除去、品質チェック
  • 一貫性検証: 論理チェック、制約検証
  • フォーマット: 標準化された出力形式、クリーンな表示
  • 監査ログ: 決定トレイル、コンプライアンスレコード

ヒューマンインザループ

  • 承認ワークフロー: 重要な意思決定ポイント
  • エスカレーショントリガー: 信頼度しきい値、リスク評価
  • オーバーライドメカニズム: 人間の判断の優先
  • フィードバックループ: 人間による修正がシステム動作を改善

6. 評価フレームワーク

タスク完了メトリクス

  • 成功率: 正常に完了したタスクの割合
  • 部分完了: 複雑なタスクの進捗測定
  • タスク分類: タスクタイプ別の成功基準
  • 失敗分析: 根本原因の特定と分類

品質評価

  • 出力品質: 正確性、関連性、完全性の測定
  • 一貫性: 類似入力に対する応答のばらつき
  • コヒーレンス: 論理フローと内部一貫性
  • ユーザー満足度: フィードバックスコア、使用パターン

コスト分析

  • トークン使用量: タスクあたりの入出力トークン消費
  • 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".

関連スキル