SuperAPI AI 工具集

create-tasks

编程与开发

查看项目

更新于 10-15 20:27

技能介绍

用途:将需求文档拆解为可独立实现的任务文件,并结合代码库探索进行补充。

必要输入:功能名称,用于定位 tasks/prd-<name>/ 目录;该目录中至少有 _prd.md 或 _techspec.md。

工作流程:读取 _prd.md、_techspec.md 以及 adrs/ 中已有 ADR;缺少 _techspec.md 时警告并继续,两者都缺失则停止并要求用户先创建至少一个。随后通过 Agent 工具调用探索代码库,查找需创建或修改的文件、测试模式与编码约定。

任务拆解:把 TechSpec 的实现部分拆成细粒度、可独立实现的任务,每个任务包含标题、领域、类型、范围、复杂度和依赖;若任务直接实现或受特定 ADR 约束,在 Implementation Details 的 Related ADRs 中引用;测试要求嵌入每个任务,不单独创建仅用于测试的任务;结构参考 references/task-template.md,元数据字段参考 references/task-context-schema.md。

交互审批:展示所有任务的标题、描述、复杂度与依赖链,等待用户反馈;用户要求修改则修订后再次展示,直到明确批准。

生成文件:写入 tasks.md 作为主任务列表,包含所有任务标题、状态与依赖;写入 task_01.md 至 task_N.md 单个任务文件,使用 task 前缀且无前导下划线;每个文件以 ## status: pending 开头,后接 <task_context> 元数据块;编号需与 _tasks.md 一致。

补充任务文件:若某文件已有 ## Overview、## Deliverables 和 ## Tests,则跳过;否则映射 PRD 需求与 TechSpec 指导,通过 Agent 工具调用发现相关文件、依赖文件、集成点与项目规则,填充模板各节,包括 Overview、Requirements、Subtasks、Implementation Details、Relevant Files and Dependent Files、Deliverables、Tests、Success Criteria,并根据探索结果重新评估复杂度。

错误处理:两者都缺失时停止;用户拒绝拆解时纳入全部反馈后再展示;代码库探索发现范围与 TechSpec 不符时记录差异并询问用户;目标目录不存在则创建;任务文件已完整补充则跳过。