mcpField
A
agent-design

agent-design

github.com/fusengineエージェントワークフロー3447 回インストール2 週間前に更新
リポジトリ

agent-design について

AI エージェントの構成やワークフロー、ガードレールを設計するスキルです。設計者が適切なパターンを選び、サブエージェントに必要なコンテキストだけを渡せるよう支援します。

主な機能

  1. 01ワークフローとエージェントの選択
  2. 027 種類のアーキテクチャパターン
  3. 03エージェントのワークフロー指針
  4. 04本番環境と Claude Code のテンプレート
  5. 05設計チェックとアンチパターン

活用シーン

  1. 01エージェント構成の選定
  2. 02TDD やデバッグのワークフロー実装
  3. 03Claude Code エージェント定義の作成
  4. 04ガードレール不足の設計レビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fusengine/claude-plugins --skill agent-design

インストール後、Claude Code で/agent-designを入力して読み込まれたか確認します。

詳細

エージェント設計では、高性能な AI エージェントを構築するためのアーキテクチャ上の判断を扱います。具体的には、ワークフローとエージェントの違い（コードによるオーケストレーションと、LLM による制御）、最小限のエージェント構造（アイデンティティ、機能、ツール、制約、ワークフロー）、そして「新鮮な視点」の原則です。各サブエージェントには必要なコンテキストだけを渡し、オーケストレーターの履歴全体は決して渡しません。

タスクに応じて、4 つの参考資料を案内します。アーキテクチャの選択には patterns.md（Single Agent、Orchestrator、Pipeline、Network、Supervisor、Hierarchical、Meta-Prompting）、エージェント内で APEX/TDD/Explore-Plan-Code/Review/Debug パターンを実装するには workflows.md、本番環境向けの完全なフロントマターと Claude Code エージェントテンプレートには templates.md、よくある間違いに照らして設計をレビューするには anti-patterns.md を参照してください。

エージェント設計

2025 年のパターンに基づいて高性能な AI エージェントを設計するためのスキルです。

参考資料

  • patterns.md - エージェントのアーキテクチャを選択する場合（Single Agent、Agent+Tools、Orchestrator、Pipeline、Network、Supervisor、Hierarchical、Meta-Prompting）、または各方式のトレードオフを比較する場合に読み込みます
  • workflows.md - エージェント向けに APEX、TDD、Explore-Plan-Code、Code Review、Debugging のワークフローを実装する場合に読み込みます
  • templates.md - エージェント定義全体（本番環境向けのフロントマターと各セクション）または Claude Code エージェントテンプレートを作成する場合に読み込みます
  • anti-patterns.md - よくある間違い（全知全能のエージェント、暗黙的な指示、エラー処理の不足）についてエージェント設計をレビューする場合に読み込みます

根本的な違い

ワークフローとエージェント
種類制御用途
ワークフローコードが LLM をオーケストレーション予測可能なタスク、制御が必要な場合
エージェントLLM が自身の動作を指示柔軟性、適応的な判断が必要な場合

基本原則： まずはシンプルに始め、必要に応じて複雑さを加えます。

最小限のエージェント構造

Agent:
  identity: Who am I?
  capabilities: What can I do?
  tools: What tools do I have?
  constraints: What are my limits?
  workflow: How should I proceed?

本番環境向けの完全な構造と Claude Code エージェントテンプレートについては、templates.md を参照してください。

新鮮な視点の原則

2025 年の重要な概念： 各サブエージェントには「新鮮な」コンテキストが必要です。

❌ Bad: Pass entire history to each sub-agent
✅ Good: Give only necessary information

Orchestrator:
  - Keeps complete history
  - Extracts relevant context for each sub-agent
  - Synthesizes results

設計チェックリスト

エージェントを作成する前に
  • 目的は明確ですか？
  • シンプルなワークフローで十分ですか？
  • どのツールが必要ですか？
  • どのガードレールが必要ですか？
設計中
  • アイデンティティは明確に定義されていますか？
  • ワークフローは明示されていますか？
  • エラーケースに対処していますか？
  • 例は適切ですか？
作成後
  • 標準ケースのテストはありますか？
  • エッジケースのテストはありますか？
  • セキュリティテスト（ジェイルブレイク）はありますか？
  • パフォーマンスは許容範囲内ですか？

設計時に避けるべきアンチパターンについては、anti-patterns.md を参照してください。

禁止事項

  • 明示的なワークフローなしにエージェントを作成しないでください
  • 必要もないのに、すべてのツールへのアクセスを許可しないでください
  • 最小権限の原則を無視しないでください
  • セキュリティガードレールを忘れないでください

コメント

Markdown 対応