【Claude Codeサブエージェント入門 第7回】スキルから担当を呼ぶ ― skills: と context: fork+agent:、担当の呼び方、スキルに「誰に頼むか」を書く、筆者の分担の例

Claude Codeサブエージェント入門 第7回 スキルから担当を呼ぶ 生成AI

「検証の手順はスキルにしたのですが、ログを調べるところだけ軽いモデルの担当に回せませんか」
「担当は名前を言えば動くのですか。@ を付けるのと何が違いますか」

第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 の担当に動かす
スキルと担当の組み合わせ方2つを、左右の列で比べた図。左(青)は「担当の skills:」で、システムプロンプトは担当の本文、依頼は Claude が書く文、読み込まれるものは起動時に書いたスキルの全文が入る(先頭32個まで)、例①はレビュー担当に skills: (ansible-verify) と書く→検証の手順を最初から持ったレビュー担当。右(緑)は「スキルの context: fork+agent:」で、システムプロンプトは agent: の担当のもの、依頼は SKILL.md の内容、決まるものはモデル・道具・権限が agent: で決まる(省略は general-purpose)、例②は調査スキルに context: fork+agent: infra-researcher と書く→調査を Haiku の担当に動かす。最下行の帯に「どちらも会話の履歴は渡らない。context: fork は、手順が書かれたスキルだけに使う」とある。
  • 担当の 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(目次案と仕分けの2回だけ)、調査 Haiku 5.5、原稿 Sonnet 5.5、図 Sonnet 5.5、点検 Sonnet 5.5の5つの箱があり、アドバイザーは点線の矢印で、調査・原稿・図・点検はそれぞれ「事実の控え」「原稿」「図」「報告」というファイルの箱を経由する矢印で、右の「指揮(本体)Opus 5.5」へつながる。下の帯に「受け渡しはファイル。判断と中継は本体」
  • 本体(指揮)は 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
  • 受け渡しはファイル。判断は本体

考えてみよう

  1. 今のスキルのうち、手順だけ書かれていて、一部を別の担当に回せそうなものはありますか。skills: と context: fork+agent: の、どちらの組み合わせが合いますか。
  2. context: fork を使うスキルに、「やること」ではなく方針だけが書かれていないか、見直してみてください。担当は何を受け取りますか。
  3. 自分の 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サブエージェント入門の入口のページにまとめています。

  1. サブエージェントとは
  2. 組み込みの担当と使い分け
  3. 担当を定義する
  4. toolsと返す形
  5. 担当のモデルの決まり方
  6. 役割とモデル・effort
  7. スキルから担当を呼ぶ(この記事)
  8. 順に使う・前と裏
  9. ログの要約とレビューの担当
  10. 費用を測って小さく使う
  11. 演習(前編):準備
  12. 演習(中編):読み込む・呼ぶ・モデルを見る
  13. 演習(後編):レビュー・スキル・費用
seichan

プロフィール詳細は「プロフィール」をご覧ください。
AWS Certified Solutions Architect – Professional (https://www.credly.com/badges/fd8feb88-6f1f-42ff-a94b-445bb6661cb8/public_url)
Nutanix Certified Professional - Multicloud Infrastructure 6 (https://www.credly.com/badges/5c081bef-a425-42e4-809c-85138e676630/public_url)
Palo Alto Networks System Engineer (PSE) - Hardware Firewall Professional (https://www.credly.com/badges/69dc3880-4a51-47eb-8843-47ba6ea7d013/public_url)

seichanをフォローする
生成AI
シェアする
seichanをフォローする

コメント

タイトルとURLをコピーしました