跳到导航

合并提案

在分支更改合并到其他分支前,请求审查。

概述

合并提案会记录将一个分支的更改合并到另一个分支的请求,并允许队友在合并前审查差异。任何拥有智能体编辑权限的人都可以发起提案,即使他们无权自行合并到目标分支。合并提案仍需要目标分支的写入权限,因此提案可让更改进入受保护分支,而无需授予每位贡献者该分支的合并权限。

合并提案在直接合并分支的基础上增加了可选审查步骤。拥有目标分支写入权限且不需要他人复核时,可直接合并。希望先审查更改,或目标分支受保护且你没有写入权限时,请发起提案。

可用性

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

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

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

提案生命周期

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

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

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

审查状态含义
已批准审查者对更改感到满意。
请求更改审查者希望在合并前处理某些问题。

发起提案

从希望审查其更改的分支发起提案:

在智能体的 分支 标签页中,打开源分支的选项菜单,然后选择 **发起 合并提案 **。

分支选项菜单中的“发起合并提案”选项

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

同一对源分支和目标分支一次最多只能有一个开放提案。请先关闭现有提案,再在相同两个分支之间发起新提案。

审查提案

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

描述、审查历史以及提交审查的表单。

合并提案的“概述”标签页

除提案作者外,任何拥有智能体编辑权限的人都可以提交审查,并可选择添加评论。评论支持 Markdown。

合并提案

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

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

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

关闭提案

提案开放期间可随时关闭,无需合并。提案关闭前,作者和审查者可以编辑其标题和描述。

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

合并提案与 ElevenAgents Architect

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

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

后续步骤