Agent Template Patterns

概要

エージェントテンプレートと設計パターンを専門とするスキル。4タイプのエージェントテンプレート（分析、実装、オーケストレーター、デプロイ）、{{variable}}形式による抽象化、抽象度バランス、概念要素設計の原則を提供します。

ワークフロー

Phase 1: 要件分析と設計

目的: タスク要件を分析し、最適なテンプレートタイプを選定する

アクション:

1. エージェントのタイプ（分析、実装、オーケストレーター、デプロイ）を判定
2. 必要な変数化レベルを決定
3. references/Level1_basics.md と references/Level2_intermediate.md で基礎と実装方法を確認
4. references/template-reference-guide.md で該当テンプレートを特定
5. 既存パターンとの互換性を検討

Task: agents/analyze-template-requirements.md を参照

Phase 2: テンプレート実装

目的: 選定したテンプレートを基にエージェントテンプレートを実装する

アクション:

1. assets/unified-agent-template.md を参照
2. {{variable}} 形式の変数を定義（references/template-variable-guide.md を参照）
3. 抽象度バランスを最適化（references/Level3_advanced.md を参照）
4. テンプレート本体を作成・拡張
5. 設計判断を記録

Task: agents/implement-template.md を参照

Phase 3: 検証と最適化

目的: テンプレートの品質を確保し、実装記録を残す

アクション:

1. scripts/validate-skill.mjs でテンプレート構造を検証
2. 抽象度とバランスをレビュー（references/Level4_expert.md を参照）
3. 概念要素設計が適切かを確認
4. scripts/log_usage.mjs を実行して実装記録を残す
5. 成果物を references/legacy-skill.md に追記（必要に応じて）

Task: agents/validate-template.md を参照

Task仕様ナビ

エージェントテンプレートパターンに関連するタスクと対応するリソース・テンプレートの対応表です。

ベストプラクティス

すべきこと

• 4つのタイプを意識する: エージェントが分析・実装・オーケストレーター・デプロイのいずれかを判定してから設計開始
• テンプレート参照ガイドを活用: template-reference-guide.md で既存11個のテンプレートから最適を選択
• {{variable}}形式で抽象化: 具体値を避け、{{変数名}}形式で再利用可能に設計
• 抽象度バランスを最適化: 高すぎず低すぎない抽象度で、多様なシナリオに対応可能に
• 概念要素を明確に: エージェントのコア概念要素を事前に定義・設計
• 検証スクリプトを実行: validate-skill.mjs で構造の正確性を確認
• 実装記録を残す: log_usage.mjs で設計判断と実装履歴を記録
• リソースレベルを段階的に活用: Level1→Level2→Level3→Level4で段階的に学習・適用

避けるべきこと

• アンチパターンを無視: references/Level3_advanced.md と Level4_expert.md のアンチパターンを確認しないまま実装
• 抽象度のズレ: 過度に具体的または過度に抽象的なテンプレートを作成
• 変数化を忘れる: ハードコーディングされた値をテンプレートに含める
• 概念要素を曖昧にする: エージェントの意図や役割を不明確なまま設計
• 検証をスキップ: validate-skill.mjs で構造検証を行わないまま納品
• 既存パターンを無視: template-reference-guide.md を確認せず、重複したテンプレートを作成
• ドキュメントをコピペ: リソースの内容を丸写しせず、プロジェクト固有にカスタマイズ

リソース参照

学習レベル別リソース

ガイドと参考資料

• references/template-reference-guide.md: 11個の既存テンプレート一覧とPhase別活用法
• references/template-variable-guide.md: {{variable}}形式の設計と使用法の詳細ガイド
• references/legacy-skill.md: 旧SKILL.mdの全文（廃止予定の内容も含む）

テンプレート

• assets/unified-agent-template.md: 統一エージェントテンプレート（Phase 2で活用）

スクリプト/ツール

変更履歴