文档

试点

试运行一个项目和一条工作流两周,观察系统和工作流的表现,并在正式上线前调整相关设置。

试点阶段会在小规模范围内实际运行该配置。选择一个项目 和一条工作流,运行两周时间。真实请求会反映出需求文档中遗漏的内容。

如果组织内未启用工作流功能,仅试运行该项目即可。

选择试点项目

  • 项目。选择一个客户信任且具备测试套件的代码库。CoRoid会借助客户的测试来验证其工作成果,因此优质的测试能给出明确结果。
  • 工作流。选择一类案例数量较多、有明确负责人 且规则可由客户书面规定的流程。
  • 相关人员。填写负责提工单、审核合并以及 回复待处理事项的人员姓名。

与客户约定两周后的合格成果标准。可参考需求文档中的目标要求。

需关注的事项

第一周每天查看这些数据,之后每周查看两次。

在系统中。打开系统概览。

  • 工作已完成,以及无需人工干预即完成的工作量。需要人工协助的工作往往反映出设置不当或需求模糊的问题。
  • 已合并的拉取请求,以及CoRoid发起的工单数量。
  • 交付耗时,以及等待人工处理的工作量占比。
  • 需要您处理。决策延迟会拖慢其他所有工作的进度。
  • 卡住或失败的任务。请参阅 当任务卡住或失败时。

在Quality Control中。大多数变更中均失败的校验项往往是因为设置错误。无法在项目里运行的校验项会在对应行标注说明。

在产能与开支方面。 设置 → 账单与用量 → 容量与积分显示当前活跃的代理数量以及排队等待的工作量。使用情况显示 工作成本情况。请参阅代理插槽与产能。

在工作流中。在 中打开对应工作流。工作流。

  • 案例。该需要您处理筛选器会显示等待人工处理的案例。
  • 统计数据。案例的结束方式、等待审批的情况、首次回复时长以及每个案例对应的代理处理时间。
  • 新情况。此提示说明有案例被分配给人工处理,是因为没有对应的处理路径覆盖该类情况。为此添加一条处理路径即可添加缺失的处理路径。

调整设置,而非修改工作内容

出现问题时,先找到背后的设置项。修改该设置,并将变更内容及原因记录在备注中。切勿每次都手动修复同一问题。

  • 任务执行结果有误:请检查项目上下文、AGENTS.md以及构建和测试命令。
  • 校验项无合理原因地失败:请在Quality Control中检查其配置。
  • 案例无合理原因地被分配给人工处理:添加一条处理路径或规则表条目,然后发布新版本即可。

每周例会

试点期间每周与客户召开一次例会。梳理观察到的情况及做出的调整,将新决策写入需求文档。

完成标志

两周时间结束后,客户需做出以下决定之一:

  • 按当前设置正式上线。
  • 延长试点时间,并列出优先调整的事项清单。