--- name: task description: 通用任务概念规范——任务定义、通用生命周期(认领/执行/审核/完成/挂起/失败/重试)、角色操作权限。agent 处理任务时据此操作。产线可用同名 skill 覆盖默认状态机。触发:认领/提交/审核/退回/完成/重试任务,或提到任务、工作项。 capability: task_capability tools: [claim_task, submit_task, approve_task, reject_task, complete_task, mark_failed, retry_task, suspend_task, revive_task, set_task_state] --- # 任务(通用概念) ## 一、概念定义 任务 = 一个**工作单元的执行实例**,沿状态机流转,由某个角色/agent 认领执行、产出交付件、经审核。 状态存表,流转规则在本 skill(LLM 读后判断合法性);工具只做 CAS 原子迁移,不校验合法性。 ## 二、通用生命周期(状态) | 状态 | 语义 | |---|---| | submitted | 待认领(新任务 / 退回后重新认领) | | running | 执行中 | | review | 已提交产出,待审核 | | approved | 审核通过 | | completed | 全流程完成 | | waiting | 挂起等回答 | | failed | 失败 | 通用流转:submitted →(claim)→ running →(submit)→ review →(approve)→ approved →(complete)→ completed; running →(suspend)→ waiting →(revive)→ submitted;任意执行失败 → failed →(retry)→ submitted。 ## 三、与其他概念的关系 - 任务挂项目(tenant_id/project_id)+ 角色(role)。 - 任务产出交付件(deliverable),交付件经评审(review_status)。 - 角色执行中缺信息/被退回 → 提问题(problem,见 problem 概念)冒泡。 ## 四、角色 → 操作权限(业务级 RBAC,通用模式) 执行角色(开发/测试/部署等)认领、提交;审核角色(PM)approve/reject/complete;人角色最终兜底审批。 ## 五、配套能力(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 产线默认状态机见 `pipelines/sdlc_general/common/task`(具体角色:agent.pm 审核、agent.develop 执行等)。项目可用同名 task skill 覆盖。