「検証の手順はスキルにしたのですが、ログを調べるところだけ軽いモデルの担当に回せませんか」
「担当は名前を言えば動くのですか。@ を付けるのと何が違いますか」
第6回までで、担当(サブエージェント)が何か、定義の書き方、tools の絞り方、モデルと effort の決まり方を見てきました。ここからは、担当をスキルと組み合わせて使います。スキルは「手順」を、担当は「作業」を受け持つ、と分けると、役割ごとにモデルも道具も変えられます。第7回の合言葉は、手順はスキル、作業は担当です。
第7回では、スキルと担当の組み合わせ方2つ、担当の呼び方、スキルに「誰に頼むか」を書くときの5つの決まり、そして筆者の資料づくりの分担の例を扱います。スキルそのものの書き方は、連載「Claude Codeスキル入門」で扱っています。数値・仕様は2026年10月時点です。
スキルと担当の組み合わせ方2つ
スキルと担当は、2つの向きで組み合わせられます。違いは、何が担当への指示になるかです。
| 組み合わせ | 担当への指示 | 読み込まれるもの・決まるもの |
|---|---|---|
担当の skills: | システムプロンプト=担当の本文。依頼=Claude が書く文 | 起動時に、書いたスキルの全文が入る(先頭32個まで) |
スキルの context: fork+agent: | システムプロンプト=agent: の担当のもの。依頼=SKILL.md の内容 | モデル・道具・権限は agent: で決まる。省略は general-purpose |
| 例① | レビュー担当に skills: [ansible-verify] と書く | 検証の手順を最初から持ったレビュー担当 |
| 例② | 調査スキルに context: fork+agent: infra-researcher と書く | 調査を Haiku の担当に動かす |

- 担当の
skills::担当を作る側から、使うスキルを書く。担当の起動時に、書いたスキルの全文が担当のコンテキストに入る - スキルの
context: fork+agent::スキルを作る側から、実行する担当を書く。SKILL.md が担当への依頼になり、agent:を省くと general-purpose の担当で動く
補足です。
- どちらも、会話の履歴は渡りません。
context: forkは、手順(やること)がはっきり書かれたスキルだけに使います。「この API の規約に従う」のような方針だけのスキルを fork すると、担当は方針を受け取っても、やるべき依頼が無いので、意味のある結果を返しません context: forkは、名前に反して、今の会話をそっくり引き継ぐ「分身(fork)」ではありません。履歴が要る作業には、会話の分身のほうを使います(公式の skills のページの注記)- 組み込みの Explore と Plan は、CLAUDE.md を読み込まずに始まります。
agent: Exploreのスキルには、作業に要ることを全部 SKILL.md に書いてください(公式の skills のページ。連載「Claude Code実践入門」第7回の「新しい目でレビューする」にも、同じ注意があります)
筆者は、skills: の読み込みを CLI(Claude Code 2.1.289、2026-10-17)で確かめました。担当はスキルの中の合言葉を書きましたが、担当が自分で SKILL.md を読んでいたため、起動時の読み込みで書けたのかは判別できませんでした。
出典:https://code.claude.com/docs/ja/skills
担当の呼び方3つ
担当を動かす呼び方は、次の3つです。表の最後の行は、2つ目の @ を手で打つ形です。
| 呼び方 | 動き | メモ |
|---|---|---|
| 自然な文で名前を言う | Claude が任せるかを決める | 「調査担当に roles の一覧を調べさせて」は infra-researcher に任された(筆者の CLI 2.1.289) |
@ で選ぶ | その担当が必ず動く。依頼文は Claude が書く | @ の候補の表示は、筆者は Code タブでは確かめていない |
| セッション全体をその担当に | --agent や .claude/settings.json の agent | 本体が担当に置き換わる |
| 手で打つ | @agent-名前 | Code タブで呼べるかは、筆者は確かめていない |
- 自然な文:任せるかどうかは Claude が決めるので、名前を言わなければ別の担当が選ばれることがあります。筆者が名前を言わずに「roles/ntp の tasks はどこで定義されている?」と頼むと、2.1.289 では組み込みの Explore が、2.1.302 では自作の infra-researcher が選ばれました(どちらの版でも、description には同じ言い回しが入っていました)。確実に使いたいときは、名前を言うか
@で選びます @で選ぶ:その担当が必ず動きます。担当への依頼文は Claude が書きます- セッション全体をその担当に:
claude --agent 名前か、.claude/settings.jsonのagentで、本体のセッションそのものが担当の道具制限とモデルに置き換わります - 手で打つ:
@agent-名前の形で、候補の一覧から選ばなくても入力できます
補足です。
- プラグインの
settings.jsonのagentキーも、本体をプラグインの担当に置き換えます。入れる前に、中身を読んでください - CLI の
-pに書いた@名前は、候補から選ぶ操作ではなく、ただの文字列です。筆者の 2.1.289 では、本体がスキルと取り違えました。2.1.302 では、本体が名前の文字列から infra-researcher を選びました - Code タブの
@の候補について、公式の desktop のページには、@でファイルを会話に加える記述はありますが、担当を呼ぶ記述は、筆者は見つけられていません(2026年10月18日)
出典:https://code.claude.com/docs/ja/sub-agents
名前を言う・@ で選ぶ、どちらでも、担当が前で動くか裏で動くかは Claude Code の設定と版で変わります。第8回の「前で動くか、裏で動くか」で扱います。
スキルに「誰に頼むか」を書く
スキルの手順に担当を組み込むときの書き方は、次の5つです。
- 手順に担当を書く:SKILL.md に「調査は
infra-researcher、作成はplaybook-writer、レビューはplaybook-reviewerに頼む」と書く - 担当が無いときの代わり:見つからなければ general-purpose に model を渡して代わりにする、と書いておく
- 受け渡しはファイル:結果はファイル(事実の控え・報告)に書かせ、次の担当はそのファイルを読む。担当の返事は短く、詳しい中身はファイルへ
- 判断は本体に残す:どの担当に何を頼むか、どの結果を採るかは本体が決める。担当に判断を任せきりにしない
- 本実行と prod は人:担当の定義にも SKILL.md にも、本実行は書かない(連載「Claude Codeスキル入門」と同じ)
スキルの書き方は、連載「Claude Codeスキル入門」第6・7回の ansible-verify と同じです。SKILL.md の「役割」は、たとえば次のように書けます(説明のための例です)。
## 役割
- 調査:infra-researcher に頼む。結果は reports/research.md に書かせる
- 作成:playbook-writer に頼む。reports/research.md を読ませる
- レビュー:playbook-reviewer に頼む
- 担当が見つからないときは、general-purpose に model を渡して代わりにする
- どの結果を採るかと、本実行(stg・prod)は、本体と人が決める。担当には頼まない
筆者が試したら
Claude Code 2.1.302 の CLI(非対話の claude -p、2026-10-18)で、ansible-verify の SKILL.md の最後に「結果を playbook-reviewer 担当に渡して、差分をレビューさせる」という手順を足し、「検証して」と頼みました。スキルの検査(lint・構文確認・stg への --check --diff)が済んだあとに、playbook-reviewer(claude-sonnet-5-5 で動きました)が呼ばれて、レビューを返しました。
このとき本体は、足した手順が、直前の手順「報告して止まる」と矛盾していると指摘しました。スキルの中で別の担当に渡すなら、「止まる」の指示と食い違わない場所(止まる前)に書く必要があります。この演習は、第13回の手順6で手順どおりに扱います。
例:筆者の資料づくりの分担(筆者の例)
筆者の資料づくりは、スキルが役割ごとに担当を呼び分けています。これは筆者の例で、公式の推奨ではありません。

- 本体(指揮)は Opus 5.5:ユーザーとのやり取りと、担当の割り振りを受け持つ
- アドバイザーも Opus 5.5:目次案と、指摘の仕分けの2回だけ使う
- 調査は Haiku 5.5、原稿・図・点検は Sonnet 5.5
- 担当はほかの担当を呼ばない:受け渡しはファイル(事実の控え・原稿・図・報告)で、中継は指揮が行う
公式では、担当は既定で3段まで担当を呼べます。ただし、担当の定義の tools を書いて、その中に Agent を入れなければ、呼びません(tools を省くと、使える道具をすべて引き継ぎます)。この例では、担当どうしを直接つながない設計にしています。
ここで見せるのは構成とモデルの対応だけです。定義の model: は、別名(haiku・sonnet・opus)でも完全なモデル ID(たとえば claude-opus-5-5)でも書けて、公式の文書に、どちらかを勧める文は見つかっていません。別名は新しい版に追従し、完全な ID は版を固定します。筆者がこのブログの連載づくりに使っている担当の定義は、完全な ID で版を固定しています。この連載のひな形(3役)は別名で書きます(別名と完全な ID の使い分けと、別名の解決先が版で変わる件は、第5回の「別名で書く理由」で扱いました)。
この分担は、本体は公式の既定(Opus 5.5)、担当は調べものを軽いモデルに回して費用を抑える、という公式の考え方の上に、筆者が役割ごとに割り当てたものです。モデルの決め方は、第6回の「公式の推奨と筆者の例」の、公式の推奨と筆者の例を分ける考え方で読んでください。
要点
- 本体は Opus 5.5、調査は Haiku 5.5
- 原稿・図・点検は Sonnet 5.5
- 受け渡しはファイル。判断は本体
考えてみよう
- 今のスキルのうち、手順だけ書かれていて、一部を別の担当に回せそうなものはありますか。
skills:とcontext: fork+agent:の、どちらの組み合わせが合いますか。 context: forkを使うスキルに、「やること」ではなく方針だけが書かれていないか、見直してみてください。担当は何を受け取りますか。- 自分の SKILL.md に「誰に頼むか」を書くとしたら、調査・作成・レビューをどの担当に、結果をどのファイルに書かせますか。判断を本体に残しているのは、どの行ですか。
ヒント:1と2は「スキルと担当の組み合わせ方2つ」の節、3は「スキルに『誰に頼むか』を書く」の節を見直してください。
まとめ
- 組み合わせ方は2つ。担当の
skills:は担当の起動時にスキルの全文が入り(先頭32個まで)、スキルのcontext: fork+agent:は SKILL.md が依頼になり、モデル・道具・権限はagent:で決まる(省略は general-purpose) - どちらも会話の履歴は渡らない。
context: forkは、やることが書かれたスキルだけに使う。会話の分身(fork)とは別 - 呼び方は、自然な文・
@・セッション全体(--agent)・手で打つ(@agent-名前)。確実に使いたいときは名前を言うか@ - スキルに書くのは、担当の名前、代わりの担当、受け渡しはファイル、判断は本体、本実行と prod は人
- 筆者の資料づくりの分担は、本体 Opus 5.5、調査 Haiku 5.5、原稿・図・点検 Sonnet 5.5。筆者の例で、公式の推奨ではない
次回は、担当を順に使う条件(逐次パイプラインとの両立)、前で動くか裏で動くか、担当の変更は巻き戻しで戻らないこと、調べものと Ansible の例を扱います。
連載「Claude Codeサブエージェント入門」全13回
全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。
- サブエージェントとは
- 組み込みの担当と使い分け
- 担当を定義する
- toolsと返す形
- 担当のモデルの決まり方
- 役割とモデル・effort
- スキルから担当を呼ぶ(この記事)
- 順に使う・前と裏
- ログの要約とレビューの担当
- 費用を測って小さく使う
- 演習(前編):準備
- 演習(中編):読み込む・呼ぶ・モデルを見る
- 演習(後編):レビュー・スキル・費用

コメント