【Claude Codeサブエージェント入門 第13回】演習(後編)― 作成とレビューの担当、スキルから担当へ渡す、使った量、4Dで振り返る、連載の結び

Claude Codeサブエージェント入門 第13回 演習(後編)― 作成とレビューの担当、スキルから担当へ渡す、使った量、4Dで振り返る、連載の結び 生成AI

「担当に直させたファイルは、巻き戻しで元に戻るのでしょうか。レビュー担当が、勝手に直してしまわないかも不安です」
「担当を3つ使ったら、使用量がどれだけ減ったのか、演習が終わってから振り返りたいです」

第11回(演習 前編:準備)で、練習用のリポジトリ(~/practice)に3つの担当(調べる・作る・確かめる)を置き、第12回の手順1〜4で、一覧、呼び出し、モデルの確認、Explore の上書きを試しました。第13回は、同じ ~/practice を使って続けます。手順5〜7で、作成担当に直させて、レビュー担当に見せる、スキルの最後でレビュー担当に渡す、使った量を測るを試します。最後に、AI Fluency の4D で演習を振り返り、自己点検、持ち帰りの3点、連載の結び、次に学ぶ教材を載せて、この連載を終わります。

記録(筆者の環境の読み方)、Code タブ・CLI・-p の対応、準備の手順は、第11回の「筆者の記録の読み方」「準備」を見てください。-p では確認の画面が出る操作が「承認が要る」として実行されずに終わる点も、第11回に書いています。


手順5〜7

手順の表は次のとおりです。各手順の後に、筆者の記録を載せます。

手順やること確かめること
5「@playbook-writer roles/ntp/tasks/main.yml の最初のタスク名の末尾に(確認)を足して」と送る。本体で差分を読み、「@playbook-reviewer git diff を見てレビューして」と送るレビュー担当が Edit しないか。「遭遇した障害」の欄が埋まるか。担当の確認の画面に名前が出るか。担当の編集が巻き戻しで戻らないか(連載「Claude Code実践入門」第3回の「巻き戻しで戻らないもの」と、この連載の第8回の「担当の変更は巻き戻しで戻らない」。終わったら git checkout -- .)
6ansible-verify の最後に「結果を playbook-reviewer に渡す」と1行足す。または playbook-reviewer の frontmatter に skills: [ansible-verify] を足すansible-verify の後にレビューが返るか。skills: の名前違いは読み飛ばされる(debug ログに警告)
7/usage を打つ。演習の前後で、使用量の枠がどれだけ減ったかを控える担当の割合が出るか。1回の演習で使った量

手順5:作成担当に直させ、レビュー担当に見せる

手順5の流れを4段で示した図。見出しは「手順5:作成担当に書かせ、本体で差分を読み、レビュー担当に見せる」。①作成担当 playbook-writer に頼む(roles/ntp/tasks/main.yml の最初のタスク名の末尾に(確認)を足して)。筆者の結果(担当は claude-sonnet-5-5)は、「手動」では担当の Edit が承認待ちになり、本体は「拒否は権限設定によるものなので、私が直接書き換えて回避することはしていません」と報告した。「編集を受け入れる」では担当が編集した。②本体で差分を読む:本体が git diff で確かめ、変わったのはこの1行だけ(-- name: chronyの参照先を設定する が +- name: chronyの参照先を設定する(確認) に変わる)。③レビュー担当 playbook-reviewer に頼む(git diff を見てレビューして)。筆者の結果(担当は claude-sonnet-5-5)は、Edit はしなかった、git diff・ファイルの Read・ansible-lint・--syntax-check を実行した、判定は「直す(軽微)」で(確認)が何を確認するのか分からない・一時的な印なら戻す、というもの。緑の箱「担当が確認したこと lint 0・構文成功」とオレンジの箱「まだ確認していないこと stg の --check --diff・冪等性」に分けて返した。④後片づけは、git checkout -- roles/ntp/tasks/main.yml で戻した。
  1. 「@playbook-writer roles/ntp/tasks/main.yml の最初のタスク名の末尾に(確認)を足して」と送る。作成担当(playbook-writer)が編集する
  2. 本体で差分を読む(git diff。連載「Claude Code実践入門」第7回の「要約ではなく差分から読む」)
  3. 「@playbook-reviewer git diff を見てレビューして」と送る。レビュー担当(playbook-reviewer)は、経緯を知らない目で差分を見る(同第7回の「新しい目でレビューする」)
  4. 確かめること:レビュー担当が Edit しないか、返す形の「遭遇した障害」の欄が埋まるか、担当の確認の画面に担当の名前が出るか、担当の編集が巻き戻しで戻らないか
  5. 終わったら git checkout -- . で戻す

公式の sub-agents は、担当の権限の確認は本体の画面に出て、確認を求めている担当の名前が付く、と書いています。また、公式の checkpointing は、担当の編集は、たいていセッションのチェックポイントに記録されず、巻き戻しで戻るのは会話の中で Claude がすでに編集していたファイルだけで、担当のほかのファイルの編集は残るので Git で戻す、と書いています(前景で動く context: fork のスキルは、巻き戻しで戻る)。

筆者の環境ではこうなった(2.1.302、-p)
「playbook-writer 担当に、roles/ntp/tasks/main.yml の最初のタスク名の末尾に(確認)を足させて」を、「手動」で送ると、担当(claude-sonnet-5-5)の Edit が承認待ちになった。本体は「拒否は権限設定によるものなので、私が直接書き換えて回避することはしていません」と報告した。
同じ依頼を「編集を受け入れる」で送ると、担当が編集した。本体が git diff で自分でも確かめ、「変わったのはこの1行だけ」と報告した。lint などはまだで、コミットもしていない、とも報告した。

-- name: chronyの参照先を設定する
+- name: chronyの参照先を設定する(確認)

「playbook-reviewer 担当に、git diff を見てレビューさせて」を、「手動」で送った。担当(claude-sonnet-5-5)は Edit をせず、git diff 2>&1 | cat、main.yml・defaults・site.yml・.ansible-lint の Read、ansible-lint 2>&1 | cat; echo ---; ansible-playbook --syntax-check … を実行して、結果を返した。
判定は「直す(軽微)」。「(確認)が何を確認するのか分からない。一時的な印なら戻す」。もとからある点として、regexp なら「最後の1行だけ置き換える」の注意には当たらないこと、ほかの server・pool 行が残ることがあること、handler が無いので chronyd に反映されないこと、を挙げた。
返す形のとおり、「担当が確認したこと(lint 0・構文成功)」と「まだ確認していないこと(stg の --check --diff、冪等性は実機で確かめていない)」を分けて返した。
終わってから、git checkout -- roles/ntp/tasks/main.yml で戻した。
担当の確認の画面に名前が出るか、担当の編集が巻き戻しで戻らないかは、-p では試せないので、筆者は確かめていない(確認の画面も、巻き戻しも、-p には無い)。上の公式の記述と、連載「Claude Code実践入門」第3回の「巻き戻しで戻らないもの」を参照。

手順6:スキルの最後で、レビュー担当に渡す

2つの方法があります。

  • 方法1:ansible-verify の SKILL.md の最後に、「結果を playbook-reviewer に渡す」という1行を足す
  • 方法2:playbook-reviewer の frontmatter に skills: [ansible-verify] を足す(担当が動く前に、そのスキルの内容が担当に読み込まれる)

確かめることは、検証の後にレビューが返るかです。skills: に書いた名前が違うと、そのスキルは読み飛ばされます。公式の sub-agents は、「If a listed skill is missing or disabled, for example by your organization’s policy, Claude Code skips it and logs a warning to the debug log.」(書いたスキルが無い、または無効なら、Claude Code はそれを読み飛ばし、debug ログに警告を書く)と説明しています。エラーの画面は出ないので、名前は正確に書きます。

筆者の環境ではこうなった(2.1.302、-p)
方法1だけを試した(方法2は筆者は試していない)。ansible-verify の SKILL.md の最後に、「5. 最後に、結果を playbook-reviewer 担当に渡して、差分をレビューさせる。」を、筆者が手で足した。
「検証して」と頼むと、スキルが発動し、git diff roles/ntp/tasks/main.yml; bash .claude/skills/ansible-verify/scripts/verify.sh inventory/stg/hosts.ini site.yml が承認なしで実行された(スキルの allowed-tools と、Skill(ansible-verify) の allow による)。RESULT lint=0 syntax=0 check=4 が出たあと、playbook-reviewer(claude-sonnet-5-5)が呼ばれ、レビューを返した。
本体は、「SKILL.md の手順5(レビュー担当に渡す)が、直前の手順4の『報告して止まる』と矛盾している。今回は手順5まで実行した」と指摘した。足すなら、手順4の「止まる」の前に入れる。
試した後に、SKILL.md を元に戻した。

手順7:使った量を測る

演習の前後で /usage を打ち、使用量の枠がどれだけ減ったかを控えます。担当の割合(Attribution)が出るか、1回の演習で使った量はどれくらいかを見ます(第10回の「/usage の内訳の見方」)。

筆者の環境ではこうなった(2.1.302、-p)
-p には /usage が無い。各回の total_cost_usd(API の定価で換算した値)は、0.15〜0.3ドル程度だった。担当を使った回も、本体の分と合わせた値で出る。Pro・Max では、この金額が請求されるのではなく、使用量の枠から引かれる(第10回の「担当も同じ使用量の枠を使う」)。/usage の Attribution の画面は、筆者は確かめていない。

補足:担当が前で動くか、裏で動くか

  • 筆者の CLI(2.1.289、2026-10-17、-p)では、ふつうに頼んだ担当は裏で動き、本体は「起動しました」と返し、終わると結果を受け取った。context: fork のスキルの担当は、前で動いた
  • 筆者の CLI(2.1.302、2026-10-18、-p)では、第12回の手順2と、この回の手順5・6の担当は前で動いた
  • 公式は、context: fork のスキルの担当の既定は裏としています(v2.1.218 以降。第8回の「前で動くか、裏で動くか」)。公式の skills は、非対話の -p(と Agent SDK)では、context: fork のスキルが結果を待つ、とも書いています
  • 2.1.302 の CHANGELOG には、デスクトップアプリと VS Code でも、本体の担当を常に裏で動かす(Claude に選ばせない)という項目があります(出典:https://github.com/anthropics/claude-code/releases/tag/v2.1.302 )。Code タブでの見え方は、筆者は確かめていません。公式のサブエージェントのページも、2026年11月11日に見直すと同じ内容(fork mode は v2.1.302 から既定で有効、-p と Agent SDK では Claude が自分の判断で担当を待てる)に書き換わっていました(第8回の「公式の文書の今の記述(2026年11月11日時点)」)

最後の状態

筆者の練習用のリポジトリの最後の状態(2.1.302)です。

  • 最新のコミットは 9f820aa(3役のひな形を追加したもの)
  • 手順5で変えた roles/ntp/tasks/main.yml は、git checkout で戻した
  • 手順6で足した ansible-verify の SKILL.md の1行は、元に戻した
  • 手順4の .claude/agents/Explore.md は、消した

4Dで振り返る

演習を、Anthropic の AI Fluency の4D で振り返ります。4D は、連載「Claude活用入門」第6回の「AI Fluencyの4D」で紹介した、AI と協働するための枠組みです(講座:https://academy.claude.com/ja/courses/ai-fluency-framework-foundations )。

AI Fluencyの4D演習を振り返る問い
委任(Delegation)どの段を担当に任せ、どこを本体と人に残したか。中間作業は要らなかったか(第2回の「使う・使わないの判断ルール」)
記述(Description)description と返す形は具体的か。依頼文は、名前か @ で担当を指定できたか
評価(Discernment)要約だけで判断していないか。失敗の原文を見たか。どのモデルで動いたか確かめたか
責任(Diligence)作成担当の変更を Git で戻せるか。tools は狭いか。本実行と prod は人か
演習を4Dで振り返る問いを、2×2の4つの枠で示した図。見出しは「演習を4Dで振り返る問い」。青「委任(Delegation)」は、どの段を担当に任せ、どこを本体と人に残したか。中間作業は要らなかったか。緑「記述(Description)」は、description と返す形は具体的か。依頼文は、名前か @ で担当を指定できたか。オレンジ「評価(Discernment)」は、要約だけで判断していないか。失敗の原文を見たか。どのモデルで動いたか確かめたか。赤「責任(Diligence)」は、作成担当の変更を Git で戻せるか。tools は狭いか。本実行と prod は人か。最下行に「AI Fluency の4D:委任・記述・評価・責任」とある。

4D の日本語の語は、連載「Claude Code実践入門」第9回(演習 後編:巻き戻し・差分・権限と振り返り)の表に合わせて、委任・記述・評価・責任としました。連載「Claude活用入門」第6回の「AI Fluencyの4D」は、同じ4つを「任せるかを判断する」「伝える」「見極める」などの言い方で説明しています。日本語の訳語や言い方は、どちらも筆者のもので、公式の日本語訳は確認できていません。


自己点検

一人で振り返る点検です。演習の結果を、自分の担当の定義と CLAUDE.md に反映できたかを確かめます。

  • 担当に任せてよかった作業は何でしたか。中間作業が要らず、結果の要約だけで足りる作業でしたか
  • 任せて困った作業は何でしたか。返す形が足りなかった、担当の編集が戻らなかった、本体が確かめずに担当の報告を信じた、などは、担当の定義の返す形や tools、CLAUDE.md に書けますか
  • 1回の演習で使った量は、どれくらいでしたか。次に担当を使う作業を、枠の使い方と合わせて決められますか(第10回の「小さく使う工夫」)
  • 第12回の手順2で、名前を言わない依頼が意図した担当に渡りましたか。渡らなかったなら、description を直せますか
  • 第12回の手順3・4で、担当や Explore がどのモデルで動いたかを確かめましたか。別名の解決先が版で変わることを、自分の定義の model の書き方に反映できますか
  • 4D(委任・記述・評価・責任)のうち、一番弱かったのはどれでしたか

持ち帰りの3点

  1. 中間作業が要らないときだけ、担当に任せる:判断は本体と人に残す
  2. 担当は、description・tools・model(別名)・返す形の4点で書く:モデルは「呼び出し時の指定 → 定義の model → 環境変数 → 本体」の順に決まる
  3. 受け渡しはファイル、報告は短く:費用は /usage で見る

演習は、自分の練習用のリポジトリで、第11〜13回の手順を試すことです。任せてよかった作業、任せて困った作業、使った量は、自分の担当の定義と CLAUDE.md に反映してください。


連載の結び

この連載は、役割ごとに担当を分けて任せるときの考え方を扱いました。任せるのは、中間作業が要らないときだけ(第1・2回)、担当は description・tools・model・返す形で書く(第3〜5回)、モデルと effort は役割で決める(第5・6回)、スキルから担当を呼び、順に使うときは前と裏を意識する(第7・8回)、ログの要約と、新しい目でのレビューを担当に任せる(第9回)、担当も同じ使用量の枠を使う(第10回)。そして、第11〜13回の演習で、それぞれを一度ずつ手で確かめました。

連載「Claude活用入門」と「Claude Code実践入門」では、Claude の使い分け、モデルと Effort、CLAUDE.md、権限、検証を扱いました。連載「Claude Codeスキル入門」でスキルを作り、この連載で担当に分けました。通して残るのは、任せる判断と最後の責任は人に残るということです。担当が増えても、何を任せるかを決め、差分を読み、本番に関わる実行を承認するのは、人の仕事です。


次に学ぶなら

次は、連載「Claude Codeフック入門」(全12回)です。調査、playbook の作成、ansible-verify、人の承認、実行、コミットまでを通しで行い(第1回「Ansibleの作業の通し」)、人の承認に任せきりにせず、フックで止める仕組みを扱います。たとえば PreToolUse で prod への実行を止め(第3回「何を止めるか」)、Stop で lint を確かめます(第5回「Stop フックの動き」)。この連載のレビュー担当(playbook-reviewer)は、その途中のレビューで使います(第6回「レビューと④差分を読む」)。担当の定義にもフック(hooks:)を書けますが、この連載では「ある」とだけ紹介しました。使い方はフック入門の第7回「担当の定義の hooks:」で扱います。

あわせて読みたい公式の教材です。

  • 「AIネイティブSDLCプレイブック」:https://academy.claude.com/ja/courses/ai-native-sdlc-playbook 。14レッスン・約1時間で、クイズと修了バッジはありません。この連載に近いのはレッスン7「並列セッションとサブエージェント」(4分)、次の連載に近いのはレッスン11「承認ゲートとしてのフック」(7分)です(日本語版のページの表示。2026年10月17日の筆者の記録)
  • 「Claude Codeを実践する」(Claude Code in action)のレッスン5「Hooks」(7分):https://academy.claude.com/ja/courses/claude-code-in-action/hooks 。コース全体は9レッスン・約1時間です

まとめ

  • 手順5:作成担当に直させ、本体で差分を読み、レビュー担当に見せる。筆者の環境では、レビュー担当は Edit をせず、「直す(軽微)」の判定と、確認したことと確認していないことを分けた報告を返した。担当の編集が巻き戻しで戻らないことは、公式の記述を参照(筆者は -p で確かめていない)
  • 手順6:ansible-verify の最後で、結果をレビュー担当に渡せた。足すなら「止まる」の前に入れる。skills: の名前違いは、読み飛ばされて debug ログに警告が出る
  • 手順7:筆者の -p では、1回 0.15〜0.3ドル程度(API の定価で換算。Pro・Max では枠から引かれる)
  • 4D で、任せ方・書き方・確かめ方・責任の取り方を振り返り、自己点検で、自分の担当の定義と CLAUDE.md に反映する
  • 持ち帰りは、中間作業が要らないときだけ任せる・4点で書く・ファイルで渡すの3点

全13回の「Claude Codeサブエージェント入門」は、これで終わりです。


連載「Claude Codeサブエージェント入門」全13回

全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。

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

業務でオンプレミスとクラウドのインフラに携わり、勉強会の資料をもとに、インフラの基礎の入門の連載を書いています。仕様は公式の文書で、手順は手元の Windows・Linux・FreeBSD の環境で確かめています。
プロフィール詳細は「プロフィール」をご覧ください。
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をコピーしました