第8課:SkillへのTask/サブエージェントパターンの実装:並行処理の境界とコンテキストの分離
この授業の目標:あなたは……できるようになります タスク / サブエージェント(subagent) 「サブタスクをいくつ作成するか」といったことをチャットで口頭で伝えるのではなく、どのステップを並行処理できるか、コンテキストをどのように分離するか、結果をどのように統合するかといったルールをSkillの規約に明記する。前回のレッスンでは、Skillの分割・統合や競合の仲裁についてすでに学習しました:https://school.myshirtai.com/?p=4191。本講義では、仲裁に先立ち、以下の事項を取り扱う。単一スキル内部並行処理とコンテキストの分離を実現し、現在のClaude Code Task/サブエージェントのオーケストレーションのホットスポットに組み込んだ。「並行処理に注意」という感想文をまた書くのではなく、今夜提出できる境界表、分離リスト、および失敗例を用意した。
はじめに
まず、第7課「マルチスキル・シーケンス:境界の分解・結合とトリガーの競合の仲裁」を完了してください:https://school.myshirtai.com/?p=4191。手元に少なくとも、ロード可能なターゲットスキル、第6~7課の評価用フック、裁定表を用意しておいてください。それ以前の基礎知識が不足している場合は、第1課を復習してください。 https://school.myshirtai.com/archives/3378;第2課 https://school.myshirtai.com/archives/3462;第3課 https://school.myshirtai.com/archives/3521;第4課 https://school.myshirtai.com/archives/3661;第5課 https://school.myshirtai.com/?p=3948;第6課 https://school.myshirtai.com/?p=4048.
材料リスト:書き込み権限があるか、PRを提出できるか;Skillで reference/ README に「並列処理の境界」というセクションを追加するか、評価テストに「サブタスク間の干渉」のサンプルを追加してください。実際の並列処理の失敗ログがない場合は、「2つのサブタスクが同じファイルに書き込む」というサンプルを合成して使用し、都合の良い話をでっち上げないでください。

タイムボックス:今夜は90分だけ一つ SkillとTask/サブエージェント間の取り決めに基づき、倉庫全体を一夜にして並列化しないこと。
概念:Task/サブエージェントをSkillに書き込む前に、まず並列境界を固定する

第7課では、複数のスキルが同時に発動した場合の優先順位を保証しています。第8課では、以下の点を補足しています:同じスキルが指定された後でも、内部では依然として無差別に多数の子プロキシが起動され、コンテキストやファイル、ツールの割り当てを奪い合う可能性がある。まず、次の4つの質問に答えてください:どのステップを並行処理できますか?サブエージェントはデフォルトでどのパスを読み取り専用として扱いますか?結果は誰がマージしますか?失敗した場合、兄弟タスクはキャンセルされますか?
- 並行処理はコストに関する意思決定である:ウォールクロックの時間 vs クォータ消費/ロック争奪;デフォルトでは低い並列度から開始。
- コンテキストの分離についてSkillに記述する:各タスクには必要な要約のみを含め、会話の全文をそのままN回コピーすることは禁止されています。
- 副作用の一覧:ディスクへの書き込み、ネットワークへの送信、共有状態の変更は、デフォルトでシリアル処理またはロックがかけられます。読み取り専用の検索のみ並列処理されます。
- 検収から評価へ:「並列処理後の結果は一貫しているべき/隔離されているべき」という例を少なくとも3つ挙げてください。
Claude Code のような製品は、Task/subagent をオーケストレーションのプリミティブとして扱います。一方、Skill は、「いつ使用するか、どのように制限するか」を、トリガー可能かつ回帰テスト可能なルールとして定義する役割を担います。概念の説明はここまでとし、以下では実際に実装していきます。
今夜できること:対象となるSkillのSKILL.mdを開き、並列処理したい手順と、順次処理が必要な副作用のある手順を区別して、2列の草案として書き出してください。
ステップバイステップの実践:宣言、コンテキストの分離、並列処理の上限、受け入れフック

- 並列境界テーブルの宣言:ある
reference/parallel.md(ファイル名は任意)手順、並行処理の可否、最大同時実行数、共有リソースを記載すること。PRでは必ずこの表を確認すること。 - コンテキスト分離リスト:各サブタスクで許可される入力フィールド(ターゲットパス、読み取り専用サマリー、禁止フィールド)。サブタスクに秘密鍵やチャット履歴全体を挿入することは禁止されています。
- 合併契約:集計元を親タスクとするか、競合するフィールドについてはどちらを優先するか、失敗時に「fail-fast」とするか。
- フックとレビュー:実行時には「起動されるサブタスクの数」を出力する。評価では、上限を超えないこと、およびディスクへの書き込み処理が並列化されていないことを確認する。
| 手順の種類 | デフォルト | レビューへの期待 |
|---|---|---|
| 読み取り専用検索 / 集計 | 並列処理を許可、上限は3 | サブタスク数 ≤ 上限 |
| 同じファイルへの書き込み / 設定の変更 | シリアル | 同じパスへの同時書き込みは禁止されています |
| インターネットの副作用 | シリアルまたは明示的なキュー | 宛名指定なしの場合は、一斉送信してはならない |
| 文脈の保持 | 最小要約 | サブタスクの入力にキーフィールドが含まれていない |
# evals/subagent_isolation.jsonl の例
{"id":"S-01","utterance":"src/ ディレクトリ内の3つのモジュールのREADMEを並列で要約する","expect_parallel":true,"max_workers":3,"expect_write":false}
{"id":"S-02","utterance":"同じ config.yaml の 2 つのキーを同時に変更する","expect_parallel":false,"notes":"書き込み競合が発生した場合は、順次処理するか拒否する"}
{"id":"S-03","utterance":"サブタスクを開始するが、.env は含めない","expect_leak":false,"forbidden_keys":["API_KEY","TOKEN"]}

今夜できること:S-02 タイプのサンプルで少なくとも 1 回は「赤」となるように実行し、その後、境界テーブルを用いて「緑」になるように修正する――アクセス制御が並列規約を正しく処理できることを確認する。
エラーと失敗(少なくとも3件)

- Skillには「サブプロキシを開設可能」とだけ記載し、上限は記載しない:クォータとロックが上限に達した。対処法:max_workers の強制設定と評価。
- サブタスクによるコンテキストの完全コピー:クロストークと情報漏洩。対処法:隔離リスト + forbidden_keys の例。
- ディスクへの書き込み手順を並行して実行:ファイルの破損または潜在的な競合。対処法:副作用はデフォルトでシリアル化され、フックは強制的にブロックされる。
- 第7課の仲裁表との整合性が取れていない:親スキルがターゲットを指定した後、内部で別のスキルがトリガーされる。対処法:子タスクは仲裁をバイパスしてはならない。競合の例については相互参照のこと。
- マージ時に失敗が黙って見過ごされる:サブタスクが赤色になっても「成功」と報告される。対処法:fail-fast または明示的な partial ステータス。
今夜できること:「同じ設定ファイルを同時に変更する」という文を意図的に挿入し、GanRunが並行書き込みを行うかどうかを確認する。もし行う場合は、まずハードロックをかける。
練習
- スキルを選択し、送信してください
reference/parallel.md境界表。 - 少なくとも 3 つのサブエージェントを追加し、隔離/並列処理のサンプルを同時に実行して成功させる。
- SKILL.md の description に、Task/サブエージェントをいつ使用し、いつ使用しないかを説明する文を1つ追加する。
- 第7課の仲裁表とのクロスリンクが1か所あります(同じ失敗IDまたはドキュメントアンカー)。
達成基準:同僚が「parallel.md」と評価結果だけを見て、最大並行数やディスクへの書き込みが並行可能かどうかを説明でき、あなたに個別に問い合わせる必要がないこと。
次回の予告
次回のレッスン予告:タスク/サブエージェントの並列境界と生産トレースを連携させる――「サブタスク間の干渉」ログから隔離サンプルをワンクリックで生成する方法、高並行スキルの観察期間と予算枠を設定する方法。本レッスンでは、まずオフラインの境界テーブルと評価を安定させておきます。並列処理に問題があれば警告が表示されますが、本番環境では単に静かに干渉し合うだけになります。
本シリーズの目次
- 第1課:30分で、自動的にトリガーされる最初のClaude Agent Skillを作成する — https://school.myshirtai.com/archives/3378
- 第2課:Skillに参照を追加する/「まず計画文書を作成してから実行する」という検証ループ — https://school.myshirtai.com/archives/3462
- 第3課:スクリプト付きスキルとセキュリティ監査 — https://school.myshirtai.com/archives/3521
- 第4課:実際の失敗事例を用いた反復的な説明 — https://school.myshirtai.com/archives/3661
- 第5課:Skillを実際のリポジトリのCI/チーム共有ディレクトリに接続する — https://school.myshirtai.com/?p=3948
- 第6課:評価データセットを用いたSkillの回帰分析 — https://school.myshirtai.com/?p=4048
- 第7課:マルチスキル・シーケンス:結合・分離の境界とトリガー競合の仲裁 — https://school.myshirtai.com/?p=4191
- 第8課:SkillにTask/サブエージェントパターンを組み込む:並行処理の境界とコンテキストの分離(本記事)


评论列表 (0条):
加载更多评论 読み込み中...