公開日:
更新日:
状態: 公開中 / Snapshot
AI Agent並列開発：応用編 Skillと非対話実行
Skill と非対話実行（headless）は、初回導入の必須経路ではない。 Level 1〜2 が回り、同じ worktree を複数 Agent が同時に書き換えない原則を守れるようになってから使う。
応用編として扱う
Skill や headless 実行は、次のような場面で役に立つ。
- 調査 Agent に読み取り専用で source を調べさせる。
- レビュー Agent に差分と検証結果を確認させる。
- 既に分離された worktree で、狭い修正だけを別 Agent に任せる。
- setup、test、E2E、PR、cleanup のどこまで任せるかが作業ごとに決まっている。
ただし、実装 Agent と同じ worktree を別 Agent が同時に書き換える運用は避ける。 読み取り専用の調査・レビュー Agent では、実行リソースの完全分離が不要なケースもある。
利用環境ごとの入口を確認する
| 環境 | 向いている使い方 | 確認すること |
|---|---|---|
| Codex App / CLI | Codex session、worktree、PR workflow と合わせる | 作業ディレクトリ、branch、許可された tools、PR 作成権限 |
| Claude Code | skill、subagent、headless 実行を使った調査・レビュー | CLAUDE.md / AGENTS.md、許可 tools、出力 artifact |
| Copilot / editor agent | editor 文脈の補助や review | 対応 Agent、auth、subscription、書き込み範囲 |
| shell headless | CI 的な単発調査や read-only review | sandbox、timeout、stdout / result file、失敗時の扱い |
Skill に残すもの、script に出すもの
| 残す場所 | 書くこと |
|---|---|
| Skill | 目的、判断基準、読み取り順、停止条件、成果物の形 |
| Script | setup、up、test、E2E、cleanup など再現可能なコマンド |
| 実行リソースの対応メモ | URL、検証結果、artifact、cleanup 対象 |
| PR / Issue | reviewer が判断するための背景、期待状態、検証結果 |
Skill に shell script の長い実装を埋め込まない。 反対に、script だけに判断基準を閉じ込めない。 Agent が迷った時に止まれる条件を Skill に残す。
読み取り専用の調査・レビュー Agent
読み取り専用の調査・レビュー Agent は、実装 Agent と同じ分離を毎回は必要としない。 ただし、次を守る。
- file edit、commit、push、GitHub write を許可しない。
- 調査対象の branch / commit を明示する。
- 出力は review finding、調査メモ、判断材料に限定する。
- 実装 Agent の worktree を書き換えない。
- 調査結果を現在の差分へ適用できるか、人間または主 Agent が確認する。
書き込みを任せる headless 実行
別 Agent に書き込み、test、E2E、PR、cleanup まで任せるなら、専用 branch / worktree、対象 URL、検証結果、cleanup 対象、停止条件を作業ごとに確認できる必要がある。 同じ branch へ後から統合する場合も、古い base で得た test / E2E 結果をそのまま信用しない。 統合後に必要な検証を再実行する。