W
write-a-prd

write-a-prd

mattpocock
2026-04-06

通过用户访谈、代码库探索和模块设计来创建 PRD,然后作为 GitHub Issue 提交。当用户想要编写 PRD、创建产品需求文档或规划新功能时使用。


简介与核心理念

write-a-prd 技能旨在通过交互式的面试流程,帮助用户系统性地创建产品需求文档(PRD)。它直接解决了功能规划阶段“需求模糊不清、缺乏深度思考”的痛点,通过强迫 AI 对用户进行“无情的提问”、深入探索代码库并在写代码前设计出深层模块,来确保产品方向的正确性。

核心理念

通过无情的用户访谈、深入的代码库探索与深层模块设计,将模糊的想法转化为严谨的产品需求文档(PRD),并最终输出为结构化的 GitHub Issue。

安装与调用指南

https://github.com/mattpocock/skills

工作流程解析 (SOP)

阅读原始 SKILL.md

  • 初始访谈与探索:AI 首先要求用户提供详细的问题描述,随后立即探索代码库,确保用户的想法能够落地于当前的真实架构。
  • 无情的连环追问:指示 AI 必须“无情地采访用户”关于计划的每一个细节。这确保了在早期阶段就能解决决策树上的所有分支和依赖关系。
  • 深层模块设计:在撰写 PRD 之前,AI 会草拟主要的模块结构,并主动寻找能够独立测试的“深层模块(Deep Modules:接口简单但内部封装了大量功能)”。
  • 模板驱动的输出:最终,AI 将使用极其严格的模板输出 PRD(包含问题陈述、解决方案、详尽的用户故事、实施决策、测试决策和非范围内容),并自动作为 GitHub Issue 提交。

技能设计评价

  • 人类经验 SOP 化的亮点:在起草需求之前,要求主动探索代码库并进行模块设计。将实现决策与测试决策分离,符合标准的软件工程实践。
  • 潜在的局限性:对于已经具备明确需求的用户,连续追问的交互方式可能显得冗长。自动将输出格式化为 GitHub Issue 的设定,可能不适用于使用其他项目管理工具的团队。
  • 优质技能的评判标准:禁止在 PRD 中包含特定的文件路径或代码片段,以防止文档快速过时,这体现了对文档维护成本的实际考量。