SuperAPI AI 工具集

create-prd

写作与研究

查看项目

更新于 10-15 20:27

技能介绍

用途:通过结构化头脑风暴,生成以业务为核心的产品需求文档(PRD),适用于启动新功能或新产品时。

主要能力:确定项目名与工作目录,从功能名派生 slug,使用 tasks/prd-<slug>/ 作为目标目录;若已存在 _prd.md 则进入更新模式;创建 tasks/prd-<slug>/adrs/ 目录。并行调研:一个 Agent 调用探索代码库中的相关模式、现有功能与架构,另一个 Agent 调用执行 3-5 次网络搜索,了解市场趋势、竞品与用户需求,合并结果后再提问。按 references/question-protocol.md 提问,只关注用户需要什么功能、为何有业务价值、目标用户是谁,以及成功标准与约束;不询问数据库、API、框架或架构等技术实现问题;每轮最多 3 个问题,等待回答后再继续,至少完成一轮澄清后才提出方案。提供 2-3 个产品方案及权衡,优先推荐方案并说明理由,等待用户选择。用户选定后创建 ADR:读取 references/adr-template.md,按 adrs/ 目录现有文件确定编号,将选定方案写入 Decision、被拒方案写入 Alternatives Considered、结果写入 Consequences,Status 设为 Accepted,日期为当天,写入 tasks/prd-<slug>/adrs/adr-NNN.md(三位补零)。随后细化方案,确认范围、阶段与成功标准;若出现重大范围决策,再创建额外 ADR。最后读取 references/prd-template.md 生成文档,包含 Architecture Decision Records 章节,列出本次所有 ADR 的编号、标题与一行摘要,写入 tasks/prd-<slug>/_prd.md。PRD 只描述用户能力与业务成果,不涉及数据库、API、代码结构、框架、测试策略或架构决策。

限制:上下文不足时记入 Open Questions 而非猜测;网络调研工具不可用时仅做代码库探索并注明;目标目录无法创建时停止并报告文件系统错误;更新模式下保留用户未要求更改的章节。