SuperAPI AI 工具集

prd-to-plan

编程与开发

查看项目

更新于 10-22 12:55

技能介绍

用途

prd-to-plan 用于把一份产品需求文档(PRD)转化为一份可执行的实施计划。它读取 PRD 以及该功能将要构建于其中的代码库,然后写出一个计划文件,让开发者或编码智能体能够从第一次提交一直遵循到最后一次提交。

该计划会点名那些一旦做出就代价高昂、难以逆转的选择,把工作拆分成每个阶段都能让产品处于可运行、可演示状态的多个阶段,并说明每个阶段如何验证。它与工单拆解不同:输出是一份用于顺序推进的单一活文档,与代码放在一起,并随着构建过程中获得的新认知持续更新。

主要能力

  • 建立输入:确认 PRD 的位置(文件、issue 或粘贴文本)、执行者(单个开发者、团队或无人值守的智能体),以及任何固定约束(日期、发布冻结、必须优先支持的平台)。同时确定仓库中计划的存放位置:已有的 plans/、docs/plans/ 或 docs/rfcs/ 目录优先,否则使用根目录下的 plans/。文件按功能以 kebab case 命名,例如 plans/team-invitations.md。
  • 构建需求台账:为每条需求分配 id(R1、R2……),若 PRD 已有编号则沿用。单独列出非目标与开放问题,并对开放问题排序:会改变阶段顺序或形态的问题必须在继续规划前得到回答,其余问题连同负责人和需要该答案的阶段一并写入计划。
  • 阅读功能将触及的代码:记录经打开文件核实的事实,包括同类功能如何进入系统及其分层方式(路由、领域逻辑、存储、接口)、功能扩展的数据模型与所用迁移工具、项目如何测试/检查/类型检查(来自 package.json、Makefile、pyproject.toml 或 CI 配置的真实命令)、未完成工作在生产中如何隐藏(功能开关、设置)以及发布如何进行。对于尚无代码的新项目,此部分说明用户选定的技术栈以及阶段 1 可演示前必须存在的内容。
  • 记录每个阶段所依赖的决策:在切分之前,先确定后续阶段将构建于其上、且变更代价高昂的内容,包括公共契约(路由、事件、命令)、新数据的形态与既有数据的迁移方式、授权规则、与外部服务的边界以及功能如何开启。每个决策写明选择、理由和被否决的替代方案。省略辅助函数名、文件布局等变更代价低的细节。
  • 塑造阶段:每个阶段都以一次演示收尾,合并后人们能做到之前做不到的事(即使仅在开关后)。不能演示的“数据库部分”或“前端部分”应并入跨层的阶段。阶段 1 是主场景中最薄的端到端路径,各层齐备且刻意最小化;后续阶段再扩展:更多用例、失败处理、限制、打磨。按风险排序,再按价值排序,把最可能推翻计划的部分放前面。若未知足够大,阶段 0 是限时探针,其输出是决策而非交付代码。规模上,每个阶段 1 到 3 天工作或 1 到 3 个 PR;典型 PRD 为 3 到 7 个阶段,超过 7 个通常意味着 PRD 覆盖了两个功能。保持主分支可发布,将未完成行为隐藏在项目的开关机制后。变更既有 schema 和契约采用扩展、迁移、收缩:先加新形态,迁移读写方,在后续阶段移除旧形态。标记切分线,说明哪个阶段完成 PRD 所需的最低限度,以便后续阶段可被放弃或推迟而无需重新规划。每个阶段需说明:目标(一句利益相关者能识别的话)、覆盖的需求、构建内容、刻意留待后续的内容、证明完成的检查、验证命令以及主要风险。
  • 写文件前先审阅大纲:展示阶段表(目标、需求、规模、风险),询问用户能快速判断的问题:顺序是否正确、切分线是否在期望位置、是否有阶段过大难以审阅、是否有遗漏。修订后再写文件。
  • 写入计划文件:按以下章节顺序:标题(含来源 PRD)、状态与日期;Requirements(台账表,含覆盖各需求的阶段);Current state;Decisions;Phases;Not planned;Open questions;Change log。在每个阶段中以普通行写 Covers:,以便机械检查覆盖情况。交付前确认:每条需求都被覆盖或列入 Not planned 并附理由;每个阶段至少有一个可人工执行的检查和一个可运行的命令;没有检查依赖后续阶段;没有决策与 PRD 矛盾。
  • 构建期间保持计划最新:阶段完成时设置其状态并勾选检查项。当工作与计划矛盾时,先编辑计划,在变更日志中添加带日期的行说明改了什么及原因,然后继续。

使用方式

该技能以技能形式提供,通过读取 PRD 与代码库、与用户确认输入和约束、构建需求台账、调研代码、记录决策、塑造阶段、审阅大纲、写入计划文件,并在构建过程中持续维护计划来工作。计划文件使用 Markdown 格式,存放在仓库中,按功能命名。

适用场景

  • 需要把一份 PRD 转化为可顺序执行的实施计划。
  • 希望计划与代码放在一起,并随构建过程持续更新。
  • 需要明确难以逆转的决策、阶段划分与验证方式。
  • 由单个开发者、团队或编码智能体执行。

限制

  • 适合一个 PR 就能完成的变更需要的是任务列表,而不是计划文件。
  • 如果用户想要可单独分配、带依赖的工单,应产出 issue;计划仍可作为切分工单的来源。
  • 每个 PRD 只应有一份计划。如果大纲超过七个阶段或涉及两个团队,应建议拆分 PRD,而不是写更长的计划。
  • 不要静默填补 PRD 中的空白:缺失的规则应成为带负责人的开放问题,或成为用户明确批准的决策。
  • 阶段不是分层,也不是日程表。除非用户给出,否则不要附加日历日期;规模用于比较阶段,而非承诺。
  • 无法撤销的 schema 与契约变更(删除列、移除端点)应在新形态已在生产运行后,单独放在靠后的阶段。
  • 检查是观察,不是活动。“端点已实现”证明不了什么;“非管理员得到 403”可以尝试。每个阶段至少需要一个针对失败用例的检查。
  • 命令必须真实。从项目自身的脚本中复制测试、检查和迁移命令,并在写入计划前运行一次。
  • 只规划你能看到的部分。阶段 1 和 2 可完整细化;后续阶段可保留较少细节,待其到来时再修订。