---
name: task
description: 任务状态机规范——定义任务状态、合法流转、角色→操作权限、门禁、人拍板点。agent 处理任务时据此操作，LLM 读本 skill 判断流转合法性。产线默认 SDLC 状态机，项目可同名覆盖。触发：认领/提交/审核/退回/完成/重试任务。
---

# 任务状态机规范

本 skill 是**规范**（任务状态 + 流转规则 + 角色权限）。任务操作由系统固化的 **task 能力**（工具）执行，
本 skill 描述这些工具该怎么用、什么时候能用。

## 一、核心模型

- 任务 = 一个概念的实例，沿状态机流转。
- **状态存表**（pipeline_tasks.state），**流转规则在本 skill**（LLM 读后判断合法性）。
- 工具只做 CAS 原子迁移（`WHERE state=from`），**不校验合法性**——合法性由你读本 skill 判断。
- 每次迁移自动写审计（audit_log，append-only）。

## 二、任务状态（SDLC 默认）

| 状态 | 语义 |
|---|---|
| submitted | 待认领（新任务 / 被退回后重新认领） |
| running | 角色 agent 执行中 |
| review | 已提交产出，待审核 |
| approved | 审核通过 |
| completed | 全流程完成 |
| waiting | 挂起等回答（提问未答复） |
| failed | 失败 |

## 三、合法流转图

```
submitted ──claim──▶ running ──submit──▶ review ──approve──▶ approved ──complete──▶ completed
    ▲                   │                    │                                     (最后一角色)
    │                   │ suspend            │ reject
    │                   ▼                    ▼
    │                waiting ──revive──▶ submitted
    │                   ▲
    └──retry────────── failed ◀──(任意状态执行失败)── running
```

明确规则：
- `claim`：submitted → running，仅认领自己角色的任务（claimed_by 原子，防并发）。
- `submit`：running → review，产出交付件后提交。
- `approve`：review → approved（仅审核角色）。
- `reject`：review → submitted，附退回意见，被退角色重新认领响应。
- `complete`：approved → completed（最后一个角色完成后）。
- `suspend`/`revive`：提问挂起 / 回答后恢复认领。
- `fail`/`retry`：执行失败 / 重试。

## 四、角色 → 操作权限（业务级 RBAC）

| 角色 | 可执行操作 |
|---|---|
| agent.requirement / agent.design / agent.develop / agent.test / agent.deploy | claim、submit |
| agent.pm | approve、reject、complete |
| agent.main_agent | 问题路由、答复（见 team-communication） |
| owner.superuser（人，RBAC orgtype.role） | 最终确认、审批兜底 |

## 五、门禁

- review 通过：交付件满足需求规格。
- review 退回：附意见，任务回 submitted，被退角色重新认领。
- 最后一角色（agent.deploy）approve 后 complete。

## 六、人拍板点（human gate）

需要人审批/确认时，**不直接改状态**，而是走问题冒泡到 `owner.superuser`（见 team-communication skill，
problem_type 用 approval/confirm）。人答复后由 agent 再执行状态迁移。

## 七、配套能力（task 能力工具）

`claim_task` / `submit_task` / `approve_task` / `reject_task` / `complete_task` /
`mark_failed` / `retry_task` / `suspend_task` / `revive_task` / `set_task_state`（通用 CAS 兜底）。

## 八、分层覆盖

本 skill 是产线默认（SDLC 状态机）；项目可放**同名 task skill** 覆盖：简化/扩展状态机、改角色权限。
加载顺序：项目级 → 产线级 → 全局兜底。