文档

审核并合并处理结果

在pull request上接收的内容、需要核查的事项以及退回工作的方式。

Coroid 会在自己的分支上针对你的基准分支创建 pull request,它绝不会自行合并。合并始终由人工决策,可在你的服务商端完成,也可通过批准并合并在 Coroid 中操作。详见合并。

随其一同交付的内容

  • 代码变更
  • 与之配套编写或更新的测试用例
  • 运行现有测试套件后的结果
  • 你所在组织配置的所有质量门控的判定结果
  • 对差异内容的评审流程,其中发现的问题要么已被修复,要么已列明

其目的并非取代你的评审环节,而是确保你的评审并非首次评审。

在导出命令中添加 --json 标识Coroid 分支main
  • 代码变更内容4 个文件
  • 已编写或更新的测试用例2 个文件
  • 您现有的测试套件已通过
  • 质量检查关卡1 项建议性发现
  • 审核通过2 项已修复,1 项待处理
通过您的供应商合并,遵循您设定的分支保护规则。由您合并
仅为示例性 pull request。在您查看前,系统已完成自动化检查,因此您审核时只需关注变更是否合理即可。

实际需要核查的内容

机械性检查项早已完成校验。请将注意力集中在只有你才能判断的事项上:

  1. 它是否解决了正确的问题?将其与需求文档中的验收标准对比,而非凭你对需求的记忆来判断。
  2. 它是否符合代码库规范?包括编码约定、命名规则以及抽象结构的设计。Coroid 会解析你的代码以推导这些规则,虽大多时候能准确匹配,但并非百分百无误。
  3. 它涉及了哪些你未曾预料到的部分?查看差异内容前的文件列表。
  4. 新增的测试用例是否有意义?无法验证任何逻辑的通过型测试用例,比没有测试用例更糟糕。

退回工作成果

你有三种可选方案,成本依次递增:

  • 添加评论并要求返工——该任务会带着你的反馈退回给开发智能体,同时保留原有上下文。适用于“内容正确但不够完整”的情况。
  • 驳回方案并重新运行——适用于方案本身有误,而非执行过程存在问题的情况。
  • 取消任务——适用于根本无需开展该项工作的情况。取消操作会终止运行并释放智能体资源。

在修改意见中请尽量表述具体,就像和同事沟通时一样。例如“此处未处理空值情况”parseRange写“已修复”会生成修正方案;而写“还需改进”则只能得出猜测性结论。

合并

Coroid 绝不会自行执行合并操作。没有相关设置能让它在任务完成后自动合并。合并操作只有两种触发方式,且均需由人工决策是否执行。

这一规则同样适用于在以下指令下开展的工作:指令Coroid 也会记录它针对每次合并做出的判断,用于评估自身决策准确性,但不会依据这些记录采取行动。详见Coroid 的决策内容以及需由您定夺的部分。

在 GitHub 或 GitLab 中

在您的代码托管平台中合并 pull request,需遵循常规的分支保护规则、必填检查项及审批要求。pull request 属于普通分支——这是刻意设计的,因此会经过您已有的审核流程和持续集成机制。

通过 Coroid 执行“批准并合并”操作

Coroid 中的审核界面配有批准并合并按钮。点击该按钮后需确认操作,随后 Coroid 会通过 GitHub 或 GitLab 为您合并 pull request,此过程依托项目的代码库连接实现。该合并操作与在代码托管平台中点击合并按钮的效果一致,因此会适用您设定的分支保护规则、必填检查项及审批要求。若这些规则阻止合并,Coroid 会显示代码托管平台给出的原因,此时不会执行任何合并操作。

合并前的流程取决于您所审批的内容:

  • 一个任务。该任务需要先创建 pull request。如果尚未创建,审核界面会提供创建 PR选项,然后再进行批准并合并。一旦您批准,Coroid 会推送任务分支,确保 pull request 包含最新的审核后提交内容,随后再合并 pull request。批准任务需要具备该项目写入权限。
  • 一个计划。属于计划的任务无法单独合并。计划的唯一 pull request 需通过升级审核后方可合并。Coroid 会首先确认自计划启动以来基准分支是否发生变化(详见 当基准分支发生变动时),且质量检查达标、pull request 不存在合并冲突、也没有流程关卡阻止合并,才会执行 pull request 的合并操作。批准计划需要具备该项目写入权限。
  • 强制合并。计划的升级审核界面也提供强制合并选项。该操作会跳过 Coroid 对基准分支、合并冲突及流程关卡的校验,但仍会执行必填的质量检查及代码托管平台的规则。使用该功能需提供书面理由,该理由会与升级记录一同存档,且需具备项目管理员权限。

该聊天助手和MCP客户端也可以审批或强制合并计划的pull request。它们会模拟你的操作,因此同样适用相应的校验规则和项目访问权限。聊天助手会先请求你确认;MCP客户端发起的强制合并请求会始终停留在审批以供人工处理。MCP客户端的审批请求是否会在该处等待,取决于你设置的自动化策略。两者都无法单独合并单个任务。

准备即将发布的内容

合并完成后,打开项目的版本发布标签页并 选择新建版本。挑选你想要发布的已合并提交;Coroid会列出其中包含的拉取请求。版本页面会引导你依次完成四个环境步骤:校验、审批、部署和健康检查。部署工作仍由你的代码库和CI/CD执行。只有当流水线确认部署成功,或者所有者或管理员记录了经验证的外部部署记录时,Coroid才会标记版本已部署。

下一步

版本发布— 准备已合并的提交,并跟踪其在各环境中的运行情况。后续操作指引列出了其他工作流程。