SuperAPI AI 工具集

taskmaster

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:Taskmaster 是 Codex 多步骤工作的默认执行协议,v5 在 Debug-First 核心上扩展出三种任务形态,用于组织、执行与恢复复杂工作。

主要能力:

  1. 单任务(Single Task):一个交付物、共享上下文。分 Compact Single(仅项目根 TODO.csv,状态 TODO|IN_PROGRESS|DONE,适合短小线性任务)与 Full Single(.codex-tasks/<task-name>/ 下含 SPEC.md、TODO.csv、PROGRESS.md、raw/,状态含 FAILED,适合代码改动与长任务)。
  2. 史诗任务(Epic Task):多交付物或依赖链,文件为 EPIC.md、SUBTASKS.csv、PROGRESS.md 及 tasks/<child-task>/;子任务在 SUBTASKS.csv 登记 task_type、dependencies、task_dir,depends_on 用分号列多个依赖,全部子任务 DONE 且最终验证通过才关闭。
  3. 批处理任务(Batch Task):同构行级工作,通过 spawn_agents_on_csv 执行,文件含 SPEC.md、TODO.csv、PROGRESS.md、batch/BATCH.md、workers-input.csv、workers-output.csv、raw/。

核心原则:磁盘上的当前事实产物优先于记忆;任何步骤、子任务或批处理行未经显式验证不得标记 DONE;冗长推理写入 PROGRESS.md、EPIC.md 或批处理输出文件而非聊天;失败保持可见,不静默降级为手动或串行;规划 CSV 与批处理 worker CSV 分开;冷启动仅凭文件即可恢复。

使用方式:按形态路由选择——单一交付物用 Single;一个 TODO.csv 出现阶段、子项目或独立交付物时升级为 Epic;仅当行相互独立、共享同一指令模板且成功可表达为结构化输出字段时用 Batch。批处理需定义 instruction template、id_column、output_schema、max_workers、max_runtime_seconds、output_csv_path,并用 spawn_agents_on_csv 运行,检查 workers-output.csv 后合并结果。支持中途形态升级(Single→Epic、步骤→Batch)。恢复时读取最小产物集,恢复消息须含任务、形态、进度、当前、文件、下一步。状态更新须含任务、形态、进度、当前、验证、文件。

限制:Batch 不适用于异构角色、跨行依赖或共享写入范围;异构工作应使用专门的多智能体流程;重试达 5 次需显式改变策略或升级形态;仅当验证无法自动化时才用 echo SKIP 并记录原因。具体模板与示例见资料所列参考文件。