「担当に直させたファイルは、巻き戻しで元に戻るのでしょうか。レビュー担当が、勝手に直してしまわないかも不安です」
「担当を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 -- .) |
| 6 | ansible-verify の最後に「結果を playbook-reviewer に渡す」と1行足す。または playbook-reviewer の frontmatter に skills: [ansible-verify] を足す | ansible-verify の後にレビューが返るか。skills: の名前違いは読み飛ばされる(debug ログに警告) |
| 7 | /usage を打つ。演習の前後で、使用量の枠がどれだけ減ったかを控える | 担当の割合が出るか。1回の演習で使った量 |
手順5:作成担当に直させ、レビュー担当に見せる

- 「@playbook-writer roles/ntp/tasks/main.yml の最初のタスク名の末尾に(確認)を足して」と送る。作成担当(
playbook-writer)が編集する - 本体で差分を読む(
git diff。連載「Claude Code実践入門」第7回の「要約ではなく差分から読む」) - 「@playbook-reviewer git diff を見てレビューして」と送る。レビュー担当(
playbook-reviewer)は、経緯を知らない目で差分を見る(同第7回の「新しい目でレビューする」) - 確かめること:レビュー担当が Edit しないか、返す形の「遭遇した障害」の欄が埋まるか、担当の確認の画面に担当の名前が出るか、担当の編集が巻き戻しで戻らないか
- 終わったら
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 の日本語の語は、連載「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点
- 中間作業が要らないときだけ、担当に任せる:判断は本体と人に残す
- 担当は、description・tools・model(別名)・返す形の4点で書く:モデルは「呼び出し時の指定 → 定義の
model→ 環境変数 → 本体」の順に決まる - 受け渡しはファイル、報告は短く:費用は
/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サブエージェント入門の入口のページにまとめています。
- サブエージェントとは
- 組み込みの担当と使い分け
- 担当を定義する
- toolsと返す形
- 担当のモデルの決まり方
- 役割とモデル・effort
- スキルから担当を呼ぶ
- 順に使う・前と裏
- ログの要約とレビューの担当
- 費用を測って小さく使う
- 演習(前編):準備
- 演習(中編):読み込む・呼ぶ・モデルを見る
- 演習(後編):レビュー・スキル・費用(この記事)


コメント