マージ提案

概要

マージ提案では、あるブランチの変更を別のブランチにマージするリクエストを記録し、実行前にチームメイトが差分をレビューできます。エージェントの編集権限を持つユーザーなら、自身ではマージできないブランチに対しても提案を作成できます。提案をマージするには引き続き対象ブランチへの書き込み権限が必要です。そのため、すべてのコントリビューターにマージ権限を付与せずに、変更を保護されたブランチへ反映できます。

提供状況

マージ提案はアルファ版です。エージェントの複数のブランチを同時に進める場合、どのブランチがマージ可能で安全なのかを把握するのが難しくなります。マージ提案では、チームが1か所でブランチの変更をレビュー・議論し、ブランチ間のテスト成功率を比較して、ブランチの最新の会話を確認できます。

このアルファ版は、GitHubのプルリクエストに似た、エージェント向けCI/CDスタイルのワークフローに向けた第一歩です。今後数週間で、以下の追加を予定しています。

• 提案をマージする前に成功する必要がある必須テスト。
• 特定のレビュアーへの承認依頼。
• エージェントの各部分に対するオーナーの設定。

提案のライフサイクル

各提案には、以下のいずれかのステータスがあります。

提案がオープン中、レビュアーは以下のいずれかの判定を残します。同じレビュアーによる最新の判定は、それ以前の判定に置き換わります。

提案を作成する

レビューしたい変更があるブランチから提案を作成します。

提案のタイトル、任意の説明を入力し、エージェントのアーカイブされていない他のブランチから対象ブランチを選択します。提案を作成しても、どちらのブランチも変更されず、リクエストが記録されるだけです。

提案をレビューする

提案ページには、以下のタブがあります。

提案の作成者以外でエージェントの編集権限を持つユーザーは、任意のコメント付きでレビューを残せます。コメントではMarkdownを利用できます。

提案をマージする

提案をマージすると、競合の解決や後からソースブランチをアーカイブするオプションを含め、直接マージする場合と同じブランチのマージが実行されます。マージするには、提案が以下の要件を満たす必要があります。

• マージするユーザーは、ソースブランチと対象ブランチの両方への書き込み権限を持っている必要があります。保護されたブランチでは、ワークスペース管理者である必要があります。
• いずれのレビュアーについても、最新の判定が「変更をリクエスト」ではありません。変更をリクエストしたレビュアーは、提案をマージする前に承認する必要があります。
• 提案には、作成者以外の少なくとも1人からの承認が必要です。ワークスペース管理者は、この承認なしでマージできます。

提案をマージすると、同じソースブランチに対する他のオープン中の提案は、その変更がすでに反映されたため自動的にクローズされます。

提案をクローズする

提案は、オープン中であればいつでもマージせずにクローズできます。作成者とレビュアーは、クローズされるまでタイトルと説明を編集できます。

• 作成者が自身の提案をクローズすると、取り下げとして記録されます。
• 他のユーザーがクローズすると、却下として記録されます。
• ソースブランチをアーカイブすると、そのブランチからまたはそのブランチへのオープン中の提案はすべて自動的にクローズされ、branch_archived として記録されます。

マージ提案とElevenAgents Architect

Architectは、マージ提案を作成できます。ブランチで変更を加えてテストした後、そのブランチのコミットとマージプレビューを読み取り、概要、テスト、レビュー方法のセクションを含む提案を作成します。選択できるレビュアーを提案することもできます。Architectはユーザーとして操作するため、提案の作成者にはユーザーが表示されます。

Architectは、提案のレビュー、承認、マージ、クローズはできません。これらの手順は必ず人が行います。詳細なフローについては、提案とバリデーションを参照してください。

次のステップ