SuperAPI AI 工具集

prd-todo-slicer

智能体与模型

查看项目

更新于 10-15 13:36

技能介绍

用途

prd-todo-slicer 用于在用户要求把 PRD.md、产品规格、已批准的实施方案或需求文档拆解为实施队列时使用。它只产出规划文件,不实现产品代码,输出一份轻量的 TODO.md 加可选的详细任务简报文件。队列要求小切片、确定性、可审查,并能让一个专注的子代理在不做产品或架构决策的前提下安全执行单个任务。

主要能力

默认输出布局为 TODO.md 加 .planning/ 目录,其中包含 TODO-TRACE.md 和 todos/ 下的逐任务简报(如 P1-T1.md、P1-R1.md、P2-T1.md)。TODO.md 作为队列与状态跟踪器,任务上下文放在 .planning/todos/<id>.md,便于执行者只加载一份简报而无需读取过大的 TODO 文件。若仓库已有不同规划目录,则沿用既有约定。

任务 ID 规则:P<phase>-T<n> 为实现任务,P<phase>-R<n> 为评审任务,P<phase>-V<n> 仅在验证足够复杂时使用,P<phase>-D<n> 为需要用户批准才能实施的阻塞决策任务。阶段表示依赖顺序而非日历时间。

切片标准:单个任务必须能由一个子代理在一次专注运行中完成。任务过大时会按顺序拆分,例如契约与类型、纯校验或状态逻辑、带测试的核心行为、持久化或 IO 边界、适配器或框架集成、UI 或 CLI 界面、错误处理与边界情况、文档或迁移说明、最终评审与验证。

澄清访谈:在写需求、TODO 行、任务简报或追溯关系前,需识别所有可能导致实现代理做出错误产品、架构、API、安全、存储、依赖、UX 或验证决策的模糊点。仅就这些实现风险提问,一次只问一个会影响后续问题的决策,提供推荐答案并标注 (Recommended)。若用户拒绝决定或无法解决,则创建阻塞决策任务,而不是把选择藏进实现任务。

阻塞策略:仅当需要 PRD、已批准方案、当前会话用户指令或强仓库约定未解决的人类级决策时才阻塞。预期文件列表过时、需要改相邻文件、缺少可依既有约定添加的辅助文件、检查失败、已有生成产物可复用等,都应在当前 TODO 内修复,不算阻塞。

生成产物策略:生成产物属于仓库证据,若已有生成或等价的类、类型、接口、夹具、模式等,应复用或适配引用,而非重复创建。

使用方式

所需输入包括:PRD.md 或用户提供的 PRD 路径;.planning/ 中任何已批准的实施方案、架构说明或设计决策文档;现有仓库结构、包管理器、测试、lint、类型检查命令与框架约定;以及已有 TODO 文件以避免重复已完成工作。若 PRD.md 缺失、不可读或与已批准方案矛盾,应停止并报告确切阻塞,不得虚构需求。

规划流程:完整阅读 PRD 并列出来自产品的成果、非目标、约束、用户可见行为、数据/状态需求、集成与验证要求;检查仓库以识别结构、包管理器、语言、测试命令与命名约定;对实现风险模糊点进行澄清访谈并记录决策;把 PRD 需求转为依赖图,先放前置项(项目骨架、schema、类型、状态、核心逻辑、适配器、接口,最后文档);围绕自然关口创建阶段,每阶段以评审任务收尾;创建实现任务、评审任务和决策任务;编写 TODO.md、每任务一份详细简报,以及把 PRD 需求映射到任务 ID 并列出未解决决策的 .planning/TODO-TRACE.md;最后进行规划质量检查,确保没有模糊任务、隐藏决策、重复工作、未验证需求或孤立的 PRD 需求。

TODO.md 需保持轻量,按顺序包含标题、目的说明、状态值、当前进度、操作规则、子代理职责、队列摘要表、详细简报索引、追溯指针。状态词汇仅限 pending、in_progress、blocked、complete。队列摘要表格式为 | ID | Status | Objective | Brief | Verification |,其中 Objective 为一句话,Verification 需列出具体命令或检查项。

每个详细任务简报需自包含,包含状态、类型、阶段、依赖、PRD 引用、方案引用,以及 Objective、Context、Expected files、Required changes、Non-goals、Acceptance criteria、Checks、Report requirements、Blocker policy、Generated artifacts、Review instructions、Stop conditions 等字段。评审任务不得实现新功能范围,只进行检查、运行命令并给出结论。

适用场景

适用于把已批准的产品需求或实施方案拆解为可审查、可交予子代理逐个执行的开发任务队列,尤其适合需要严格依赖顺序、明确验收标准与追溯关系的项目规划场景。

限制

该技能不实现产品代码,只产出规划文件。若 PRD 缺失、不可读或与已批准方案矛盾,须停止并报告,不得虚构需求。未提供关于定价、收费、平台、效果或具体运行环境的信息,暂未提供。