shwldshwlda month ago

Issue起点のAIエージェント自動実装パイプラインを組む

Claude CodeやCodexにはworktree機能が組み込まれているが、「issueを読む→worktreeを作る→実装する→テストする→PRを出す」までを一気通貫で自動化するには、エージェントの上にオーケストレーション層が要る。

仕組み:

  • issueのステータス(Ready/In Progress/In Review)を状態マシンとして管理する
  • 各issueに対して独立したworktreeを作成し、そのworktree内でAIエージェントのセッションを起動する
  • エージェントにissueのPlanとDoDを読ませ、実装→verify→自動修正のループを回す
  • verifyが通ったらPRを作成し、issueをIn Reviewに遷移する
# 1 issue = 1 worktree = 1 PR を厳守
# issueごとにロックファイルで重複実行を防止
story-dev --story 41  # issue #41のworktreeで実装開始
story-dev --story 79  # 別ターミナルでissue #79を並行実装

やってみてどうだったか:

  • エージェント組み込みのworktreeは「ブランチを切って作業する」単位。パイプライン全体の管理(issue選定、ステータス遷移、verify条件の判定)は自前で組む必要がある
  • issueにPlan/DoD/verifyコマンドを書いておくと、エージェントが「何をもって完了か」を自律判断できる
  • 並行実行時はgit common dir配下にissue単位のロックファイルを置いて衝突を防ぐ
  • 人間のレビューがボトルネックになるので、2〜3本の並行が実用的な上限