SuperAPI AI 工具集

task-planning

编程与开发

查看项目

更新于 10-15 17:21

技能介绍

用途:将规格说明与实现计划转化为可执行、按依赖排序的任务,指导系统化实现。适用时机包括把规格转为实现任务、规划功能实现顺序、识别可并行执行的机会、把复杂功能拆分为多个阶段。不适用于编写规格,编写规格应使用 spec-writing。

主要能力:任务采用 5 阶段结构——阶段 0 设置(项目初始化、依赖、配置)、阶段 1 基础(数据模型、接口、测试基础设施)、阶段 2 核心实现(业务逻辑、API、服务)、阶段 3 集成(外部服务、中间件、日志)、阶段 4 打磨(优化、文档、最终测试)。每个任务包含 ID(如 TASK-001)、描述、所属阶段、依赖、并行标记 [P]、涉及文件路径和完成标准。

依赖规则:依赖决定执行顺序并识别并行机会;存在依赖时须严格按序执行;仅当满足全部非冲突条件时才可标记 [P] 并行执行,条件包括文件无重叠、无共享配置或全局状态、前置依赖已满足、不可能产生合并冲突、任务之间不依赖彼此输出。影响相同文件的任务必须串行。

使用方式:在规格完成后调用,输出任务清单;示例任务条目包含阶段、任务 ID、依赖、文件与完成标准,可用 pytest -v 等命令验证测试通过。

限制与退出标准:每个任务须有唯一 TASK-NNN 格式 ID 及描述、阶段(0-4)、依赖列表、并行标记、文件和标准字段;标记 [P] 的任务须通过全部 5 项非冲突条件;源规格中的每项功能需求须至少映射到一个任务,未映射需求需标记;同一阶段内任务排序不得依赖编号更大的任务。详细阶段定义、依赖模式与验证规则见模块文档。相关技能包括 spec-writing 和 speckit-orchestrator。