Codex CLIのSubagentsによる並列API実装 / Parallel API Implementation with Codex CLI Subagents

by 冨澤宝斗

Embed

Start on current slide

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

3 ⾃⼰紹介冨澤宝⽃（Tomizawa Takato） 2022年新卒⼊社楽楽明細開発部開発3課楽楽電⼦保存→楽楽債権管理のバックエンドを担当沖縄出⾝で、バスケとK-POPが好きです

Slide 4

Slide 4 text

4 ⽬次 1. 前提 2. 最初の失敗 3. 失敗から学んだこと 4. 改善の変化 5. Subagentsの使い所 6. 仕組みの⼯夫 7. まとめ

Slide 5

Slide 5 text

Slide 6

Slide 6 text

6 前提 - 対象 - ノンコアなCRUD API 5本 - 条件 - 既存の類似実装が2パターン - 成功条件 - 各Subagentが複雑な競合を作らず、PRを作成できること - きっかけ - SubagentsでAPIを並列実装できるのか試したかった

Slide 7

Slide 7 text

7 前提 - 進め⽅ - 調査フェーズ - Subagentsで既存実装の調査 - 参照系＋更新系＋削除の3パターン - 流⽤できる部分‧新規部分‧競合しやすい共通部分 - 実装フェーズ - 親エージェントが、共通部分の事前実装し、commit - このcommitからGit worktreeを切り、5本のAPIを Subagentsで並列実装 - 実装→テスト→フォーマット→ビルドを実⾏

Slide 8

Slide 8 text

Slide 9

Slide 9 text

9 最初の失敗【調査フェーズは上⼿くいったが、そのままでは並列実装に⼊れず】 - 調査フェーズ - 作業の全体像、Why＋What、狭いスコープと明確な役割などをプロンプトで与えた結果、⾃律的に作業を遂⾏ - Subagentsにタスクを与えつつ、⾃⾝も後続の作業に必要そうな情報をかき集める真⾯⽬さ - 流⽤できる部分‧新規部分‧競合しやすい共通部分の整理完了

Slide 10

Slide 10 text

10 最初の失敗【調査フェーズは上⼿くいったが、そのままでは並列実装に⼊れず】 - 実装フェーズ - メインセッション側で調査フェーズの情報を参照しつつ、共通部分の実装を完了 → 並列実装へだが共通部分の整理が不⾜していため、各Subagentが想定しない複数のファイルまで変更してしまった。その結果、PR作成前から複雑な競合が発⽣していると確認できた。

Slide 11

Slide 11 text

Slide 12

Slide 12 text

12 失敗から学んだこと【Subagentsに実装を依頼する前の親の完了条件を改善】 - 調査結果をただ貰うだけではなく、5本のAPIで競合しやすい共通部分を親が洗い出す必要があった - 並列実装前に、各Subagentが不要な共通部分を変更せず実装を⾏えるかの確認が抜けていた - その状態を確認するため、親に⾃⼰レビューを繰り返すようにプロンプトを修正

Slide 13

Slide 13 text

Slide 14

Slide 14 text

14 改善の変化【Subagentsの作業内容が想定通りに】 - 各Subagentの担当が明確になり、想定通りの範囲で実装を⾏うように - 共通部分も⾃分の担当だけを変更するので、複雑な競合を抑えられた - その結果、並列実装のPRをレビューしやすい単位で分けられた

Slide 15

Slide 15 text

Slide 16

Slide 16 text

16 どんなタスクに向いてるか - やりやすそうなタスク - 既存実装があり、流⽤元を⽐較しやすいタスク - 親が先に共通部分を固められるタスク - 各Subagentがある程度独⽴して作業できるタスク - やりにくそうなタスク - 実装のFBを得ながら、設計も繰り返すタスク - 完全新規実装なタスク（ただし仕様がシンプルならやれそう）【Subagentsで並列実装する時の使い所】

Slide 17

Slide 17 text

Slide 18

Slide 18 text

18 仕組みの⼯夫【プロンプトとSkillで運⽤を固める】 - プロンプトで設計する - 親から、役割‧制約‧完了条件を渡し、並列作業を設計 - 最初からカスタムエージェント化をせず、柔軟に対応 - $Skillで運⽤を固定 - PR作成前の仕上げ⼿順を固定 - 実装後のフォーマット / テスト / 差分⽐較レビューまで担当

Slide 19

Slide 19 text

19 仕組みの⼯夫【観察と制御の仕組み】 - 複数のSubagentの動きは、Codex appで⾒ると良い（お試し版） - 以下はCodex appの⼊⼒欄上部で動いている様⼦

Slide 20

Slide 20 text

20 仕組みの⼯夫【観察と制御の仕組み】 - 複数のSubagentの動きは、Codex appで⾒ると良い（お試し版）

Slide 21

Slide 21 text

21 仕組みの⼯夫【観察と制御の仕組み】 - 複数のSubagentの動きは、Codex appで⾒ると良い（お試し版）

Slide 22

Slide 22 text

22 仕組みの⼯夫【観察と制御の仕組み】 - approval_policyやsandboxの設定によっては都度承認が必要で、本格運⽤時には別途事前設計が必要

Slide 23

Slide 23 text

Slide 24

Slide 24 text