agent-workflow-designer について
agent-workflow-designerは、実装前のマルチエージェントワークフロー設計を支援するスキルです。パターン選択とひな形生成に加え、引き継ぎ、障害復旧、コンテキストとコストの制限を扱います。
主な機能
- 01マルチエージェントのパターン選択
- 02ワークフローひな形の生成
- 03明示的な引き継ぎ契約
- 04リトライとエラー復旧のひな形
- 05コンテキストとコストの制御
活用シーン
- 01複数段階のコンテンツパイプラインを設計
- 02インシデント報告を専門エージェントに振り分け
- 03エージェントワークフローに検証ループを追加
- 04コンテキスト予算を限定してワークフローを試作
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/agent-workflow-designerを入力して読み込まれたか確認します。
同梱ファイルreferences/workflow-patterns.mdscripts/workflow_scaffolder.py
詳細
エージェントワークフローデザイナー
ティア： POWERFUL
カテゴリ： エンジニアリング
ドメイン： マルチエージェントシステム／AI オーケストレーション
概要
パターンの明確な選択、ハンドオフ契約、障害処理、コストとコンテキストの制御を備えた、本番環境向けのマルチエージェントワークフローを設計します。
主な機能
- 複数ステップのエージェントシステムに適したワークフローパターンの選択
- ワークフローをすばやく立ち上げるための設定スケルトンの生成
- 長時間実行されるフロー全体でのコンテキストとコストの規律
- エラー回復と再試行戦略のひな形
- 運用パターンのトレードオフに関するドキュメントへのリンク
使用するタイミング
- タスクの複雑さに対して単一のプロンプトでは不十分な場合
- 境界が明確な専門エージェントが必要な場合
- 実装前に決定論的なワークフロー構造を定めたい場合
- 品質または安全性のゲートに対する検証ループが必要な場合
クイックスタート
# Generate a sequential workflow skeleton
python3 scripts/workflow_scaffolder.py sequential --name content-pipeline
# Generate an orchestrator workflow and save it
python3 scripts/workflow_scaffolder.py orchestrator --name incident-triage --output workflows/incident-triage.json
パターン一覧
sequential：厳密なステップごとの依存関係チェーンparallel：独立したサブタスクのファンアウト／ファンインrouter：フォールバック付きで、意図や種類に応じて振り分けorchestrator：プランナーが依存関係を考慮して専門エージェントを調整evaluator：生成と品質ゲートを繰り返すループ
詳細なテンプレート：references/workflow-patterns.md
推奨ワークフロー
- 依存関係の形状とリスクプロファイルに基づいてパターンを選択します。
scripts/workflow_scaffolder.pyを使って設定のひな形を作成します。- すべてのエッジについて、ハンドオフ契約のフィールドを定義します。
- 再試行、タイムアウト、出力検証ゲートを追加します。
- 規模を拡大する前に、小さなコンテキスト予算でドライランを実行します。
よくある落とし穴
- 適切に構成された単一のプロンプトで解決できるタスクを、過剰にオーケストレーションする
- 外部モデルの呼び出しに対するタイムアウト／再試行ポリシーがない
- 上流のコンテキスト全体を渡し、必要な成果物に絞り込まない
- ステップごとのコストの累積を無視する
ベストプラクティス
- 要件を満たせる最小のパターンから始めます。
- ハンドオフのペイロードを明示的かつ上限付きに保ちます。
- ファンインによる統合の前に、中間出力を検証します。
- すべてのステップで予算とタイムアウトの上限を適用します。
コメント
Markdown 対応