Claude Code + GitHubでissue→PR→mergeを自律化する実践ガイド

自律的な開発フローの全体像：未来はもう来ている

Claude CodeとGitHubを組み合わせた自律的開発フローの理想形は、人間がIssueを書いたらAIが実装・PR作成・マージまでを自律で完了させるというものだ。完全自動化は現時点では慎重なプロジェクトでは難しいが、段階的な自動化は今すぐ実現できる。

現実的なアプローチとして「Issue作成→Claude Codeが実装してPR作成→人間がレビュー→マージ」というフローから始めて、信頼できるタスク種別に限ってマージまで自動化するという段階的な導入が推奨される。あるチームでは「最初の3ヶ月でlowリスクのタスクの自動化を確立し、その後6ヶ月かけて適用範囲を広げた」という進め方が成功事例として紹介されている。

「そんな未来みたいな話が本当にできるの？」と思うかもしれない。実際にやってみると「できる、でも設計が重要」というのが正直な感想だ。魔法のようには動かないが、丁寧に設計すれば驚くほどスムーズに動く。

Issue読み取りから実装までの自動化

GitHub CLIとClaude Codeを組み合わせたシェルスクリプトで、IssueをClaude Codeに渡して実装させる基本フローを構築できる。gh issue view [番号]でIssueの内容を取得し、Claude Codeに「このIssueを実装してください」と渡す。Claude Codeは新しいブランチを作成し（命名規則も指定できる）、実装を行い、コミットメッセージを生成してプッシュする。

CLAUDE.mdにGitHub関連のルール（ブランチ名の命名規則・コミットメッセージのフォーマット・PR説明文のテンプレートなど）を記述しておくことで、一貫したスタイルを保てる。「Issueを書いてコーヒーを入れに行ったら、戻ってきたらPRができていた」という体験を一度すると、開発のイメージが根本から変わる。

PR自動作成とレビュアー割り当て

Claude Codeが実装を完了したら、gh pr createコマンドでPRを自動作成する。PR説明文もClaude Codeに生成させることで、変更内容・テスト方法・影響範囲を含む質の高い説明文が自動で作成される。Issueのラベルや担当者情報を参照してレビュアーを自動割り当てすることも可能だ。

実際にこのフローを使っているチームでは「PR説明文の品質がエンジニアが手書きするより高くなることも多い」という声がある。Claude Codeは変更の全体像を把握した上で説明文を書くため、漏れが少なく構造的な説明になる傾向がある。

自動マージの条件設定：どこまで任せるかの判断基準

全てのPRを自動マージするのは危険だが、「依存パッケージの更新」「スタイル修正」「ドキュメント更新」のような低リスクなカテゴリに限定して自動マージを設定するのは現実的だ。GitHub Branch Protectionルールでテスト通過・コードレビュー承認を必須条件とした上で、gh pr merge --autoで条件が満たされたら自動マージするフローが実用的だ。

「どこまで自動化するか」は技術的な問題というより組織的な問題だ。チームの信頼感・リスク許容度・リカバリー能力によって最適な自動化の範囲は変わる。まず小さな範囲で始めて、成功体験を積み重ねながら範囲を広げていく。それが持続可能な自律化の進め方だ。