{"meta":{"title":"スタックプル要求のクイック スタート","intro":"gh stackにGitHub CLI拡張機能をインストールし、スタックされたプル要求の最初のセットを作成します。","product":"Pull Request","breadcrumbs":[{"href":"/ja/pull-requests","title":"Pull Request"},{"href":"/ja/pull-requests/get-started","title":"概要"},{"href":"/ja/pull-requests/get-started/stacked-prs-quickstart","title":"Stacked PR のクイック スタート"}],"documentType":"article"},"body":"# スタックプル要求のクイック スタート\n\ngh stackにGitHub CLI拡張機能をインストールし、スタックされたプル要求の最初のセットを作成します。\n\n> \\[!NOTE] この機能はパブリック プレビュー段階であり、変更される可能性があります。\n\nスタック プル要求を使用して、大規模なコード変更を、個別に確認およびマージできる、より小さい依存プル要求のチェーンに分割します。\n\nスタックは、同じリポジトリ内の一連のプル要求です。各プル要求は、その下のプル要求のブランチを対象とし、1 つのブランチ (通常はメイン ブランチ) に配置される順序付きチェーンを形成します。 1 つの大きなプル要求の代わりに、一連の小さなプル要求を取得します。 各プル要求には独自のフォーカスされた差分があるため、チームメイトは各レイヤーを個別に確認して承認できます。\n\n## 前提条件\n\n* GitHub CLI (`gh`) 2.90.0 以降、および Git 2.20 以降。\n  * GitHub CLIを使用して`gh auth login`を認証します。\n* プッシュできる GitHub リポジトリ。\n\n## CLI 拡張機能をインストールする\n\n```shell copy\ngh extension install github/gh-stack\n```\n\n> \\[!TIP]\n> GitHub Copilotなどの AI コーディング エージェントでスタック プル要求を使用するには、`gh-stack` スキルをインストールします。\n>\n> ```shell copy\n> gh skill install github/gh-stack\n> ```\n\n## 最初のスタックを作成する\n\n1. スタックを初期化するには、リポジトリに移動し、次のコマンドを実行します。 これにより、追跡エントリと最初のブランチが作成されます。\n\n   ```shell copy\n   gh stack init\n   ```\n\n   最初のブランチに名前を付けるメッセージが表示されます。 既定では、スタックはリポジトリの既定のブランチ ( `main` など) をトランクとして使用しますが、スタックは任意のブランチをターゲットにすることができます。\n\n2. 通常どおり、最初のブランチ (コードの記述、ステージ変更、コミット) で作業します。\n\n   ```shell\n   # ... write code ...\n   git add .\n   git commit -m \"helpful-commit-message\"\n   ```\n\n3. 次の作業の論理ユニットの準備ができたら、新しい分岐をスタックの一番上に追加します。\n\n   ```shell copy\n   gh stack add BRANCH-NAME\n   # ... write code ...\n   git add .\n   git commit -m \"Another-helpful-commit-message\"\n   ```\n\n4. すべてのブランチをリモートにプッシュします。\n\n   ```shell copy\n   gh stack push\n   ```\n\n5. プル要求を作成し、 GitHub上のスタックとしてリンクします。\n\n   ```shell copy\n   gh stack submit\n   ```\n\n   各プル要求は、正しいベース ブランチで作成されます。 最初のブランチは `main`をターゲットとし、次のブランチ `BRANCH-NAME` は最初のブランチをターゲットにします。 レビュー担当者には、そのレイヤーの差分のみが表示されます。 プル要求は、 GitHub 上のスタックとして自動的にリンクされ、その順序を確認して、それらの間をすばやく移動できます。\n\n6. スタックを表示し、いつでも完全な状態を確認できます。\n\n   ```shell copy\n   gh stack view\n   ```\n\n   このコマンドは、すべてのブランチ、そのプル要求リンク、状態、およびそれぞれの最新のコミットを表示します。\n\n7. `gh stack add -Am \"MESSAGE\"`を使用して、すべての変更をステージングし、コミットし、1 つの手順で次のブランチを作成します。 別の `git add` や `git commit`は必要ありません。 現在のブランチにコミットがまだない場合、コミットはそこに着陸します。既にコミットがある場合は、新しいブランチが作成されます。\n\n   ```shell\n   # Commit lands on the current branch\n   gh stack add -Am \"Auth middleware\"\n\n   # Current branch already has commits, so this creates the next branch\n   gh stack add -Am \"API routes\"\n   ```\n\n8. 準備ができたら、すべてをプッシュし、プル要求を作成します。\n\n   ```shell copy\n   gh stack submit\n   ```\n\n## 次のステップ\n\n* [スタックされたプル要求の管理](/ja/pull-requests/how-tos/create-pull-requests/managing-stacked-pull-requests)\n* [スタックされたプルリクエストのマージ](/ja/pull-requests/how-tos/merge-and-close-pull-requests/merging-stacked-pull-requests)\n* [プル要求で AI によって生成されたコードをスタックする](/ja/copilot/tutorials/stack-ai-generated-code-in-pull-requests)\n* [積み重ねられたプル要求を組織にロールアウトする](/ja/pull-requests/tutorials/roll-out-stacked-prs)"}