Create Agent

create-agent

新規サブエージェント定義を .claude/agents/<category>/<name>.md として scaffold し、品質チェックまで自動化します。

使い方

/create-agent quality/lint-runner     # カテゴリ指定で作成
/create-agent research/doc-fetcher    # research カテゴリに追加
/create-agent author/template-writer  # author カテゴリに追加
/create-agent                         # 引数省略時はインタラクティブに確認

サブエージェントの雛形は skills/claude-code-reference/sample/agent.sample.md を参照します。

カテゴリと model 選定指針

model 詳細基準

tools 最小権限原則

読み取り専用 Agent には Edit・Write・Bash を 含めない。

フロー

Step 1: カテゴリと responsibilities を確認する

引数から <category>/<agent-name> を解析する。

• カテゴリが research/・author/・quality/ のいずれかであることを確認する
• 上記以外のカテゴリが指定された場合はユーザーに確認して適切なカテゴリを選択する
• Agent の責務（担当スコープ、委譲される場面）をユーザーに確認する

Step 2: agent-author に委譲してファイルを作成する

agent-author（subagent_type: agent-author）に委譲してファイルを作成させる。

重要: agent-author は dotclaude-via-temp.md に従い、_/dotclaude/agents/<category>/<name>.md を経由して最終配置する（.claude/agents/ への直接書き込みは行わない）。

委譲プロンプト例:

subagent_type: agent-author
prompt: |
  目的: <category>/<agent-name> のサブエージェント定義を作成する
  入力:
    - Agent 名: <agent-name>
    - カテゴリ: <category>（research/author/quality/）
    - 役割・責務: <ユーザーから受け取った内容>
    - 雛形: skills/claude-code-reference/sample/agent.sample.md
    - 既存 Agent の参考: .claude/agents/ 配下の既存ファイル
  出力先: .claude/agents/<category>/<agent-name>.md
  適用ルール:
    - .claude/rules/agent-authoring.md（frontmatter・tools 最小権限・カテゴリ配置・本文骨子）
    - .claude/rules/dotclaude-via-temp.md（_/dotclaude/ 経由で作成して mv で最終配置）
  必須項目:
    - frontmatter: name（kebab-case）, description（委譲される場面を具体的に記載）,
                   model（選定基準に従う）, tools（最小権限の原則）
    - 本文: # Agent名 → ## 役割 → ## 対象スコープ → ## 遵守する規約 → ## 手順/観点 →
            ## 完了条件 → ## 報告フォーマット
    - 読み取り専用 Agent には Edit・Write・Bash を含めない

Step 3: model 選定と tools 設定を確認する

agent-author の作成結果を確認し、以下を検証する。

• model がカテゴリ・用途に合った選定になっているか
• tools が最小権限原則を守っているか
• quality/ カテゴリなのに Edit・Write・Bash が含まれていないか

Step 4: frontmatter-linter で検証する

frontmatter-linter（subagent_type: frontmatter-linter）に委譲して検証させる。

検証観点:

• name が kebab-case で正しく設定されているか
• model が規定値（haiku/sonnet/opus）のいずれかか
• tools に最小権限を超えるものが含まれていないか
• description が委譲される場面を具体的に説明しているか
• .claude/agents/<category>/ に正しく配置されているか

問題があれば agent-author に差し戻して修正させる。

Step 5: CLAUDE.md の Sub-agents 表更新を案内する

Agent 追加が完了したら以下を案内する。

✅ .claude/agents/<category>/<agent-name>.md を作成しました。

Agent の frontmatter 概要:
  name: <agent-name>
  model: <model>
  tools: [<tool-list>]

CLAUDE.md の Sub-agents 表・構造ツリーを更新するには:
  /update-docs
を実行してください。

このサブエージェントを呼び出すには、スキル内で以下を使用します:
  subagent_type: <agent-name>

検証

1. .claude/agents/<category>/<agent-name>.md が正しいパスに存在することを確認する（agent-author が dotclaude-via-temp に従い _/dotclaude/agents/ への一時作成から .claude/agents/ への mv まで一貫して実行するため、create-agent 側で mv を別途実行する必要はない） 2. frontmatter の name: フィールドが <agent-name> と一致していることを確認する 3. tools リストがカテゴリの最小権限ポリシーを遵守していることを確認する 4. subagent_type: <agent-name> で呼び出せる状態になっているか確認する

注意事項

• dotclaude-via-temp 必須: agent-author は .claude/agents/ に直接書き込まず、_/dotclaude/agents/ への一時作成から .claude/agents/ への mv まで一貫して実行する。create-agent 側で mv を別途実行する必要はない（詳細: .claude/rules/dotclaude-via-temp.md）
• `rm -rf _/dotclaude` は禁止: rmdir で空ディレクトリのみ削除する（他の並行作業との共有ディレクトリ）
• 読み取り専用 Agent の tools: research/ と quality/ カテゴリには Edit・Write・Bash を含めない
• name の解決: subagent_type: による呼び出しは frontmatter の name: フィールドで解決される。カテゴリを移動しても呼び出しコードの変更が不要
• update-docs の実行: Agent 追加後は必ず /update-docs で CLAUDE.md を最新化する