文档

实施指南

这是一套分为八个阶段的方案,用于为整个组织搭建CoRoid,从首次与客户会面到第90天的审核。

本指南面向负责为组织搭建CoRoid的人员。我们将此人称为实施人员,而该组织则被称为客户。实施人员既可以为客户工作,也可以受雇于客户所委托的公司。

开始使用流程可帮助一名新人从新账号逐步完成合并后的pull request创建。本指南则介绍后续步骤:将CoRoid适配到整个组织的系统、规则和流程中。

八个阶段

每个阶段都会生成相应的文档或成果,所有文档均由客户留存。请按顺序执行各阶段,仅在前一阶段完成后方可启动下一阶段。

阶段产出内容完成标志
1调研阶段调研文档:涵盖客户的目标、系统、规则及需覆盖的流程。客户确认该文档内容无误。
2安装阶段在CoRoid中为客户的组织创建对应项目,并采用适配该工作的计划。客户的所有者将获得所有者角色,每位实施人员均为项目成员。
3连接阶段接入Git托管平台、登录系统、聊天频道及相关工具。CoRoid可读取相关代码库,且每位人员均使用自己的账号登录。
4配置阶段设置项目、Quality Control、指令、AI配置文件、自动化规则、工作流、审核规则及技能要求。调研文档中的每条规则都对应相应的设置,或是给CoRoid的相关请求。
5试点阶段选取一个项目,让其工作流程在实际环境中运行两周。两周结束后,客户决定是否正式上线。
6正式上线阶段正式上线检查清单,需经客户签字确认。客户签署该检查清单。
7交接阶段交接说明文档,以及导出的设置和工作流文档。客户将收到这些资料,外部访问权限会被移除或缩减。
8第90天审核第90天评估数据,以及需要调整的事项清单。客户认可该清单内容。

大部分工作集中在第1阶段和第4阶段。若调研不细致,后续设置的规则可能无人能解释清楚。

决策权归属

决策权属于客户。实施人员负责询问需求、提出建议并进行设置。

  • 客户需指定一名代表行使决策权。该人员将在CoRoid中管理对应的组织,并签署正式上线检查清单。
  • 实施人员需记录每项决策及其原因。交接说明文档便是基于这些记录编写而成。
  • 若需求不明确,应向客户询问,切勿自行猜测规则。

顾问的访问规则

所谓顾问是指不为客户直接工作的实施人员。顾问需遵循以下规则在客户组织中开展工作。

  • 为每位人员创建独立账号。每位顾问均需使用自己的账号登录。一个账号可加入多个组织,因此顾问可为不同客户使用同一账号。
  • 严禁使用共享账号。绝不能以他人身份登录,也绝不要共享密码、访问令牌或恢复码。
  • 客户的登录规则请在个人资料中开启双重身份验证。若客户要求使用单点登录(SSO),客户会为其提供自身身份提供商中的账号。
  • 可执行相关工作的最低角色客户会邀请每位顾问加入设置 → 成员。本指南所述工作需赋予管理员角色,所有者角色则由客户保留。详见 邀请团队。
  • 交接时将会移除访问权限。交接时,客户会移除每位顾问的权限,或特意为其保留较低级别的角色。在此之前,每位顾问需先吊销自己生成的访问令牌。详见交接阶段。
  • 客户数据不得流出客户系统之外。切勿将代码、任务、案例或导出文件复制到自己的电脑或系统中。诸如设置包之类的导出文件需交给客户并留存于客户端。

顾问仅能加入成员数超过1人的计划所属组织。免费版计划中仅有所有者为成员。详见计划与定价。

开始前须知

请先阅读这些页面。本指南会链接到这些页面,不会重复赘述。