| name | create-agent |
| description | Create a new sub-agent definition file (agents/*.md) for the Claude Code plugin. Use this skill when the user wants to add a new specialized agent, define a new agent type, or create an agent that handles a specific domain of tasks. Trigger whenever the user mentions creating, adding, or defining a new agent or sub-agent. |
| argument-hint | [agent description or purpose] |
| model | opus |
Create Agent
引数で受け取った内容をもとに、サブエージェント定義ファイル（agents/*.md）を作成するスキルです。
このスキルが呼び出された際には、Instructionsに従ってエージェントの目的・役割を分析し、適切なエージェント定義を作成してください。
Instructions
1. 既存エージェントの確認
まず、既存のエージェント一覧を確認し、重複や類似のエージェントがないか確認してください。
ls base-tools/agents/
既に類似の目的を持つエージェントが存在する場合は、ユーザーに報告し、新規作成か既存エージェントの更新かを確認してください。
2. エージェントの分析
$ARGUMENTS の内容を分析し、以下を特定してください：
- 目的: エージェントが解決すべき課題
- トリガー条件: どのような状況でこのエージェントが起動されるべきか
- 必要なツール: エージェントが使用するツール（Bash, Read, Grep, Glob, Agent, Edit, Write など）
- モデル要件: タスクの複雑さに応じた適切なモデル（sonnet: 高速・コスト効率重視、opus: 高品質・複雑なタスク向け）
- メモリスコープ: user（ユーザー固有の学習）、project（プロジェクト固有の学習）、または不要
3. コードベースの調査
Explore サブエージェントを使用して、エージェントが対象とするドメインに関連するコードベースの構造を調査してください。
エージェントのプロンプトに含めるべきプロジェクト固有の知識（アーキテクチャパターン、規約、ワークフロー）を把握してください。
4. エージェント定義ファイルの作成
以下の構造で base-tools/agents/<agent-name>.md ファイルを作成してください。
ファイル構造
---
name: <agent-name>
description: "<トリガー条件を明確に記述した説明文。Claudeがこのエージェントを自動起動する判断基準になるため、具体的なユースケースと例を含める>"
model: <sonnet|opus>
color: <cyan|blue|green|yellow|magenta|red>
memory: <user|project>（必要な場合のみ）
isolation: worktree（git操作を伴う場合のみ）
---
<エージェントのプロンプト本文>
frontmatter各フィールドのガイドライン
name
- kebab-case（ハイフン区切り小文字）で記述
- 役割が明確にわかる名前にする
description
- Claudeが自動的にエージェントを起動する判断基準になる最も重要なフィールド
- 以下の構造で記述する：
- エージェントの用途を1文で説明
- 具体的なトリガー条件と使用シーン
- Examples（
<example> タグを使用した具体的な使用例を2-3個）
- 各Exampleには
userの発言、assistantの判断、<commentary> での補足を含める
model
sonnet: 定型的な処理、パターンマッチング、高速処理が必要なタスクopus: 複雑な判断、創造的な文章生成、多段階の推論が必要なタスク
memory
user: ユーザーの好みや作業スタイルを学習すべきエージェントproject: プロジェクト固有のパターンや規約を学習すべきエージェント- 単純な処理タスクの場合は省略可
isolation
worktree: git操作（checkout, commit, push等）を伴うエージェントに指定- ファイルの読み取りのみの場合は不要
プロンプト本文のガイドライン
プロンプト本文は以下の構成で記述してください：
- 冒頭の役割定義: 1-2文でエージェントの専門性と責務を明示
- 基本方針/作業プロセス: 段階的な手順を定義（ステップ形式）
- 品質基準: 出力の品質を保証するためのチェックリスト
- 出力形式: エージェントが返す結果のフォーマット
プロンプトの記述で守るべきルール：
- 日本語で記述する
- 命令形で指示を書く（「〜してください」ではなく「〜する」形式も可）
- プロジェクト規約を織り込む（TDD、コメント禁止、型安全性など）
- ワークツリーで動作するエージェント（
isolation: worktree）には、ワークツリー内での作業を明示する指示を含める
5. 確認と報告
作成したエージェント定義ファイルの内容をユーザーに報告し、以下を説明してください：
- エージェント名と役割
- トリガー条件（どのような状況で起動されるか）
- 使用モデルと理由
- メモリスコープの選択理由（設定した場合）
