Agent Template Patterns

概要

このスキルは、再利用可能なエージェントテンプレートと設計パターンのガイドラインを提供します。

主要な価値:

• テンプレートにより、新規エージェント作成が効率化
• 変数化により、汎用性と再利用性が向上
• 適切な抽象度により、柔軟性と明確性が両立
• 概念要素により、AI が状況に応じた最適解を選択可能

リソース構造

agent-template-patterns/
├── SKILL.md
├── resources/
│   ├── template-types.md
│   ├── variable-design-guide.md
│   └── abstraction-principles.md
└── templates/
    ├── analyzer-agent-template.md
    ├── implementer-agent-template.md
    ├── orchestrator-agent-template.md
    └── deployer-agent-template.md

ワークフロー

Phase 1: テンプレートタイプの選択

4つのエージェントテンプレート:

1. 分析・レビューエージェント

ツール: [Read, Grep] ワークフロー: 分析 → チェック → レポート生成 成果物: レポートMarkdown

適用条件:

• コードレビュー
• セキュリティ監査
• 品質評価

2. 実装・生成エージェント

ツール: [Read, Write, Edit, Grep] ワークフロー: 要件理解 → 設計 → 実装 → テスト → 検証 成果物: 実装コード、テストコード

適用条件:

• 機能実装
• ファイル生成
• コード変換

3. オーケストレーターエージェント

ツール: [Task, Read] ワークフロー: 計画 → 委譲 → 進捗管理 → 統合 → 検証 成果物: 統合レポート、進捗トラッキング

適用条件:

• 複雑タスクの統括
• マルチエージェント調整
• プロジェクト管理

4. デプロイ・運用エージェント

ツール: [Bash, Read, Write, Edit, Task] ワークフロー: 準備 → 検証 → 実行 → ヘルスチェック → ロールバック（必要時） 成果物: デプロイログ、ステータスレポート

適用条件:

• CI/CDパイプライン
• インフラ管理
• 運用自動化

リソース: resources/template-types.md

Phase 2: 変数化と汎用化

目的: テンプレートを変数化して再利用可能にする

変数化の原則:

変数命名規則

形式: {{variable-name}} 例: {{agent-name}}, {{tool-list}}, {{phase-1-objective}}

変数の種類

メタデータ変数:

• {{agent-name}}: エージェント名（kebab-case）
• {{description-line-1}}: description第1行
• {{tool-list}}: ツールのリスト
• {{model-choice}}: モデル選択（opus/sonnet/haiku）
• {{version}}: バージョン番号

セクション変数:

• {{専門分野1名}}: 専門分野の名前
• {{専門分野1の詳細説明}}: 詳細
• {{責任1}}, {{責任2}}: 責任範囲
• {{制約1}}, {{制約2}}: 制約

ワークフロー変数:

• {{Phase1名}}, {{Phase1の目的}}: Phase情報
• {{ステップ1-1}}: ステップ内容
• {{判断基準1-1}}: 判断基準

リソース: resources/variable-design-guide.md

Phase 3: 抽象度のバランス

目的: 具体性と抽象性の最適なバランスを実現

3つの抽象度レベル:

過度に具体的（避けるべき）

特徴:

• 特定のコード例を大量に列挙
• 固定的な実装パターンの提示
• 技術的制約の過度な限定

影響: AI が例に固定され、柔軟性が低下

適切な抽象度（推奨）

特徴:

• 判断基準のチェックリスト形式
• 原則と制約の明確な記述
• 設計目標と品質基準の提示
• 選択肢と判断フローの提供

影響: AI が状況に応じて最適な実装を選択可能

過度に抽象的（避けるべき）

特徴:

• 曖昧な指示（「良いコードを書くこと」）
• 測定不可能な基準
• 判断根拠の欠如

影響: 判断基準が不明確、一貫性が保てない

リソース: resources/abstraction-principles.md

Phase 4: 概念要素の記述

目的: AI が適応的に動作できる概念要素を設計

4つの原則:

1. 原則ベースの記述

• 具体的な実装ではなく、守るべき原則を記述
• 技術選択の判断基準を提供
• 複数の実装パターンに適用可能な抽象度

例:

データ検証の原則:

- 型の正確性: 期待される型システムとの整合性
- 範囲の妥当性: ドメイン制約との一致
- 必須項目の存在: 必須フィールドの完全性

2. 階層的な判断基準

• レベル1（必須）: 守らなければならない原則
• レベル2（推奨）: より良い実装のためのガイドライン
• レベル3（オプション）: 状況に応じた最適化

3. 検証可能性

• 原則の適用結果が測定可能
• チェックリストによる自己評価
• 品質メトリクスとの対応

4. コンテキスト適応性

• プロジェクト固有の要件への参照
• 技術スタックに依存しない記述
• AI が状況に応じて最適解を選択できる余地

リソース: resources/abstraction-principles.md

ベストプラクティス

すべきこと

1. テンプレート選択:

   • エージェントタイプに応じた適切なテンプレート選択
   • 4つの標準テンプレートから開始

2. 変数の一貫性:

   • 命名規則の統一（kebab-case、{{variable}}形式）
   • 変数の説明を明確に

3. 適切な抽象度:

   • 原則ベースの記述
   • チェックリスト形式の判断基準
   • 検証可能な品質基準

避けるべきこと

1. 過度な具体化:

   • ❌ 大量のコード例
   • ✅ 原則と判断基準

2. 過度な抽象化:

   • ❌ 曖昧な指示
   • ✅ 測定可能な基準

3. 非標準の変数:

   • ❌ 独自の命名規則
   • ✅ {{variable}}形式の統一

トラブルシューティング

問題1: テンプレートが特定のケースにしか適用できない

症状: 汎用性が低い

原因: 過度に具体的

解決策:

1. 変数化を進める
2. 原則ベースに書き直す
3. 抽象度を上げる

問題2: テンプレートが曖昧すぎる

症状: AI が適切な判断をできない

原因: 過度に抽象的

解決策:

1. 判断基準を追加
2. チェックリスト化
3. 具体例を2-3個追加

関連スキル

• .claude/skills/agent-structure-design/SKILL.md (.claude/skills/agent-structure-design/SKILL.md): 構造設計
• .claude/skills/agent-architecture-patterns/SKILL.md (.claude/skills/agent-architecture-patterns/SKILL.md): アーキテクチャパターン
• .claude/skills/progressive-disclosure/SKILL.md (.claude/skills/progressive-disclosure/SKILL.md): トークン効率化

詳細リファレンス

詳細な実装ガイドとツールは以下を参照:

• テンプレート変数ガイド (resources/template-variable-guide.md)

コマンドリファレンス

このスキルで使用可能なリソース、スクリプト、テンプレートへのアクセスコマンド:

リソース読み取り

# テンプレート変数ガイド
cat .claude/skills/agent-template-patterns/resources/template-variable-guide.md

テンプレート参照

# 統一エージェントテンプレートを読み取る
cat .claude/skills/agent-template-patterns/templates/unified-agent-template.md

# テンプレートをコピーして新規エージェントを作成
cp .claude/skills/agent-template-patterns/templates/unified-agent-template.md .claude/agents/new-agent.md

他のスキルのスクリプトを活用

# エージェント構造検証（agent-structure-designスキルのスクリプトを使用）
node .claude/skills/agent-structure-design/scripts/validate-structure.mjs <agent_file.md>

# 循環依存チェック（agent-dependency-designスキルのスクリプトを使用）
node .claude/skills/agent-dependency-design/scripts/check-circular-deps.mjs <agent_file.md>

# アーキテクチャ検証（agent-architecture-patternsスキルのスクリプトを使用）
node .claude/skills/agent-architecture-patterns/scripts/validate-architecture.mjs <agent_file.md>

メトリクス

テンプレート再利用率

目標: >70%のエージェントがテンプレートベース

抽象度スコア

評価基準:

• 具体性: 3-5点（適度）
• 抽象性: 3-5点（適度）
• バランス: 6-10点（高い）

目標: バランス8点以上

変更履歴

バージョン	日付	変更内容
1.0.0	2025-11-24	初版作成 - テンプレートとパターンフレームワーク

使用上の注意

このスキルが得意なこと

• 汎用エージェントテンプレートの設計
• 変数化と抽象化
• 抽象度バランスの最適化
• 概念要素の記述

このスキルが行わないこと

• エージェントの実際の実装
• 具体的なコード生成
• プロジェクト固有のビジネスロジック