SuperAPI AI 工具集

task-management

智能体与模型

查看项目

更新于 10-15 19:52

技能介绍

用途:这是 AgentTeams 中面向 Worker 的任务管理技能,规定 Worker 只执行被分配的任务,并在调用 taskflow 或进入被分配任务流程前使用,包括读取任务状态、确认任务、执行任务、跟踪进度和提交结果。

目录约定:任务相关工作都放在 shared/tasks/{task-id}/ 下。协调者创建 spec.md、meta.json 和 base/;Worker 拥有 workspace/、progress/ 和交付物。result.md 与 meta.json 由 taskflow 管理,不要手工编辑,结果通过 taskflow 的 action=submit_task 提交,由它写入标准 result.md。私有计划笔记放在 workspace/ 下,不要创建任务级 plan.md;未经 spec 明确要求,不要编辑项目级 shared/projects/{project-id}/plan.md 或 meta.json。

执行流程:先在当前房间直接说明已收到消息,再用 taskflow 确认任务,调用 {"action":"ack_task","payload":{"taskId":"{task-id}"}},响应中的 spec 字段即完整任务说明,无需另行 read_file。meta.json.room_id 是任务的分配与交付房间,仅在确需跨房间交付时使用;缺失时应停止并在当前会话报告阻塞,不要猜测其他房间。执行时把交付物保留在 shared/tasks/{task-id}/ 内。

提交:用 taskflow 提交结果,调用 {"action":"submit_task","payload":{"taskId":"{task-id}","status":"SUCCESS","summary":"<one paragraph summary>","deliverables":["shared/tasks/{task-id}/workspace/<file>"]}},它会写入 result.md、标记本地状态为 submitted、推送任务目录并校验 result.md 存在。状态可用 SUCCESS、SUCCESS_WITH_NOTES、REVISION_NEEDED 或 BLOCKED。提交后该 Worker 任务结束;若需继续,等待协调者分配新任务,不要自行恢复或改写已提交任务。完成后在当前房间 @ 协调者:@coordinator:domain TASK_COMPLETED: {task-id} - <short outcome>. Result: shared/tasks/{task-id}/result.md。

阻塞与进度:阻塞时提交 status=BLOCKED、deliverables 为空的结果,并 @ 协调者报告阻塞原因;不要编造缺失的任务文件、项目计划或共享目录。进度笔记可选,除非 spec 要求;如需记录,放在 shared/tasks/{task-id}/progress/YYYY-MM-DD.md,无需决策的进度更新不必 @ 任何人。

限制:ack_task 与 submit_task 仅在 Matrix 身份与 meta.json.assigned_to 匹配时成功;若提示任务已分配给他人,应停止并向协调者报告分配不匹配。不要查找 Worker 个人房间或私有房间作为回退,任务目录才是事实来源。