yumoqing
5f754a8f61
- task skill: 任务状态/合法流转/角色→操作权限(业务级RBAC)/门禁/人拍板点，配套 task 能力工具
- team-communication: 角色统一规范名 agent.{role}(agent角色) + {orgtype}.{role}(人角色)，
SDLC 默认人角色=owner.superuser，新增 approval 问题类型(human gate)
3.6 KiB
3.6 KiB
| name | description |
|---|---|
| task | 任务状态机规范——定义任务状态、合法流转、角色→操作权限、门禁、人拍板点。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 覆盖：简化/扩展状态机、改角色权限。 加载顺序：项目级 → 产线级 → 全局兜底。