カスタムサブエージェントの作成

• コンテキストを保持する ことで、探索と実装をメインの会話から分離します
• 制約を強制する ことで、サブエージェントが使用できるツールを制限します
• 設定を再利用する ことで、ユーザーレベルのサブエージェントをプロジェクト全体で再利用します
• 動作を特化させる ことで、特定のドメイン向けの焦点を絞ったシステムプロンプトを使用します
• コストを制御する ことで、Haiku のような高速で安価なモデルにタスクをルーティングします

​

組み込みサブエージェント

• 特定の組み込みタイプをブロックするには、特定のサブエージェントを無効にするに示されているように、permissions.denyに追加します。
• Claude がサブエージェントに委譲するのを防ぐには、permissions.denyでAgentツール自体を拒否します。
• 組み込みのExploreおよびPlanサブエージェントのみを削除するには、CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1を設定します。Claude はファイルを直接読み取り、探索し、サブエージェントに委譲しません。Claude Code v2.1.198 以降が必要です。
• 非インタラクティブモードおよびAgent SDKでは、CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1を設定して、すべての組み込みタイプを削除し、独自のタイプのみを提供します。

​

クイックスタート：最初のサブエージェントを作成する

Create a personal code-improver subagent in ~/.claude/agents/ that scans
files and suggests improvements for readability, performance, and best
practices. It should explain each issue, show the current code, and
provide an improved version. Make it read-only and have it use Sonnet.

---
name: code-improver
description: Scans files and suggests improvements for readability, performance, and best practices. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

You are a code improvement specialist. For each issue you find, explain
the problem, show the current code, and provide an improved version.

Use the code-improver agent to suggest improvements in this project

​

サブエージェントの設定

​

サブエージェントのスコープを選択する

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'

claude --agents @'
{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}
'@

​

サブエージェントファイルを作成する

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

• git をメインチェックアウトにリダイレクトするコマンドをブロックします。
• コマンドテキストから、コマンドが実行する git がすべて worktree 内に留まることを確認できないコマンドを拒否します。例えば、コマンド名が実行時に計算される場合。

​

Frontmatter リファレンス

---
name: repo-auditor
description: Audits a large repository and reports what it finds
experimental:
  cacheTtl: 1h
---

​

Claude Code がスキップするサブエージェントファイル

• name がない。Claude Code はファイルをエージェントの横に保持されたドキュメントとして扱います。
• ファイルの最初の行ではない開き ---。Claude Code はファイルに frontmatter がないと読み取り、ドキュメントとして扱います。
• - で始まるか : を含む name。Claude Code はファイルをスキップし、デバッグログにエラーを書き込みます。上記の表の name 行を参照してください。
• name があるが description がない。Claude Code はファイルをスキップし、理由をデバッグログに書き込みます。
• 解析されない YAML。Claude Code はファイルからフィールドを読み取らず、スキップして、解析エラーをデバッグログに書き込みます。

​

モデルを選択する

• モデルエイリアス。利用可能なエイリアスの 1 つを使用します。sonnet、opus、haiku、または fable
• 完全なモデル ID。claude-opus-5-5 または claude-sonnet-5 などの完全なモデル ID を使用します。--model フラグと同じ値を受け入れます
• inherit。メイン会話と同じモデルを使用します

1. 呼び出しごとの model パラメータ
2. サブエージェント定義の model frontmatter。inherit はメイン会話のモデルを選択します
3. CLAUDE_CODE_SUBAGENT_MODEL環境変数。モデルエイリアスまたはモデル ID に設定した場合
4. メイン会話のモデル

• メイン会話のモデルがそのファミリに属する。サブエージェントはメイン会話の正確なモデル（[1m] サフィックスを含む）で実行されるため、メイン会話と同じ拡張コンテキストウィンドウを取得します。
• Claude Code がメイン会話のモデルファミリを判断できない。Anthropic API 以外のプロバイダー上で。これは Claude Code がバッキングモデルに解決していないアプリケーション推論プロファイル ARNを持つ Amazon Bedrock で発生する可能性があります。このケースは opus エイリアスのみをカバーし、ANTHROPIC_DEFAULT_OPUS_MODELを設定した場合は適用されません。opus はその後、設定したモデルに解決されるため。

• opus などのファミリエイリアスがブロックされた場合、Claude Code はサブエージェントを許可リストが許可するそのファミリの最新バージョンで実行します。/model と同じ置換ルールとプロバイダースコープに従います。v2.1.222 より前では、Claude Code はブロックされたファミリエイリアスについても継承されたモデルでサブエージェントを実行していました。
• その他のブロックされた値の場合、その置換が動作しないプロバイダー、または許可リストがファミリのバージョンを許可しない場合、Claude Code は代わりに継承されたモデルでサブエージェントを実行します。CLAUDE_CODE_SUBAGENT_MODEL を設定した場合、Claude Code はそのモデルを最初に試します。これらの同じルールの下で。

​

すべてのサブエージェントを 1 つのモデルで実行する

• 両方の変数を設定した場合、サブエージェントは CLAUDE_CODE_SUBAGENT_MODEL のモデルで実行されます。
• CLAUDE_CODE_SUBAGENT_MODEL_FORCE のみを設定した場合、サブエージェントはメイン会話のモデルで実行されます。

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

• フォーク
• model: inherit を持つサブエージェントで実行されるスキル

​

サブエージェント機能を制御する

​

利用可能なツール

• Agent。サブエージェントが深さ制限にある場合。フォークではツールはリストされたままですが、代わりにエラーを返します
• AskUserQuestion
• EndConversation。メイン会話のみを終了できます。EndConversation ツール動作を参照してください
• EnterPlanMode
• ExitPlanMode。サブエージェントの permissionModeが plan でない限り
• ScheduleWakeup
• WaitForMcpServers
• Workflow

---
name: safe-researcher
description: Research agent with restricted capabilities
tools: Read, Grep, Glob, Bash
---

---
name: no-writes
description: Inherits the available tools except file writes
disallowedTools: Write, Edit
---

---
name: local-only
description: Inherits every tool except those from the github MCP server
disallowedTools: mcp__github
---

​

スポーンできるサブエージェントを制限する

---
name: coordinator
description: Coordinates work across specialized agents
tools: Agent(worker, researcher), Read, Bash
---

tools: Agent, Read, Bash

​

MCP サーバーをサブエージェントにスコープする

---
name: browser-tester
description: Tests features in a real browser using Playwright
mcpServers:
  # Inline definition: scoped to this subagent only
  - playwright:
      type: stdio
      command: npx
      args: ["-y", "@playwright/mcp@latest"]
  # Reference by name: reuses an already-configured server
  - github
---

Use the Playwright tools to navigate, screenshot, and interact with pages.

• カウントされない信頼。親フォルダの信頼、および -p または SDK セッションが設定ファイルのフックに対して取得する自動信頼
• それまで。Claude Code はそのエージェントファイル内のすべてのインラインサーバーをスキップし、~/.claude.json の正確な projects["<path>"].hasTrustDialogAccepted キーをデバッグログに書き込みます
• --add-dir ディレクトリ。信頼されたワークスペースのリポジトリの外側のディレクトリは、その .claude/agents/ ファイルがワークスペースの信頼を継承しないため、独自の信頼エントリが必要です

• 既に設定されているサーバーを参照する名前
• ~/.claude/agents/ のエージェントファイル、--agents または SDK agents オプションで渡すもの、または管理設定が提供するもの内のインラインサーバー

• --strict-mcp-configおよび --bare
• エンタープライズ管理 MCP 設定
• allowedMcpServers および deniedMcpServers ポリシー

​

権限モード

• メイン会話が bypassPermissions、acceptEdits、または自動モードにある場合、サブエージェントはそのモードで実行され、Claude Code は設定した permissionMode を無視します。自動モードでは、分類器はメイン会話のブロックおよび許可ルールでサブエージェントのツール呼び出しを評価します。サブエージェントが終了すると、分類器はその作業と最終レポートもレビューしてから、レポートが配信されます。自動モードがサブエージェントを処理する方法を参照してください。
• メイン会話が default、dontAsk、または plan モードにある場合、サブエージェントは設定した権限モードで実行されます。ただし bypassPermissions を除きます。bypassPermissions を宣言するサブエージェントはメイン会話のモードを保持します。bypassPermissions 例外には Claude Code v2.1.267 以降が必要です。

​

スキルをサブエージェントにプリロードする

---
name: api-developer
description: Implement API endpoints following team conventions
skills:
  - api-conventions
  - error-handling-patterns
---

Implement API endpoints. Follow the conventions and patterns from the preloaded skills.

​

永続メモリを有効にする

---
name: code-reviewer
description: Reviews code for quality and best practices
memory: user
---

You are a code reviewer. As you review code, update your agent memory with
patterns, conventions, and recurring issues you discover.

• サブエージェントのシステムプロンプトには、メモリディレクトリへの読み取りと書き込みの指示が含まれます。
• サブエージェントのシステムプロンプトには、メモリディレクトリの MEMORY.md の最初の 200 行または 25KB（どちらか先）も含まれます。その制限を超える場合は MEMORY.md をキュレートする指示付き。
• Read、Write、および Edit ツールは自動的に有効になり、サブエージェントはメモリファイルを管理できます。

• project は推奨されるデフォルトスコープです。サブエージェント知識をバージョン管理経由で共有可能にします。
• サブエージェントに作業開始前にメモリを確認するよう依頼します。「このプルリクエストをレビューし、以前に見たパターンについてメモリを確認してください。」
• タスク完了後にメモリを更新するようサブエージェントに依頼します。「完了したので、学習したことをメモリに保存してください。」時間をかけて、これはサブエージェントをより効果的にする知識ベースを構築します。
• メモリ指示をサブエージェントのマークダウンファイルに直接含めて、積極的にメモリを維持します。
  Update your agent memory as you discover codepaths, patterns, library
  locations, and key architectural decisions. This builds up institutional
  knowledge across conversations. Write concise notes about what you found
  and where.
  

​

フックを使用した条件付きルール

---
name: db-reader
description: Execute read-only database queries
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

#!/bin/bash
# ./scripts/validate-readonly-query.sh

INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# Block SQL write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE)\b' > /dev/null; then
  echo "Blocked: Only SELECT queries are allowed" >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

​

特定のサブエージェントを無効にする

{
  "permissions": {
    "deny": ["Agent(Explore)", "Agent(my-custom-agent)"]
  }
}

claude --disallowedTools "Agent(Explore)"

​

サブエージェント用のフックを定義する

• サブエージェントの frontmatter で。そのサブエージェントがアクティブな間のみ実行されるフックを定義
• settings.json で。セッション全体のフック。サブエージェント内でも発火します。PreToolUse および PostToolUse などのツールイベントはメイン会話と同じ方法でサブエージェントのツール呼び出しに対して発火し、SubagentStart および SubagentStop はサブエージェント開始時および終了時に発火します

​

サブエージェント frontmatter のフック

---
name: code-reviewer
description: Review code changes with automatic linting
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-command.sh $TOOL_INPUT"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/run-linter.sh"
---

​

サブエージェントイベント用のプロジェクトレベルフック

{
  "hooks": {
    "SubagentStart": [
      {
        "matcher": "db-agent",
        "hooks": [
          { "type": "command", "command": "./scripts/setup-db-connection.sh" }
        ]
      }
    ],
    "SubagentStop": [
      {
        "hooks": [
          { "type": "command", "command": "./scripts/cleanup-db-connection.sh" }
        ]
      }
    ]
  }
}

​

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

​

自動委譲を理解する

​

サブエージェントを明示的に呼び出す

• 自然言語: プロンプトでサブエージェントに名前を付けます。Claude が委譲するかどうかを決定します
• @-mention: サブエージェントが 1 つのタスクで実行されることを保証します
• セッション全体: セッション全体が --agent フラグまたは agent 設定を介して、そのサブエージェントのシステムプロンプト、ツール制限、およびモデルを使用します

test-runner サブエージェントを使用して失敗したテストを修正してください
code-reviewer サブエージェントに最近の変更を確認させてください

@"code-reviewer (agent)" 認証の変更を確認してください

claude --agent code-reviewer

claude --agent security-reviewer

claude --agent my-plugin:security-reviewer

{
  "agent": "code-reviewer"
}

​

サブエージェントをフォアグラウンドまたはバックグラウンドで実行する

• フォアグラウンドサブエージェント は、完了するまでメイン会話をブロックします。権限プロンプトは発生時にあなたに渡されます。
• バックグラウンドサブエージェント は、作業を続行しながら同時に実行されます。バックグラウンドサブエージェントが権限が必要なツール呼び出しに達すると、Claude Code はメインセッションでプロンプトを表示し、要求しているサブエージェントに名前を付けます。承認してサブエージェントを続行させるか、Esc を押してそのツール呼び出しのみを拒否し、サブエージェントを停止しません。

• インプロセス エージェントチーム チームメイトがサブエージェントを生成した場合、Claude Code はそれをフォアグラウンドで実行します。Claude Code は、定義が background: true を設定するチームメイトのサブエージェントを生成することを拒否し、エラーを返します。フォークモード がオフで、バックグラウンドタスクをオフ にしていない場合、チームメイトが run_in_background: true を設定すると、Claude Code もエラーで拒否します。
• CLAUDE_CODE_DISABLE_BACKGROUND_TASKS を 1 に設定した場合、Claude Code はすべての種類のセッションでサブエージェントをフォアグラウンドで実行し、フォークモードがオンかどうかに関わらず実行します。
• フォークモード がオンの場合（インタラクティブセッションではデフォルト）、Claude Code はサブエージェントをバックグラウンドで実行し、フォークおよび非フォークサブエージェントの両方を実行し、Claude はフォアグラウンドを要求できません。
• フォークモードがオフの場合、Claude はデフォルトでサブエージェントをバックグラウンドで実行し、結果が必要な場合はフォアグラウンドで実行します。フォークモードは 非インタラクティブモード で -p を使用する場合と、Agent SDK でオンにしない限りオフです。特定のサブエージェントを Claude が結果を必要とする場合でもバックグラウンドに保つには、そのフロントマター background フィールドを true に設定します。

• フォークモードがオフの場合、Claude にタスクをバックグラウンドまたはフォアグラウンドで実行するよう依頼します
• Ctrl+B を押して、実行中のタスクをバックグラウンドにします

• サブエージェントが正常に完了すると、Claude Code はその行をすぐに削除し、スクリーンリーダーモード を除き、フッターに「/tasks でサブエージェントを表示」を 30 秒間表示します。その 30 秒間に /tasks を実行し、サブエージェントで Enter を押してそのトランスクリプトを開きます。v2.1.232 より前では、Claude Code はサブエージェントが完了した後、失敗したものと同じ 30 秒間行を保持し、フッターヒントを表示しませんでした。
• サブエージェントが失敗するか、停止すると、Claude Code は 30 秒間その行を保持します。行をすぐにクリアするには、それを選択して x を押します。

​

サブエージェント名

​

サブエージェント内の API エラー

• フォアグラウンド: レート制限、オーバーロード、またはサーバーエラーがテキスト出力を既に生成したサブエージェントを切断した場合、Agent ツールはその部分出力を、サブエージェントが切断され、タスクを完了しなかったというメモとともに返します。何も生成しなかった、またはその唯一の出力がツール呼び出しだったサブエージェントは、Agent terminated early due to an API error で失敗し、その後にエラーの詳細が続きます。v2.1.199 では、ツール呼び出しのみの形状を切断したレート制限、オーバーロード、またはサーバーエラーは、切断メモのみを含む空の部分結果を返しました。
• バックグラウンド: サブエージェントは失敗とマークされ、Claude が受け取るメッセージは終了時に API エラーに名前を付け、サブエージェントの最後の出力を含むため、部分的な作業は失われません。

​

サブエージェント出力スキャン

• バックスラッシュ挿入: スキャンは、Claude Code 独自の出力を模倣するテキスト（<system-reminder> タグや Human: または Assistant: で始まる行など）にバックスラッシュを挿入し、模倣が会話の一部として誤解されるのではなく、通常のテキストとして読まれるようにします。
• マーカー行: スキャンは、<system-reminder> のようなタグを模倣するか、bypassPermissions や --dangerously-skip-permissions などの権限設定に言及するレポートの場合、[harness: subagent output matched instruction-shaped pattern(s): で始まる行を先頭に追加します。権限設定の言及はマーカー行を取得しますが、テキスト自体は書かれたままです。

​

一般的なパターン

​

大量の操作を分離する

サブエージェントを使用してテストスイートを実行し、失敗したテストとそのエラーメッセージのみを報告してください

​

並列研究を実行する

認証、データベース、および API モジュールを、別々のサブエージェントを使用して並列で調査してください

​

サブエージェントをチェーンする

code-reviewer サブエージェントを使用してパフォーマンスの問題を見つけ、次に optimizer サブエージェントを使用してそれらを修正してください

​

サブエージェントとメイン会話の選択

• タスクは頻繁なやり取りまたは反復的な改善が必要です
• 計画、実装、テストなど、複数のフェーズが重要なコンテキストを共有します
• 迅速でターゲットを絞った変更を行っています
• レイテンシが重要です。フォーク ではないサブエージェントは新規に開始し、コンテキストを収集するのに時間がかかる場合があります

• タスクはメインコンテキストで必要のない詳細な出力を生成します
• 特定のツール制限または権限を適用したいです
• 作業は自己完結型で、概要を返すことができます

​

サブエージェントが独自のサブエージェントを生成できるようにする

{
  "env": {
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
  }
}

​

同時実行サブエージェント制限

• /subtask で開始するインセッションフォークは、実行中にスロットを取得し、制限によってブロックされることはありません。
• 再開 済みのサブエージェントは、既に完了したスロットを取得し、制限をチェックせずに新しいスロットを取得するため、再開は実行中の数を制限を超えて押すことができます。

​

サブエージェントコンテキストを管理する

​

起動時に読み込まれるもの

• システムプロンプト: エージェント独自のプロンプトと Claude Code が追加する環境詳細。Claude Code システムプロンプトではありません。カスタムサブエージェントは マークダウン本体 または prompt フィールドで定義します。組み込みエージェントは事前定義されたプロンプトを持ちます。
• タスクメッセージ: Claude が作業を引き継ぐときに作成する委譲プロンプト。
• CLAUDE.md ファイル: メイン会話が読み込む CLAUDE.md 階層 のすべてのレベル。~/.claude/CLAUDE.md、プロジェクトルール、CLAUDE.local.md、管理ポリシーファイル、および AGENTS.md ファイル を含みます。組み込みの Explore および Plan エージェントはこれをスキップします。定義が omitClaudeMd を設定するサブエージェントは、管理ポリシーファイルのみを読み込むか、定義が 管理設定 から来る場合は何も読み込みません。
• Git ステータス: 親セッションの開始時に取得されたスナップショット。作業ディレクトリが Git リポジトリでない場合、または includeGitInstructions が false の場合は不在です。Explore および Plan はそれをスキップします。
• 事前読み込みスキル: エージェントの skills フィールド に名前が付いているスキルの完全なコンテンツ。組み込みエージェントはスキルを事前読み込みしません。
• 兄弟名簿: main とセッション内のすべての他の名前付きエージェントをリストするシステムリマインダー。各エージェントは SendMessage の有効な to 値です。Claude Code v2.1.206 以降が必要です。名簿は、サブエージェントのツールに SendMessage が含まれ、少なくとも 1 つの他のエージェントに名前がある場合にのみ表示されます。Claude が生成時に名前を付けたか、エージェントチーム チームメイトとして実行されるかに関わらず。これはサブエージェントが開始するときに取得されたスナップショットであるため、後で名前が付けられたエージェントは表示されません。

• 出力スタイル: サブエージェントは独自のシステムプロンプトを実行するため、出力スタイル はその応答を形成しません。フォーク を除きます。
• 自動メモリ: メイン会話の 自動メモリ は読み込まれません。サブエージェントに独自の永続的なメモリを与えるには、memory フィールド を使用します。
• コンテキストウィンドウサイズ: サブエージェントのコンテキストウィンドウは、親のモデルではなく、独自のモデルによってサイズ設定されます。より小さいウィンドウを持つモデルに委譲すると、そのサブエージェントはより小さいウィンドウを取得します。

​

サブエージェントを再開する

• サブエージェントが完了すると、Claude はそのエージェント ID を受け取ります。
• 組み込みの Explore および Plan エージェントは 1 回限りで、エージェント ID を返さないため、Claude はそれらを再開できません。作業を続行する必要がある場合は、general-purpose またはカスタムサブエージェントを使用してください。
• サブエージェントが maxTurns 制限で停止すると、Claude Code は返された出力を部分的としてマークします。エージェント ID を返すサブエージェントの場合、Claude Code は、Claude がサブエージェントにメッセージを送信して停止した場所から続行できることを結果に記載します。

code-reviewer サブエージェントを使用して認証モジュールをレビューしてください
[エージェントが完了します]

そのコードレビューを続行し、今度は認可ロジックを分析してください
[Claude は前の会話からのフルコンテキストでサブエージェントを再開します]

• メイン会話圧縮: メイン会話が圧縮されると、サブエージェントトランスクリプトは影響を受けません。別々のファイルに保存されます。
• セッション永続化: サブエージェントトランスクリプトはセッション内で永続化されます。Claude Code を再起動して同じセッションを再開することで、サブエージェントを再開 できます。
• 自動クリーンアップ: Claude Code は、cleanupPeriodDays 保持期間（デフォルトは 30 日）の後、サブエージェントトランスクリプトを削除し、保持スイープルール に従います。

​

自動圧縮

{
  "type": "system",
  "subtype": "compact_boundary",
  "compactMetadata": {
    "trigger": "auto",
    "preTokens": 167189
  }
}

​

現在の会話をフォークする

/subtask draft unit tests for the parser changes so far

​

実行中のフォークを観察して操作する

​

フォークと他のサブエージェントの違い

​

フォークモードをオンまたはオフにする

• Claude は fork サブエージェントタイプをリクエストすることでフォークをスポーンできます。Claude がタイプをリクエストしない場合、セッションがまだそのタイプを持っていれば汎用サブエージェントを取得します。Explore などの定義から生成されたサブエージェントは通常通り機能します。
• Claude Code は Claude がスポーンするサブエージェント（フォークと非フォークサブエージェント両方）をバックグラウンドで実行します。ただしフォアグラウンドに留まるケースは除きます。Claude Code は Agent ツールの run_in_background パラメータも削除するため、Claude はフォアグラウンドをリクエストできません。

• 1 は非インタラクティブモードおよび Agent SDK でもフォークモードをオンにします
• 0 はすべての種類のセッションでフォークモードをオフにします

​

サブエージェントの例

​

コードレビュアー

---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
model: inherit
---

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:
- Code is clear and readable
- Functions and variables are well-named
- No duplicated code
- Proper error handling
- No exposed secrets or API keys
- Input validation implemented
- Good test coverage
- Performance considerations addressed

Provide feedback organized by priority:
- Critical issues (must fix)
- Warnings (should fix)
- Suggestions (consider improving)

Include specific examples of how to fix issues.

​

デバッガー

---
name: debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
tools: Read, Edit, Bash, Grep, Glob
---

You are an expert debugger specializing in root cause analysis.

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

Debugging process:
- Analyze error messages and logs
- Check recent code changes
- Form and test hypotheses
- Add strategic debug logging
- Inspect variable states

For each issue, provide:
- Root cause explanation
- Evidence supporting the diagnosis
- Specific code fix
- Testing approach
- Prevention recommendations

Focus on fixing the underlying issue, not the symptoms.

​

データサイエンティスト

---
name: data-scientist
description: Data analysis expert for SQL queries, BigQuery operations, and data insights. Use proactively for data analysis tasks and queries.
tools: Bash, Read, Write
model: sonnet
---

You are a data scientist specializing in SQL and BigQuery analysis.

When invoked:
1. Understand the data analysis requirement
2. Write efficient SQL queries
3. Use BigQuery command line tools (bq) when appropriate
4. Analyze and summarize results
5. Present findings clearly

Key practices:
- Write optimized SQL queries with proper filters
- Use appropriate aggregations and joins
- Include comments explaining complex logic
- Format results for readability
- Provide data-driven recommendations

For each analysis:
- Explain the query approach
- Document any assumptions
- Highlight key findings
- Suggest next steps based on data

Always ensure queries are efficient and cost-effective.

​

データベースクエリバリデーター

---
name: db-reader
description: Execute read-only database queries. Use when analyzing data or generating reports.
tools: Bash
hooks:
  PreToolUse:
    - matcher: "Bash"
      hooks:
        - type: command
          command: "./scripts/validate-readonly-query.sh"
---

You are a database analyst with read-only access. Execute SELECT queries to answer questions about the data.

When asked to analyze data:
1. Identify which tables contain the relevant data
2. Write efficient SELECT queries with appropriate filters
3. Present results clearly with context

You cannot modify data. If asked to INSERT, UPDATE, DELETE, or modify schema, explain that you only have read access.

#!/bin/bash
# Blocks SQL write operations, allows SELECT queries

# Read JSON input from stdin
INPUT=$(cat)

# Extract the command field from tool_input using jq
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

if [ -z "$COMMAND" ]; then
  exit 0
fi

# Block write operations (case-insensitive)
if echo "$COMMAND" | grep -iE '\b(INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|TRUNCATE|REPLACE|MERGE)\b' > /dev/null; then
  echo "Blocked: Write operations not allowed. Use SELECT queries only." >&2
  exit 2
fi

exit 0

chmod +x ./scripts/validate-readonly-query.sh

​

次のステップ

• プラグインでサブエージェントを配布することで、チームまたはプロジェクト全体でサブエージェントを共有します
• Claude Code をプログラムで実行することで、Agent SDK を使用して CI/CD と自動化を行います
• MCP サーバーを使用することで、サブエージェントに外部ツールとデータへのアクセスを提供します