用途:在 docs/task/ 目录中维护一套紧凑、状态更新确定的项目任务系统,可用于单人或多人/多智能体协作。
主要能力:用 docs/task/index.md 保存单行状态条目,用 docs/task/PREFIX-NNN.md 保存详情(描述、负责人、依赖、笔记)。任务 ID 格式为 PREFIX-NNN(大写前缀加三位补零数字),按前缀从 001 起顺序编号,禁止复用或重编号。状态标记:[] 待处理(pending)、[-] 进行中(in_progress)、[x] 已完成(completed)、[~] 关闭/不做(deleted)。优先级 P0 阻塞、P1 高、P2 中、P3 低。支持中英内容,但文件名必须是英文,且单个项目保持单一语言。
使用方式:开始工作前读取 index.md;若标记为 [-] 则打开详情文件查看负责人,若由其他智能体负责则跳过。认领需原子完成:index 标记 [] 改为 [-]、详情状态改为 in_progress 并设置 owner,若有 TaskUpdate 工具则调用 TaskUpdate(status: "in_progress", owner: "<agent>");全部写入成功后才开始实现。完成时 index [-] 改为 [x]、详情改为 completed,并同步工具状态;关闭时改为 [~] 并在笔记中说明原因。若工具不可用,则仅用文件同步并在更新中说明。
适用场景:仓库内需要每个功能或修复都有任务条目、需要在开工前认领以防多智能体冲突、需要立即写状态而非延后同步的项目。
限制与规则:index 仅更新复选框标记,不得删除历史行;详情文件原地更新字段,不删除已有章节;新任务追加到 index 末尾。首次使用时项目需确保 CLAUDE.md 和 AGENTS.md 含 ## Project Task 章节,并初始化 docs/task/index.md。会话语境中需在开始时读取 index 与活跃详情文件,结束时确认状态已持久化并更新 index 头部日期。具体命令、价格、平台支持等信息暂未提供。