简介与核心理念
write-a-prd 技能旨在通过交互式的面试流程,帮助用户系统性地创建产品需求文档(PRD)。它直接解决了功能规划阶段“需求模糊不清、缺乏深度思考”的痛点,通过强迫 AI 对用户进行“无情的提问”、深入探索代码库并在写代码前设计出深层模块,来确保产品方向的正确性。
核心理念
通过无情的用户访谈、深入的代码库探索与深层模块设计,将模糊的想法转化为严谨的产品需求文档(PRD),并最终输出为结构化的 GitHub Issue。
安装与调用指南
https://github.com/mattpocock/skills
工作流程解析 (SOP)
- 初始访谈与探索:AI 首先要求用户提供详细的问题描述,随后立即探索代码库,确保用户的想法能够落地于当前的真实架构。
- 无情的连环追问:指示 AI 必须“无情地采访用户”关于计划的每一个细节。这确保了在早期阶段就能解决决策树上的所有分支和依赖关系。
- 深层模块设计:在撰写 PRD 之前,AI 会草拟主要的模块结构,并主动寻找能够独立测试的“深层模块(Deep Modules:接口简单但内部封装了大量功能)”。
- 模板驱动的输出:最终,AI 将使用极其严格的模板输出 PRD(包含问题陈述、解决方案、详尽的用户故事、实施决策、测试决策和非范围内容),并自动作为 GitHub Issue 提交。
技能设计评价
- 人类经验 SOP 化的亮点:在起草需求之前,要求主动探索代码库并进行模块设计。将实现决策与测试决策分离,符合标准的软件工程实践。
- 潜在的局限性:对于已经具备明确需求的用户,连续追问的交互方式可能显得冗长。自动将输出格式化为 GitHub Issue 的设定,可能不适用于使用其他项目管理工具的团队。
- 优质技能的评判标准:禁止在 PRD 中包含特定的文件路径或代码片段,以防止文档快速过时,这体现了对文档维护成本的实际考量。