关于 to-prd
to-prd 会根据现有对话和代码库信息生成产品需求文档,并引导规划模块、确认测试决策,再将文档发布到项目问题跟踪器。
主要功能
- 01基于现有上下文综合内容
- 02探索代码库与领域规范
- 03规划模块和测试覆盖
- 04编写详尽的用户故事
- 05添加分类标签并发布 PRD
适用场景
- 01从项目讨论起草需求
- 02规划功能模块与测试
- 03记录实现和测试决策
- 04向问题跟踪器发布功能 PRD
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ polya20/ grill-me --skill to-prd安装后在 Claude Code 中输入/to-prd确认已加载。
详细介绍
此技能会利用当前对话上下文和对代码库的理解来编写 PRD。不要采访用户——只需综合你已掌握的信息。
问题跟踪器和分类标签词汇应该已提供给你;如果没有,请运行 /setup-matt-pocock-skills。
流程
-
如果你还没有了解代码库的当前状态,请探索代码仓库。全文使用项目的领域术语表中的词汇,并遵循你将要修改的部分涉及的任何 ADR。
-
梳理完成实现所需构建或修改的主要模块。积极寻找提取深层模块的机会,以便对其进行独立测试。
深层模块(与浅层模块相对)是指封装大量功能、接口简单且可测试,并且很少变化的模块。
确认这些模块是否符合用户的预期。确认用户希望为哪些模块编写测试。
- 使用下方模板编写 PRD,然后将其发布到项目问题跟踪器。应用
ready-for-agent分类标签——无需额外分类。
问题陈述
从用户的角度描述用户面临的问题。
解决方案
从用户的角度描述问题的解决方案。
用户故事
列出一份内容详尽、编号的用户故事清单。每条用户故事都应采用以下格式:
- 作为一名 <角色>,我希望 <功能>,以便 <收益>
这份用户故事清单应极其详尽,涵盖该功能的所有方面。
实现决策
列出已做出的实现决策,包括:
- 将构建或修改的模块
- 将修改的模块接口
- 开发者提供的技术说明
- 架构决策
- 架构变更
- API 契约
- 具体交互
不要包含具体文件路径或代码片段。它们很快就可能过时。
例外:如果原型生成的代码片段比文字更准确地表达了某项决策(例如状态机、reducer、架构或类型形状),请将其内嵌在相关决策中,并简要说明该片段来自原型。只保留有助于表达决策的部分,不要放入可运行的演示代码。
测试决策
列出已做出的测试决策,包括:
- 优质测试的特征(只测试外部行为,不测试实现细节)
- 将进行测试的模块
- 测试的先例(即代码库中类似的测试)
范围外
描述本 PRD 不涵盖的事项。
补充说明
与该功能相关的其他说明。
评论
支持 Markdown