agent-factory

Agent Factory

本番環境で使える Claude Code エージェントとサブエージェントを生成する包括的なシステムです。このスキルでは、Claude Code のエージェントシステムにシームレスに統合できるカスタムエージェントを作成するためのテンプレート、標準、生成ツールを提供します。

このスキルでできること

このスキルを使うと、あらゆるドメインやワークフロー向けにカスタム Claude Code エージェントを作成できます。Claude Code が関連する場面で自動的に検出して呼び出せる、適切な形式のエージェントファイルを生成します。

機能

1. カスタムエージェントの生成 - あらゆるドメイン（フロントエンド、バックエンド、テスト、プロダクトなど）向けの特化型エージェントを作成します
2. 強化された YAML フロントマター - 色分け、フィールドのカテゴリ分け、専門知識のレベルなど、豊富なメタデータを含めます
3. ツールアクセスに関するガイダンス - エージェントの種類に基づいて最適なツール設定を推奨します
4. MCP 統合 - 機能を強化する、関連する MCP サーバーツールを提案します
5. 実行パターンの割り当て - 安全性を確保できるよう、適切な並列実行または逐次実行を指定します
6. 検証 - エージェントの設定がベストプラクティスに準拠しているか確認します

対応するエージェントの種類

戦略エージェント（軽量、並列実行に安全）

• 目的: 計画、調査、分析
• ツール: Read、Write、Grep のみ
• 実行: 4〜5 個のエージェントを並列実行可能
• 色: 青
• 例: product-planner、market-researcher、architect

実装エージェント（全ツール対応、連携実行）

• 目的: コードの作成、機能の構築
• ツール: Read、Write、Edit、Bash、Grep、Glob
• 実行: 2〜3 個のエージェントが連携
• 色: 緑
• 例: frontend-developer、backend-developer、api-builder

品質エージェント（Bash を多用、逐次実行のみ）

• 目的: テスト、検証、レビュー
• ツール: Read、Write、Edit、Bash、Grep、Glob
• 実行: 一度に 1 個のエージェントのみ（並列実行は絶対に不可）
• 色: 赤
• 例: test-runner、code-reviewer、security-auditor

調整エージェント（軽量、オーケストレーション）

• 目的: 他のエージェントを管理し、統合を検証
• ツール: Read、Write、Grep
• 実行: 他のエージェントを統括
• 色: 紫
• 例: fullstack-coordinator、workflow-manager

強化された YAML フロントマター

生成される各エージェントには、豊富なメタデータが含まれます。

---
name: agent-name-kebab-case
description: When to invoke this agent
tools: Read, Write, Edit  # Comma-separated
model: sonnet  # sonnet|opus|haiku|inherit
color: green  # Visual categorization
field: frontend  # Domain area
expertise: expert  # beginner|intermediate|expert
mcp_tools: mcp__playwright  # MCP integrations
---

フィールドカテゴリ

開発: frontend、backend、fullstack、mobile、devops 品質: testing、security、performance 戦略: product、architecture、research、design ドメイン: data、ai、content、finance、infrastructure

色分け

• 青: 戦略・計画エージェント
• 緑: 実装・開発エージェント
• 赤: 品質・テストエージェント
• 紫: 調整・オーケストレーションエージェント
• オレンジ: ドメイン特化型エージェント

専門知識のレベル

• 初級: シンプルで、対象を絞ったタスク
• 中級: 中程度の複雑さのワークフロー
• エキスパート: 高度で複雑な処理

使用方法

クイックスタート

1. プロンプトテンプレートを開く: documentation/templates/AGENTS_FACTORY_PROMPT.md
2. 一番下までスクロール - テンプレート変数を見つけます
3. 詳細を入力:

   AGENT_NAME: my-custom-agent
   DESCRIPTION: What this agent does and when to invoke it
   DOMAIN_FIELD: frontend
   TOOLS_NEEDED: Read, Write, Edit, Bash
   

4. プロンプト全体をコピー - 入力した変数も含めます
5. Claude に貼り付ける - Claude.ai、Claude Code、または API
6. エージェントファイルを受け取る - すぐに使える完全な .md ファイル
7. エージェントをインストール - .claude/agents/ または ~/.claude/agents/ にコピーします

呼び出し例

@agent-factory

Create a custom agent:
Name: api-integration-specialist
Type: Implementation
Domain: backend
Description: API integration expert for third-party services
Capabilities: OAuth, REST clients, error handling
Tools: Read, Write, Edit, Bash
MCP: mcp__github

出力: 完全な .claude/agents/api-integration-specialist.md ファイル

生成されるエージェントの構造

生成される各エージェントは、単一の Markdown ファイルです。

---
name: custom-agent
description: Triggers auto-invocation
tools: Read, Write, Edit
model: sonnet
color: green
field: backend
expertise: expert
mcp_tools: mcp__github
---

You are a [role] specializing in [domain].

When invoked:
1. [Step 1]
2. [Step 2]
3. [Step 3]

[Detailed instructions]
[Checklists]
[Best practices]
[Output format]

統合ワークフロー

ワークフロー 1: 機能開発

1. product-planner → Creates requirements
2. frontend-developer + backend-developer → Build (parallel)
3. test-runner → Validates (sequential)
4. code-reviewer → Reviews (sequential)

ワークフロー 2: バグ修正

1. debugger → Analyzes issue
2. [appropriate-dev-agent] → Fixes
3. test-runner → Validates fix

ワークフロー 3: コードレビュー

1. code-reviewer → Quality review (can run solo)
2. security-auditor → Security scan (can run solo)

MCP ツールの統合

統合する一般的な MCP サーバー：

• mcp__github：PR レビュー、issue、リポジトリ操作
• mcp__playwright：E2E テスト、スクリーンショット、ブラウザー自動化
• mcp__context7：ドキュメント検索、ナレッジクエリ
• mcp__filesystem：高度なファイル操作
• カスタム MCP サーバー：ユーザーが設定した任意の MCP ツール

エージェントは、設定されている場合、その機能で MCP ツールを自動的に参照します。

安全性とパフォーマンス

プロセスの監視

エージェントはシステムリソースを消費します。次のコマンドで監視してください：

ps aux | grep -E "mcp|npm|claude" | wc -l

安全な範囲：

• 15-20：戦略エージェント（並列）
• 20-30：実装エージェント（協調）
• 12-18：品質エージェント（逐次）

警告：

• 30：並列化を減らしてください

• 60：重大 — システムを再起動してください

実行ルール

✅ 安全：戦略エージェント4～5体を並列実行 ✅ 安全：実装エージェント2～3体を協調実行 ❌ 危険：品質エージェントの並列実行（システムがクラッシュします）

ベストプラクティス

1. エージェントの担当範囲を明確にする — エージェントごとに明確な責任を1つ設定します
2. 説明を具体的にする — 自動呼び出しが可能になります
3. ツールのアクセスパターンに従う — エージェントの種類に合ったツールを使用します
4. 実行パターンを指定する — パフォーマンスの問題を防ぎます
5. MCP ツールを活用する — エージェントの機能を強化します
6. エージェントを段階的にテストする — シンプルな状態から始め、複雑さを加えていきます
7. エージェントをバージョン管理する — プロジェクトのエージェントを git にコミットします

制限事項

• エージェントはテンプレートです。ニーズに合わせてカスタマイズしてください
• ツールの提案はガイドラインであり、必須ではありません
• MCP ツールを使用するには、サーバーの設定が必要です
• パフォーマンスはシステムリソースによって異なります
• 生成されたエージェントは、お使いの環境でテストする必要があります

インストール

生成されたエージェントファイル：

次のいずれかの場所に配置します：

プロジェクトエージェント（チームと共有）：

.claude/agents/custom-agent.md

個人用エージェント（あらゆる場所で利用可能）：

~/.claude/agents/custom-agent.md

このスキルを使用する場面

次のような場合にカスタムエージェントを作成します：

• ドメイン固有のワークフロー（データサイエンス、ML、金融）
• チーム固有の規約（コードスタイル、テスト方法）
• 専門的なツールやフレームワーク（Shopify、AWS、Kubernetes）
• カスタム MCP サーバーとの統合
• エージェントのアイデアの迅速なプロトタイピング

次のような場合は AGENTS_FACTORY_PROMPT.md テンプレートを使用します：

• 関連するエージェントが複数必要な場合
• 一貫性のあるエージェントのパターンを使用したい場合
• エージェント型フレームワークを構築する場合
• エージェントのコンセプトをすばやくテストしたい場合

---

バージョン：1.0.0 最終更新日：2025年10月22日 互換性：Claude Code（エージェントシステム） テンプレートの場所：documentation/templates/AGENTS_FACTORY_PROMPT.md