SuperAPI AI 工具集

task-management-protocol

智能体与模型

查看项目

更新于 10-16 07:25

技能介绍

用途:为使用 Claude Code 原生任务工具的智能体提供标准化协议,解决后台智能体完成工作后主会话收不到通知、任务描述不更新、会话或智能体之间缺乏结构化上下文交接等问题。

主要能力:围绕 TaskList()、TaskGet(id)、TaskCreate(...)、TaskUpdate(...) 四个工具组织流程。会话开始时先 TaskList() 查看已有任务,再用 TaskGet 读取详情,并以 TaskUpdate 将状态置为 in_progress 认领任务;执行中在发现信息、遇到阻塞、识别子任务或取得进展时更新 description 与 metadata;完成时必须附带 summary、filesModified、completedAt 等结构化元数据,并再次 TaskList() 检查新解除阻塞的任务;会话结束前用 sessionPaused、currentState、immediateNextStep 等字段记录交接信息。

计划文件更新:当任务属于 .claude/context/plans/*.md 计划文件时,由执行智能体而非路由方负责更新标记,开始时将 - [ ] 改为 - [~],完成时改为 - [x] 并追加一行结果说明,使用 Edit 修改具体行,且在调用 TaskUpdate(completed) 之前完成;计划文件不存在则静默跳过。可用 grep -n "task subject keywords" .claude/context/plans/my-plan.md 定位行号。

跨会话协调:通过环境变量 CLAUDE_CODE_TASK_LIST_ID 共享任务列表,例如 export CLAUDE_CODE_TASK_LIST_ID="my-project-tasks" 后启动 claude,适用于多终端、后台智能体或团队协作场景。

限制与约束:协议要求不得在无结构化元数据时标记完成,不得跳过 in_progress 认领,不得在完成后不检查 TaskList,不得把结构化数据写进 description 散文,发现信息须即时更新而非事后补记。任务元数据与 Memory Protocol 互补但不替代,项目级模式与架构决策仍应写入记忆文件。资料未提供具体收费、价格或平台支持范围等信息。