合并提案

概述

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

可用性

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

alpha 版是迈向智能体 CI/CD 风格工作流程的第一步，类似 GitHub 上的拉取请求。未来几周计划新增：

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

提案生命周期

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

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

创建提案

从希望审查其更改的分支创建提案：

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

审查提案

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

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

合并提案

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

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

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

关闭提案

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

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

合并提案与 Architect

当你询问 Architect 有关分支、版本和合并的问题时，Architect 可读取智能体分支，因此它能帮助理解提案差异，或在对话中汇总开放审查。

后续步骤