subagent-creator

サブエージェントの作成

このスキルでは、効果的でエージェントに依存しないサブエージェントを作成するためのガイダンスを提供します。

サブエージェントとは？

サブエージェントは、AI エージェントがタスクを委任できる、専門分野に特化したアシスタントです。特徴は次のとおりです。

• 分離されたコンテキスト：各サブエージェントには独自のコンテキストウィンドウがあります
• 並列実行：複数のサブエージェントを同時に実行できます
• 専門性：特定のプロンプトと専門知識を設定できます
• 再利用可能：一度定義すれば、複数のコンテキストで使用できます

サブエージェントとスキルの使い分け

Is the task complex with multiple steps?
├─ YES → Does it require isolated context?
│         ├─ YES → Use SUBAGENT
│         └─ NO → Use SKILL
│
└─ NO → Use SKILL

サブエージェントを使用する場面：

• 分離されたコンテキストが必要な複雑なワークフロー
• 専門性が役立つ、時間のかかるタスク
• 検証と監査（独立した視点）
• 並列の作業工程

スキルを使用する場面：

• 素早く実行できる、一度限りの操作
• コンテキストの分離を必要としない専門知識
• 分離を必要としない再利用可能な手順

サブエージェントの構成

サブエージェントは通常、フロントマターのメタデータを含む Markdown ファイルです。

---
name: agent-name
description: Description of when to use this subagent.
model: inherit # or fast, or specific model ID
readonly: false # true to restrict write permissions
---

You are an [expert in X].

When invoked:

1. [Step 1]
2. [Step 2]
3. [Step 3]

[Detailed instructions about expected behavior]

Report [type of expected result]:

- [Output format]
- [Metrics or specific information]

サブエージェントの作成手順

1. 目的を定義する

• サブエージェントが担う具体的な責任は何ですか？
• なぜ分離されたコンテキストが必要ですか？
• 複数の複雑な手順が含まれますか？
• 高度な専門性が必要ですか？

2. メタデータを設定する

name（必須）

一意の識別子です。ケバブケースを使用してください。

name: security-auditor

description（重要）

自動委任において非常に重要です。このサブエージェントをいつ使用するかを説明します。

適切な説明の例：

• 「セキュリティの専門家。認証、支払いの実装、または機密データの取り扱い時に使用します。」
• 「エラーやテストの失敗に対応するデバッグの専門家。問題が発生したときに使用します。」
• 「完了した作業を検証します。タスクが完了とマークされた後に使用します。」

自動委任を促す表現：

• 「…の場合は積極的に使用してください」
• 「…には常に使用してください」
• 「…の場合は自動的に委任してください」

model（任意）

model: inherit  # Uses same model as parent (default)
model: fast     # Uses fast model for quick tasks

readonly（任意）

readonly: true # Restricts write permissions

3. サブエージェントのプロンプトを作成する

以下を定義します。

1. 役割：「あなたは［専門家］です…」
2. 呼び出されたとき：使用される状況
3. 手順：従うべき具体的な手順
4. 期待される出力：形式と内容

テンプレート：

You are an [expert in X] specialized in [Y].

When invoked:

1. [First action]
2. [Second action]
3. [Third action]

[Detailed instructions about approach]

Report [type of result]:

- [Specific format]
- [Information to include]
- [Metrics or criteria]

[Philosophy or principles to follow]

よくあるサブエージェントのパターン

1. 検証エージェント

目的：完了した作業が実際に機能することを独立して検証します。

---
name: verifier
description: Validates completed work. Use after tasks are marked done.
model: fast
---

You are a skeptical validator.

When invoked:

1. Identify what was declared as complete
2. Verify the implementation exists and is functional
3. Execute tests or relevant verification steps
4. Look for edge cases that may have been missed

Be thorough. Report:

- What was verified and passed
- What is incomplete or broken
- Specific issues to address

2. デバッガー

目的：根本原因分析の専門家です。

---
name: debugger
description: Debugging specialist. Use when encountering errors or test failures.
---

You are a debugging expert.

When invoked:

1. Capture the error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify the solution works

For each issue, provide:

- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach

3. セキュリティ監査担当

目的：コードを監査するセキュリティの専門家です。

---
name: security-auditor
description: Security specialist. Use for auth, payments, or sensitive data.
---

You are a security expert.

When invoked:

1. Identify security-sensitive code paths
2. Check for common vulnerabilities
3. Confirm secrets are not hardcoded
4. Review input validation

Report findings by severity:

- **Critical** (must fix before deploy)
- **High** (fix soon)
- **Medium** (address when possible)
- **Low** (suggestions)

4. コードレビュー担当

目的：品質を重視したコードレビューを行います。

---
name: code-reviewer
description: Code review specialist. Use when changes are ready for review.
---

You are a code review expert.

When invoked:

1. Analyze the code changes
2. Check readability, performance, patterns, error handling
3. Identify code smells and potential bugs
4. Suggest specific improvements

Report:
**✅ Approved / ⚠️ Approved with caveats / ❌ Changes needed**

**Issues Found:**

- **[Severity]** [Location]: [Issue]
  - Suggestion: [How to fix]

ベストプラクティス

✅ 推奨事項

• 焦点を絞ったサブエージェントを作成する：責任を明確に一つにします
• 説明に力を入れる：委任するタイミングを決定します
• プロンプトを簡潔に保つ：直接的で具体的にします
• チームで共有する：サブエージェントの定義をバージョン管理します
• 説明をテストする：正しいサブエージェントが呼び出されることを確認します

❌ 避けるべきこと

• 曖昧な説明：「一般的なタスクに使用」では判断の手がかりになりません
• 長すぎるプロンプト：2000語にしても賢くなるわけではありません
• サブエージェントの作りすぎ：まずは焦点を絞ったものを2～3個作成します

品質チェックリスト

最終確定する前に確認してください。

• 説明に、委任するタイミングが具体的に記載されている
• 名前にケバブケースが使われている
• 責任が明確に一つである（汎用的ではない）
• プロンプトが簡潔でありながら十分な内容になっている
• 指示が実行可能である
• 出力形式が明確に定義されている
• モデルの設定が適切である

出力メッセージ

サブエージェントを作成する場合：

✅ Subagent created successfully!

📁 Location: .agent/subagents/[name].md
🎯 Purpose: [brief description]
🔧 How to invoke:
   - Automatic: Agent delegates when it detects [context]
   - Explicit: /[name] [instruction]

💡 Tip: Include keywords like "use proactively" to encourage delegation.