managing-tasks

管理任务

概览

使用持久化任务文件夹（plan.md、status.md）实现跨会话 Agent 交接。操作规则由配方负责；assets/ 是可复制的骨架；task-contract.md 是系统基础设施；创建后，磁盘上的计划和状态即为运行时事实。

Agent 工作流

每次在 <tasks-root>/NNN-slug/ 下执行任务生命周期操作时，都遵循此技能。只要 Agent 能读取和写入仓库文件，即可使用。

任务根目录： 使用静态 作者签名 UUID，通过 <tasks-root>/index.md 定位。如果不存在，请向用户询问一个空文件夹路径，然后进行初始化。参见 task-contract.md → 解析任务根目录。

状态： Not Started、In Progress、Blocked、Done、Cancelled。如果只剩验证工作，状态保持为 In Progress，并设置 next_step_id: verify。Done 和 Cancelled 状态的任务会自动移至 archives/。

匹配一行配方；只打开对应的参考文档。

配方

意图	示例表述	阅读
创建	“创建一个任务：…”，“将……规划为任务”，“新建任务”	creating-task.md
创建多个任务	“为……创建任务”，“规划任务：……”，“将此拆分为多个任务”	creating-multiple-tasks.md
执行	“继续 tasks/001-…”，“继续深色模式任务”，“执行下一步”，“验证 / 标记为完成”	executing-task.md
执行多个任务	“完成所有任务”，“处理待办事项”，“持续执行，直到没有可用任务”，@-提及没有指定文件夹的任务根目录	executing-multiple-tasks.md
分类 / 检查	“tasks/003-… 的状态”，“列出所有任务”，“我可以开始什么？”，“有哪些任务已解除阻塞？”，“任务路线图”	triaging-tasks.md
更新	“更新任务范围”，“为 tasks/003-… 添加一个阶段”，“重新规划”	updating-task.md
阻塞 / 解除阻塞	“阻塞此任务”，“等待设计评审”，“解除 tasks/002-… 的阻塞”，“依赖项已解决”	blocking-task.md
取消	“取消任务”，“放弃 tasks/005-…”，“停止此任务”	cancelling-task.md

参考索引

契约

task-contract.md — 解析根目录、布局、状态、自动归档、解析依赖项、发现任务、任务 Agent 根目录。

文档	使用时机
task-contract.md	任务根目录标记、布局、前置元数据、状态、自动归档、Depends on、发现任务、任务 Agent 根目录
creating-task.md	新建任务文件夹；仅规划
creating-multiple-tasks.md	通过 task-planner 创建多个新文件夹
executing-task.md	为一个文件夹执行 next_step_id；完成后验证并归档
executing-multiple-tasks.md	先通过 task-triager 分类，再通过 task-implementer 执行待办事项循环
triaging-tasks.md	状态报告、就绪情况报告或执行路线图
finding-task-agents.md	根据现有任务 Agent 决定是否进行编排
creating-task-agents.md	根据用户调用创建 / 刷新任务 Agent
updating-task.md	修改 plan.md 并同步 status.md
blocking-task.md	标记为阻塞或清除阻塞项
cancelling-task.md	取消并自动归档

Templates

• assets/index.md
• assets/plan.md
• assets/status.md
• assets/agents/task-planner.md
• assets/agents/task-triager.md
• assets/agents/task-implementer.md