Task Management — 任务看板、状态机与依赖编排

English · ← 回到分类

Markus 的任务(Task)系统是平台「干活」的核心:需求(Requirement)→ 任务(Task)→ 看板(Kanban)构成完整工作循环。本页详解任务管理的三个支柱:看板可视化、状态机生命周期、blocked_by 依赖编排,以及贯穿其中的审查治理。创建任务的完整入门流程见 Create-Task。


1. 概念速览

概念说明
需求(Requirement)工作的正式治理声明,是所有顶层任务的门禁——必须先有已批准的需求才能建任务
任务(Task)一个可交付、可验收的工作单元,挂到某个已批准需求与项目(tsk_…)
看板(Kanban)Tasks 页用状态列可视化任务进度与流转
子任务(Subtask)把复杂任务拆成可验证小步(sub_…),无独立审查
交付物(Deliverable)任务产出、注册到结果区的资产(dlv_…),详见 Results 结果查看

2. 状态机(State Machine)

任务是核心工作单元,生命周期由明确的状态转移驱动。Tasks 页看板按状态列展示:

pending → assigned → in_progress → review → revision → accepted → completed → archived
状态含义谁进入
pending已创建、等待批准所有新任务创建后进入;不是活跃工作,不会自行推进
assigned已被指派、等待启动任务被批准并指派后
in_progress执行中assignee 实际开始干活
review提交审查、等待验收assignee 调用 task_submit_review 后
revision评审打回、要求修改reviewer 拒绝并附反馈后回到执行
accepted评审通过reviewer 接受
completed完成归档入口reviewer 批准后
archived归档手动归档保留审计轨迹

红线:worker 绝不自评自己的任务是「已完成」(只有 reviewer 能);pending / blocked 的任务不会自行推进;被拆解的任务要全部子任务完成或取消才能提交审查。

状态转移的归属权(谁拥有哪一步):

requirement(人工批准)
  → task pending(等 UI 批准——不是活跃工作)
  → in_progress(assignee 执行)
  → review(assignee 调 task_submit_review)
  → completed(reviewer 批准)| 或回到 in_progress(reviewer 打回附反馈)
  → blocked(依赖未满足)| failed | cancelled

治理动作(任务详情里):Submit for Review(提交审查)、Accept(接受)、Request Revision(请求修改)、Archive(归档)、以及人类手动任务的 Start Execution。


3. 依赖编排(blocked_by)

blocked_by 是多任务编排的骨干:

  • 独立任务 → 看板里并行执行。
  • 有 blocked_by 的任务 → 会等前置任务完成后才启动。
任务 A(无依赖)──────────→ 并行
任务 B(依赖 A 的产物)
   blocked_by: [A 的任务 ID] → 等 A 完成再启动

编排原则:若任务 B 依赖任务 A 的输出,就必须把 A 的任务 ID 放进 B 的 blocked_by——漏掉的话系统会并行执行、B 拿不到 A 的产物,顺序就错了。动手建批任务前先把依赖图画清楚,独立任务并行、依赖任务串行(via blocked_by),编排才能正确。

创建任务必须补齐字段(缺了会被拒绝):

  • 标题 / 描述:用自然语言讲清要交付什么。
  • assigned_agent_id(被指派者):谁执行。
  • reviewer_id(评审者):谁验收(不能与 assignee 是同一 Agent)。
  • requirement_id / project_id:挂到已批准需求与项目。
  • blocked_by(依赖):被依赖任务的任务 ID 列表。

4. 子任务拆分(Subtask)

复杂任务在动手前先用 subtask_create 拆成多个「可测试断言」的小步——每个子任务是一个 「完成」的可验证断言:

  • 系统强制执行:只要有子任务仍为 pending,就不能提交审查。
  • 建议把「合同(满足哪些才算 done)」用子任务定义清楚,VERIFY 阶段逐条核验。
  • 子任务完成用 subtask_complete,不再适用的用 subtask_cancel(需说明原因)。

5. 审查即门禁

任务流转到 review 由 reviewer 验收,这是质量门禁:

  • 执行方只能 task_submit_review,不是 completed。
  • reviewer 批准 → 自动 completed;打回 → 自动回到 in_progress 并附反馈,执行方据此返工。
  • 子任务未清、验收标准(acceptance criteria)未满足、存在已知失败,都不能盲目提交。

互审机制详见 Review 评审。


6. 完整示例

  1. 建需求:「竞品调研」,写清目标与验收标准,人工批准。
  2. 建任务 A:基于该需求建「扫描竞品并输出竞争分析报告」,指派调研 Agent 为 assignee、质检为 reviewer。
  3. 拆子任务:扫描竞品 → 写竞争分析 → 起草市场策略,串成验收节奏。
  4. 建依赖:若后续「进入市场策略」任务依赖报告产出,把任务 A 的 ID 放进它的 blocked_by。
  5. 看板跟踪:pending → in_progress → review → completed,全程可审计。
  6. 拿结果:从任务详情查看交付物,验收通过即为可验收成果。

7. 接下来