关于 write-a-prd
write-a-prd 是帮助开发者围绕需求访谈、梳理代码库并编写产品需求文档的技能。它引导用户逐项澄清方案与模块设计,最后将 PRD 写入本地 Markdown 文件。
主要功能
- 01访谈用户以明确问题与方案
- 02检查代码库现状
- 03逐项澄清设计决策
- 04梳理待构建或修改的模块
- 05按模板生成本地 PRD
适用场景
- 01为新功能明确需求和解决方案
- 02规划需要修改的代码模块
- 03记录用户故事、实现与测试决策
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mattpocock/ ai-engineer-workshop-2026-project --skill write-a-prd安装后在 Claude Code 中输入/write-a-prd确认已加载。
详细介绍
当用户想要创建 PRD 时,将调用此技能。如果你认为某些步骤没有必要,可以跳过。
-
请用户详细描述他们想要解决的问题以及任何潜在的解决方案想法。
-
探索代码仓库,验证用户的说法并了解代码库的当前状态。
-
就计划的各个方面反复询问用户,直到双方达成共识。逐一梳理设计树上的每个分支,并逐项理清决策之间的依赖关系。
-
勾勒出完成实现所需构建或修改的主要模块。积极寻找提取深模块的机会,以便单独测试。
深模块(相对于浅模块而言)是指封装了大量功能,同时提供简单、可测试且很少变更的接口的模块。
请用户确认这些模块是否符合他们的预期,并确认希望为哪些模块编写测试。
- 完全理解问题和解决方案后,使用以下模板编写 PRD。PRD 应保存为本地 Markdown 文件
issues/prd.md。如果issues/目录不存在,请创建该目录。不要提交 GitHub issue,也不要调用任何外部服务。
问题陈述
从用户角度描述用户遇到的问题。
解决方案
从用户角度描述问题的解决方案。
用户故事
一份篇幅很长、带编号的用户故事列表。每个用户故事的格式如下:
- 作为一名 <角色>,我希望 <功能>,以便 <收益>
这份用户故事列表应尽可能详尽,并涵盖该功能的所有方面。
实现决策
列出已做出的实现决策,包括:
- 要构建或修改的模块
- 要修改的模块接口
- 开发人员提供的技术说明
- 架构决策
- 架构变更
- API 契约
- 具体交互方式
不要包含具体文件路径或代码片段。这些内容很快就可能过时。
测试决策
列出已做出的测试决策,包括:
- 优秀测试的标准(只测试外部行为,不测试实现细节)
- 将接受测试的模块
- 测试方面的先例(即代码库中类似类型的测试)
范围之外
说明不属于此 PRD 范围的事项。
进一步说明
有关此功能的其他说明。
评论
支持 Markdown