mcpField
A
agent-design

agent-design

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

agent-design について

agent-designは、AIエージェントの構成やワークフローを設計するためのスキルです。構成選択、ワークフロー、テンプレート、アンチパターンを参照でき、サブエージェントには必要なコンテキストだけを渡す考え方を扱います。

主な機能

  1. 01エージェント構成の比較
  2. 02ワークフロー設計のガイド
  3. 03本番用・Claude Codeテンプレート
  4. 04設計上のアンチパターン確認
  5. 05サブエージェントの文脈を限定

活用シーン

  1. 01単一・複数エージェント構成の選択
  2. 02エージェントの手順定義
  3. 03Claude Codeエージェント定義の作成
  4. 04ツール権限とエラー処理の確認

インストール

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

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

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
anti-patterns.md
patterns.md
templates.md
workflows.md

詳細

エージェント設計では、高性能な 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 対応