Task Management — 任务看板、状态机与依赖编排
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 的产物,顺序就错了。动手建批任务前先把依赖图画清楚,独立任务并行、依赖任务串行(viablocked_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. 完整示例
- 建需求:「竞品调研」,写清目标与验收标准,人工批准。
- 建任务 A:基于该需求建「扫描竞品并输出竞争分析报告」,指派调研 Agent 为 assignee、质检为 reviewer。
- 拆子任务:扫描竞品 → 写竞争分析 → 起草市场策略,串成验收节奏。
- 建依赖:若后续「进入市场策略」任务依赖报告产出,把任务 A 的 ID 放进它的
blocked_by。 - 看板跟踪:pending → in_progress → review → completed,全程可审计。
- 拿结果:从任务详情查看交付物,验收通过即为可验收成果。
7. 接下来
- 何时用对话、何时必须开任务 → Conversation 对话与任务。
- 多 Agent 并行 / A2A / 跨团队协作 → Multi-Agent 多 Agent 协作。
- 交付物与 deliverable 卡片 → Results 结果查看。
- 数字资产(Agent/Team/Skill)与任务的关系 → Assets 数字资产。