概要

claude code に /agents コマンドが追加されたので簡単に使ってみる

主に公式情報の要約と, 実動作の画面を記述します

/agents コマンドとは

sub agent を作成する機能

sub agent とは

司令塔である Claude Code がタスクに応じて呼び出すことができる, 得意分野を持つ専門 agent

特徴

メインから独立した独自のコンテキストウィンドウを持つ
以下ユーザー設定
- 特定の目的と専門分野
- 許可された特定のツール
  - Rread, Write などの permission
- sub agent 固有のカスタムシステムプロンプト

いつ動作するのか?

設定された専門分野に合致するタスクと遭遇した際, 自動で対応するサブエージェントを実行する.
サブエージェントは独立して作業を行い, 結果を返す

公式情報

/agents で実際に sub agent を作成して動かす

/agents を実行
create new agent を選択
sub agent 作成先の directory を選択
ここでは claude による作成を選択します
ここでは sample にある reivew 機能を作成
プロンプトを投入し実行後, しばらく待機
sub agent に付与する permisison を選択
sub agent の color を選択
sub agent 概要が提示される
問題なければ Enter で確定する
Project agents へ sub agent が表示される
code review を実行してください と指示を与える
オレンジの背景色で sub agent が実行されている事がわかります

sub agent file の保存先

種類	場所	スコープ	優先度
`sub agents`	`.claude/agents/`	Available in current project	Highest
`User sub agents`	`~/.claude/agents/`	Available across all projects	Lower

file 形式

実際に作成されたファイル

以下の構造を持つ

---
name: your-agent-name
description: このサブエージェントをいつ呼び出すべきかの説明
tools: tool1, tool2, tool3  # オプション - 省略した場合は全てのツールを継承
---

ここにサブエージェントのシステムプロンプトを書きます。複数段落にわたって記述可能で, 
サブエージェントの役割, 能力, 問題解決へのアプローチを明確に定義してください。

具体的な指示やベストプラクティス, サブエージェントが従うべき制約事項なども
含めると良いでしょう。

設定項目

項目	必須	説明
`name`	はい	小文字とハイフンを使った一意の識別子。
`description`	はい	サブエージェントの目的を自然な言葉で説明したもの。
`tools`	いいえ	特定のツールをカンマ区切りでリストアップ。省略した場合, メインスレッドから全てのツールを継承します。

tools list

sub agent の呼び出し

設定ファイル側での設定

Claude Code は文脈に応じて動的にサブエージェントを選択する
最良の結果を得るために, description 項目は具体的で行動を促すような内容にする

また, description に以下を含めると効果的

積極的に使用（use PROACTIVELY）
必ず使用（MUST BE USED）

明示的な呼び出し

コマンドで言及することで, 特定のサブエージェントを指名する

test-runner サブエージェントを使って, 失敗したテストを修正して

code-reviewer サブエージェントに, 最近の変更を見てもらって

debugger サブエージェントに, このエラーを調査するよう頼んで

sub agent example

ベストプラクティス

まずは Claude に土台を作成して貰いカスタマイズしていく
単一の明確な役割を持つサブエージェントを作成する
システムプロンプトは, 具体的な指示, 例, 制約を含める
- ガイドが詳しければ詳しいほど, サブエージェントはより良く機能する
サブエージェントの目的に必要な tool だけを許可する
バージョン管理に含め, チームで共同で改善・利用する

高度な利用方法

サブエージェントの連鎖（チェイニング）

複数のサブエージェントを順次実行可能

まず code-analyzer サブエージェントでパフォーマンスの問題を見つけて, 次にoptimizer サブエージェントでそれを修正して

パフォーマンスに関する考慮事項

コンテキストの効率性
- エージェントはメインのコンテキストをきれいに保つのに役立ち, より長いセッションを可能する
遅延
- サブエージェントは呼び出されるたびにまっさらな状態から始まるため, 必要な文脈を収集する際に遅延が生じることがある

所管

特定の文脈を与えた sub agent を作成しておくと便利かもしれません