跳转到内容

实体生命周期参考

Chorus 中的每一项工作都属于三类实体之一:想法(Idea)、提案(Proposal) 或 任务(Task)。每类实体都会经历一组数量不多且固定的状态。本页按实体列出这些状态、 每个状态的含义,以及推动实体前进的动作。

想从更高层面了解整个交付流程在各阶段之间如何交接,请参阅 工作流参考。本页是它按实体展开的配套说明。

想法自身存储的状态只跟踪需求细化(elaboration) 阶段。一旦细化完成,想法即视为完成; 你在看板上看到的后续进展(规划、构建、验证、完成)都是从关联的提案和任务派生出来的, 并不存储在想法本身。这些任务可以来自已批准的提案,也可以是直接关联到该想法的快速任务(Quick Task),或两者都有。

状态含义推动前进的动作
open已创建但尚未有人接手。有人认领该想法,或智能体开始细化 → elaborating。
elaborating需求细化进行中:智能体分轮次提出澄清问题,你逐一作答。细化完成(所有问题已回答,或跳过细化)→ elaborated。
elaborated存储状态的终态。双方理解已确认,想法可以进入提案阶段。无进一步的存储状态转移。此后的进展均为派生(见下文)。

想法到达 elaborated 后(或者更早,只要已有快速任务关联到它),Chorus 会根据其关联提案和任务的状态,为看板计算一个展示状态。 想法不存储 completed 或 closed 状态,也无法直接设置想法的状态;它只会随着 需求细化和下游工作的推进而间接改变。

派生标签适用情形
规划中已细化完成,但尚无已提交的提案(没有提案,或提案还是草稿),也没有关联的快速任务。
审批提案提案已提交,正等待你审核。
开发中提案已批准,或有快速任务关联到该想法,且其中至少一个任务尚未完成。
验收成果至少有一个任务已提交验证。
已完成已批准提案的任务和关联的快速任务都已到达 done(或 closed)。

当有快速任务关联到想法时,无论想法存储的状态是什么,派生标签都按这些任务与已批准提案任务的并集计算。 不过,仍有待回答的细化问题时先显示回答问题,已提交的提案仍先显示审批提案,之后才看任务。 关联或取消关联快速任务都不会改变想法存储的状态。主题想法不能直接关联快速任务;主题的进度由其子想法汇总而来。

提案是一个审核容器。它承载智能体准备好的文档草稿和任务草稿;批准提案会把这些草稿 转为真实的文档与任务。

状态含义推动前进的动作
draft编写与编辑中。只有在 draft 状态下才能新增或修改草稿。作者提交审核 → pending。
pending已提交,等待审核者。审核者批准 → approved,或拒绝 → 退回 draft(附审核备注)。
approved已接受。其文档草稿和任务草稿被转为真实的文档与任务。审核流程的终态。
closed已撤回或废弃。由它创建的任务会被关闭。终态。

被拒绝的提案会退回 draft,作者可据此修订后重新提交;审核者的备注会作为修订参考保留。 只有 draft 或 closed 状态的提案才能删除。

任务承载单个工作单元,经历执行与验证。

状态含义推动前进的动作
open未认领、可领取。有人认领或被指派该任务 → assigned。
assigned已有负责人但尚未开始。负责人开始工作 → in_progress(仅当所有依赖均已解除)。
in_progress正在进行。负责人提交 → to_verify。
to_verify工作完成、证据已提交,等待验证。验证者接受 → done,或打回 → in_progress。
done已验证并完成。正常流程的终态。
closed已取消,例如其提案被撤回时。终态。

任务之间可以相互依赖,构成一个有向无环图。只有当上游任务到达 done 后,依赖它的下游任务 才会解除阻塞(上游为 closed 同样视为已解除)。在此之前,下游任务无法进入 in_progress。 若把任务从 to_verify 移出到 done 以外的任何状态,会重置其验收标准。你可以在 项目资源图谱中查看这些依赖连线,并在任务页面的 DAG 视图中添加或编辑它们(见执行任务)。