マージ提案

概要

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

提供状況

マージ提案はアルファ版です。1つのエージェントで複数のブランチを同時に進めている場合、マージの準備ができ安全に反映できるブランチを把握するのは難しくなります。マージ提案により、チームはブランチの変更をレビュー・議論し、ブランチ間のテスト合格率を比較し、ブランチの最新の会話を確認するための場所を1つにまとめられます。

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

• 提案をマージする前に合格が必須となるテスト
• 特定のレビュアーへの承認依頼
• エージェントの異なる部分に対するオーナーの設定

提案のライフサイクル

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

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

提案を作成する

変更をレビューしてほしいブランチから提案を作成します。

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

提案をレビューする

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

提案の作成者以外でエージェントの編集アクセス権を持つユーザーは、任意のコメントを添えてレビューを残せます。コメントではMarkdownを使用できます。

提案をマージする

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

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

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

提案をクローズする

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

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

マージ提案とElevenAgents Architect

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

Architectは提案のレビュー、承認、マージ、クローズはできません。これらのステップは常に人が行います。詳細なフローについては、Proposals and validationをご覧ください。

次のステップ