跳到导航

合并提案

在分支更改进入另一分支前请求审核。

概览

合并提案用于记录将一个分支的更改合并到另一个分支的请求,并让团队成员在合并前审核差异。任何拥有智能体编辑权限的人都可以创建提案,即使其无权自行合并到目标分支。合并提案仍需目标分支的写入权限,因此无需为每位贡献者授予受保护分支的合并权限,也能让更改进入该分支。

合并提案在直接合并分支 的基础上增加了可选审核步骤。如果拥有目标分支的写入权限且不需要他人复核,可直接合并。若希望先审核,或目标分支受保护而你没有其写入权限,请创建提案。

可用性

合并提案目前处于 Alpha 阶段。当一个智能体的多个分支同时在开发时,很难追踪哪些分支已准备就绪且可安全合并。合并提案为团队提供了统一位置,可审核和讨论分支更改、比较分支之间的测试通过率,以及查看分支的最新对话。

Alpha 版是迈向智能体 CI/CD 工作流程的第一步,类似 GitHub 上的拉取请求。未来几周计划增加:

  • 提案合并前必须通过的必需测试。
  • 向特定审核者请求批准。
  • 为智能体的不同部分配置负责人。

提案生命周期

每个提案都有以下状态之一:

状态含义
打开等待审核或合并。
已合并源分支的更改已合并到目标分支。
已关闭由作者撤回、被其他人拒绝,或因源分支已归档而自动关闭。

提案处于打开状态时,审核者可给出以下结论。审核者最新的结论会替代同一审核者此前的结论:

审核状态含义
已批准审核者认可这些更改。
请求更改审核者希望在合并前处理某些问题。

创建提案

从希望审核其更改的分支创建提案:

在智能体的 Branches 标签页中,打开源分支的选项菜单,然后选择 **Open merge proposal **。

分支选项菜单中的 Open merge proposal 选项

为提案填写标题和可选描述,并从智能体其他未归档分支中选择目标分支。创建提案不会更改任一分支,只会记录该请求。

同一源分支和目标分支组合一次最多只能有一个打开的提案。在同一对分支之间创建新提案前,请先关闭现有提案。

审核提案

提案页面包含以下标签页:

显示描述、审核历史和提交审核的表单。

合并提案的概览标签页

除提案作者外,任何拥有智能体编辑权限的人都可提交带可选评论的审核。评论支持 Markdown。

合并提案

合并提案与直接合并执行相同的分支合并,包括冲突解决和之后归档源分支的选项。提案合并前必须满足以下要求:

  • 执行合并的用户同时拥有源分支和目标分支的写入权限。对于受保护分支,这意味着该用户必须是工作区管理员。
  • 没有任何审核者的最新结论为“请求更改”。请求过更改的审核者必须批准后,提案才能合并。
  • 提案至少获得一名非作者用户的批准。工作区管理员无需该批准即可合并。

合并提案会自动关闭同一源分支的所有其他打开提案,因为其更改现已转移。

关闭提案

提案处于打开状态时,可随时关闭而不合并。提案关闭前,作者和审核者都可以编辑其标题和描述。

  • 作者关闭自己的提案时,会记录为 已撤回。
  • 其他人关闭提案时,会记录为 已拒绝。
  • 归档源分支会自动关闭来自或指向该分支的所有打开提案,并记录为 branch_archived。

合并提案与 ElevenAgents Architect

Architect 可为你创建合并提案。它在分支上完成并测试更改后,会读取分支的提交和合并预览,并创建包含 摘要、测试 和 如何审核 部分的提案。它还可建议供你选择的审核者。由于 Architect 代表你操作,提案会将你列为作者。

Architect 无法审核、批准、合并或关闭提案。这些步骤始终由人工完成。完整流程请参阅提案和验证。

后续步骤