mcpField
W
write-a-prd

write-a-prd

github.com/mattpocock开发229283 次安装30 周前更新
代码仓库

关于 write-a-prd

write-a-prd 是帮助开发者围绕需求访谈、梳理代码库并编写产品需求文档的技能。它引导用户逐项澄清方案与模块设计,最后将 PRD 写入本地 Markdown 文件。

主要功能

  1. 01访谈用户以明确问题与方案
  2. 02检查代码库现状
  3. 03逐项澄清设计决策
  4. 04梳理待构建或修改的模块
  5. 05按模板生成本地 PRD

适用场景

  1. 01为新功能明确需求和解决方案
  2. 02规划需要修改的代码模块
  3. 03记录用户故事、实现与测试决策

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mattpocock/ai-engineer-workshop-2026-project --skill write-a-prd

安装后在 Claude Code 中输入/write-a-prd确认已加载。

详细介绍

当用户想要创建 PRD 时,将调用此技能。如果你认为某些步骤没有必要,可以跳过。

  1. 请用户详细描述他们想要解决的问题以及任何潜在的解决方案想法。

  2. 探索代码仓库,验证用户的说法并了解代码库的当前状态。

  3. 就计划的各个方面反复询问用户,直到双方达成共识。逐一梳理设计树上的每个分支,并逐项理清决策之间的依赖关系。

  4. 勾勒出完成实现所需构建或修改的主要模块。积极寻找提取深模块的机会,以便单独测试。

深模块(相对于浅模块而言)是指封装了大量功能,同时提供简单、可测试且很少变更的接口的模块。

请用户确认这些模块是否符合他们的预期,并确认希望为哪些模块编写测试。

  1. 完全理解问题和解决方案后,使用以下模板编写 PRD。PRD 应保存为本地 Markdown 文件 issues/prd.md。如果 issues/ 目录不存在,请创建该目录。不要提交 GitHub issue,也不要调用任何外部服务。

问题陈述

从用户角度描述用户遇到的问题。

解决方案

从用户角度描述问题的解决方案。

用户故事

一份篇幅很长、带编号的用户故事列表。每个用户故事的格式如下:

  1. 作为一名 <角色>,我希望 <功能>,以便 <收益>
1. 作为一名手机银行客户,我希望查看账户余额,以便更好地了解自己的支出情况

这份用户故事列表应尽可能详尽,并涵盖该功能的所有方面。

实现决策

列出已做出的实现决策,包括:

  • 要构建或修改的模块
  • 要修改的模块接口
  • 开发人员提供的技术说明
  • 架构决策
  • 架构变更
  • API 契约
  • 具体交互方式

不要包含具体文件路径或代码片段。这些内容很快就可能过时。

测试决策

列出已做出的测试决策,包括:

  • 优秀测试的标准(只测试外部行为,不测试实现细节)
  • 将接受测试的模块
  • 测试方面的先例(即代码库中类似类型的测试)

范围之外

说明不属于此 PRD 范围的事项。

进一步说明

有关此功能的其他说明。

评论

支持 Markdown