SuperAPI AI 工具集

todo-worker

通用与其它

查看项目

更新于 10-15 23:32

技能介绍

用途:从项目根目录的 TODO.md 中按优先级和依赖关系挑选下一个可执行任务,原子性地标记为进行中([~]),然后开始执行。仅限显式调用,不会主动触发。

TODO.md 格式约定:任务行格式为 - [STATE] [PRIORITY] [ID] (dep: ID1,ID2) Title text。STATE 取值 [ ](待办)、~(进行中)、x(完成)、!(阻塞);PRIORITY 为 P0/P1/P2;ID 为 T 加数字且项目内唯一;dep 为逗号分隔的 ID,无依赖时省略。项目若不符合该格式需先采用或迁移,仅有状态标记不足以支持依赖感知的挑选。

执行流程:读取并解析 TODO.md 每行任务;筛选 state 为 [ ] 且所有依赖任务均为 [x] 的任务,按优先级(P0<P1<P2)再按 ID 升序排序取第一条,若无合格任务则报告并停止;立即将匹配行由 [ ] 改写为 [~] 并写回,以缩小与其他会话的竞争窗口;以简洁格式报告候选任务及依赖与解锁情况,并询问是否开始(y 继续、skip 还原后重新挑选、n 还原并停止);执行时依据标题推断所需子技能、脚本或工具,若项目提供 .claude/todo-worker-config.md 等映射则读取,不明确时询问用户而非猜测;完成后成功写 [x] 并附一行 > done 日期与结果,阻塞或失败写 [!] 并附 > blocked 日期与原因。

跨会话协调:TODO.md 是唯一事实来源,不使用锁文件;候选已是 [~] 则跳过;用户指定接管某任务时直接执行。

不适用场景:用户表示想先思考、正在编码或调试中、仅询问 TODO 内容时不应调用。项目级定制(任务 ID 到子技能的映射、日期格式、策略文档交叉引用)放在项目自身配置中,技能本体保持通用。