出典: GitHub Stacked PRs - GitHub Features
1.最初に
GitHub Stacked PRsは、大規模な変更を「独立してレビュー可能なプルリクエストの積み重ね」として管理し、開発サイクルを加速させる新機能です。
大きな変更を一つの巨大なPRに詰め込むのではなく、各変更を「フォーカスされたレイヤー」として積み重ねることで、レビューの質を落とさず、コンフリクトのリスクを最小限に抑えながらマージまで進めることが可能になります。
2.スタックPRの仕組みとメリット
スタックの構造
Stacked PRsでは、各PRがその直下のPRをベース（ターゲット）とする連鎖構造を形成し、最終的にmainブランチへと繋がります。
main ← PR #1 (認証基盤) ← PR #2 (API実装) ← PR #3 (UI構築)
導入のメリット
シニアエンジニアの視点から見て、特に以下の3点が大きな技術的メリットとなります。
- レビュー品質の向上:変更が焦点の絞られたレイヤーに分割されるため、レビュワーは文脈を維持しやすく、迅速かつ的確なフィードバックが可胻になる
- 「Final Target Branch」に基づいた検証:GitHubがネイティブでスタックを認識するため、CIやブランチ保護ルールは最終的なターゲットブランチに対して実行・適用される
- 依存関係の自動解消:スタック下部のPRがマージされると、上部のPR群に対してCascading Rebaseが自動実行され、常に最新のベースに基づいた状態が維持される
3.注目の主要機能
GitHub Stacked PRsは、Web UI、CLI、そしてAI連携の3つの側面で高度な開発体験を提供します。
- ネイティブUI:
PR画面にスタックの全体像を示す「スタックマップ」が表示される。レビュワーは各レイヤーごとの差分に集中しながら、スタック全体を自由に行き来してステータスを確認できる - 柔軟なマージとMerge Queue対応:CIがパスしたレイヤーまでをワンクリックで一括マージできる。また、Enterprise等で利用される「Merge Queue」にも完全対応している
- gh stack CLI:ターミナルからスタック作成、リベース、一括プッシュなどを効率化する専用CLIが提供される。本ツールの利用は任意であり、標準のGitワークフローのみで運用することも可能
AI Agentとの連携
AIコーディングエージェントを活用しているチームにとって、npx skills add github/gh-stackは注目すべきコマンドです。これを実行することで、AIエージェントに「スタック」という概念を教え込むことができます。これにより、AIが巨大な差分を自動的に適切なスタックへ分割したり、最初からスタック構造を前提としたコード生成を行ったりすることが可能になります。
4.現在のステータスと利用方法
本機能は現在、プライベートプレビューの段階です。
- ウェイトリスト:利用には公式サイトからのウェイトリスト登録が必要
- リポジトリ単位の有効化:プレビュー権限が付与された後、対象のリポジトリ設定で機能を個別に有効化する必要がある
Discussion