update-pr

PR を更新する

既存の PR を統合し、関連するコミットを含め、通常のプッシュを行い、メタデータを最新の状態に更新します。この依頼には、定型的な競合の解決と、宣言された PR ゲートの実行が含まれますが、マージは許可されていません。選択済みのターゲットと以前の承認を再利用してください。対象の PR、重要な競合解決の選択、またはこの更新に関するその他の重要な選択が不明な場合にのみ確認してください。

現在の PR がネイティブの GitHub スタックに属している場合は、 ../git-workflow/references/github-stacks.mdをお読みください。 PR のメディアが現在の動作を示していない場合、または新しいメディアが必要な場合は、 ../create-pr/references/walkthroughs.mdを使用して、該当部分を更新してください。現在の動作を示しているメディアは再利用してください。メディアツールの不足だけを理由に、更新を中断する必要はありません。

1. git-workflow を適用します。git-workflow の定義に従い、現在の PR とベースブランチ、ブランチ、関連するローカルの変更、最近のコミット、取得済みのリモートベースを確認します。ベースから遅れているブランチや競合するブランチがある場合は、CI 不足への対応を決める前に解決します。
2. ベースブランチにいる場合、またはオープンな PR がない場合は停止し、次に必要なワークフローを報告します。git-workflow で PR にリモートベースが設定されていない場合も同様に停止します。
3. 通常のブランチがリモートベースから遅れている場合は、そのベースをブランチにマージします。加算的な競合では、両方の側で必要な動作を維持し、生成ファイルはプロジェクトのツールを使って再生成します。解決が確定したら、検証を続行します。ネイティブスタックであることを確認できた場合は、リモートのヘッドを記録し、保護された gh stack sync または、より限定的な公式スタック操作を使用します。生の rebase コマンドや force-push コマンドは決して使用しません。
4. 変更された動作に対して、ベースラインの統合を含め、/code-review fix-all と /test-against-spec fix を適用します。内容、コマンド、環境、対象範囲が引き続き一致するエビデンスのみ再利用します。ベースラインのマージや編集によって、影響を受けるチェックは無効になります。不足しているチェックや無効になったチェックを実行します。対象範囲内で確認された要件の不足をすべて、/implement の開発ループを通じて修正し、宣言された PR ゲートを確立します。未公開の修正をテストするためにプレビューが必要な場合は、そのドラフト更新を許可します。その正確なリビジョンでテストを再開してから、準備完了を報告します。
5. 関連する変更がある場合は、git-workflow に従ってコミットします。対象ファイルだけをステージし、簡潔な Conventional Commit 形式の件名を使用します。amend やフックのスキップは決して行いません。各コミット、プッシュ、PR の書き込み時に 公開ガードを実行します。
6. ブランチにリモートにないコミットがある場合、通常のブランチは必要に応じて upstream を設定し、通常どおりプッシュします。検証済みのスタックは、保護された公式スタックワークフローでのみプッシュします。
7. PR のタイトルと本文を、現在の完全な差分、対象範囲、リンクされた課題、確認済みの検証結果に合わせて更新します。プッシュすると検証対象のヘッドが必ず変わるため、概要がそのままでも、プッシュ後に本文を更新します。変更全体を表す Conventional Commit 形式の件名をタイトルに使用します。これは squash merge のコミット件名になるため、対象範囲が広がった場合はタイプも変更することがあります。 ../agent-writing/references/pr-descriptions.mdに従い、明示されたプロジェクトテンプレートの要件を維持し、古くなった概要や開発途中の履歴を置き換えます。
8. 更新した PR、新しいコミット、メタデータの変更、公開ガードによって書き換えられた内容、確認済みの検証結果を報告します。該当する場合は、スタック内の位置と書き換えられたブランチも含めます。成功したローカルチェックと、現在のヘッドに対して保留中の CI を区別します。正確な現在のヘッドと次の遷移先を、アクティブな公開またはデリバリーの呼び出し元に返します。呼び出し元は CI とフィードバックへの対応を続行します。ドラフト PR はドラフトのままにします。create-pr と同様、必要な CI とエビデンスがすべて、その正確なヘッドで成功したことを確認してから、準備完了にします。不足しているウォークスルー要件と、その解決方法を報告します。