マージ提案
マージ提案
ブランチの変更を別のブランチに反映する前にレビューを依頼できます。
概要
マージ提案では、あるブランチの変更を別のブランチにマージするリクエストを記録し、実行前にチームメイトが差分をレビューできます。エージェントの編集権限を持つユーザーは、本人にマージ権限がないブランチに対しても提案を作成できます。提案のマージには引き続き対象ブランチへの書き込み権限が必要です。そのため、すべてのコントリビューターにマージ権限を付与せずに、変更を保護されたブランチへ反映できます。
マージ提案では、ブランチを直接マージする手順に任意のレビュー工程を追加できます。対象ブランチへの書き込み権限があり、他者の確認が不要な場合は直接マージしてください。事前にレビューを受けたい場合、または対象ブランチが保護されていて書き込み権限がない場合は、提案を作成してください。
提供状況
マージ提案はアルファ版です。エージェントの複数ブランチを同時に進めると、どのブランチがマージ可能で安全なのかを把握しにくくなります。マージ提案により、チームは1か所でブランチの変更をレビュー・議論し、ブランチ間のテスト合格率を比較し、ブランチの最新の会話を確認できます。
このアルファ版は、GitHubのプルリクエストに似た、エージェント向けCI/CDスタイルのワークフローへの第一歩です。今後数週間で、次の機能を追加する予定です。
- 提案をマージする前に合格が必須となるテスト。
- 特定のレビュー担当者への承認依頼。
- エージェントの各部分に対するオーナーの設定。
提案のライフサイクル
各提案には、次のいずれかのステータスがあります。
提案がオープン中、レビュー担当者は次のいずれかの判定を残せます。同じレビュー担当者による最新の判定は、それ以前の判定を置き換えます。
提案を作成する
レビューしたい変更があるブランチから提案を作成します。
ブランチリストから
提案タブから
エージェントのブランチタブで、ソースブランチのオプションメニューを開き、マージ提案を作成を選択します。
提案にタイトル、任意の説明を付け、エージェントのアーカイブされていない別のブランチから対象ブランチを選択します。提案を作成しても、どちらのブランチも変更されず、リクエストのみが記録されます。
同じソースブランチと対象ブランチの組み合わせに対して、同時にオープンできる提案は1件までです。同じ2つのブランチ間で別の提案を作成する前に、既存の提案をクローズしてください。
提案をレビューする
提案ページには、次のタブがあります。
概要
変更
テスト実行
会話
説明、レビュー履歴、レビューを残すためのフォームです。
提案の作成者本人以外で、エージェントへの編集権限を持つユーザーは、任意のコメントを添えてレビューを残せます。コメントではMarkdownを使用できます。
提案をマージする
提案をマージすると、ブランチを直接マージする場合と同じマージが行われます。競合の解決や、後でソースブランチをアーカイブするオプションも含まれます。マージするには、提案が次の要件を満たす必要があります。
- マージするユーザーは、ソースブランチと対象ブランチの両方への書き込み権限を持っている必要があります。保護されたブランチでは、ワークスペース管理者である必要があります。
- いずれのレビュー担当者についても、最新の判定が「変更をリクエスト」ではないこと。変更をリクエストしたレビュー担当者は、提案をマージする前に承認する必要があります。
- 提案には、作成者以外から少なくとも1件の承認が必要です。ワークスペース管理者は、この承認なしでマージできます。
提案をマージすると、そのソースブランチに対する他のオープン中の提案は、変更がすでに反映されたため自動的にクローズされます。
提案をクローズする
提案は、オープン中であればいつでもマージせずにクローズできます。作成者とレビュー担当者は、クローズされるまでタイトルと説明を編集できます。
- 作成者が自分の提案をクローズすると、取り下げ済みとして記録されます。
- 他者がクローズすると、却下として記録されます。
- ソースブランチをアーカイブすると、そこから、またはそこへのオープン中の提案がすべて自動的にクローズされ、branch_archivedとして記録されます。
マージ提案とArchitect
Architectは、ブランチ、バージョン、マージについて質問すると、エージェントのブランチに対する読み取り権限を持ちます。そのため、会話内で提案の差分を理解したり、オープン中のレビューを要約したりする支援ができます。