关于 to-prd
to-prd 是一项将对话上下文和代码库理解整理为 PRD,并发布到项目问题跟踪器的技能。它按模板组织需求、实现与测试决策,并添加分诊标签。
主要功能
- 01基于现有上下文综合内容,不进行访谈
- 02探索代码库与设计决策
- 03梳理模块并确认预期
- 04按指定模板生成 PRD
- 05添加 needs-triage 标签并发布
适用场景
- 01根据持续进行的讨论起草功能 PRD
- 02记录模块与测试决策
- 03将提案提交至问题跟踪器分诊
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mphinance/ alpha-skills --skill to-prd安装后在 Claude Code 中输入/to-prd确认已加载。
附带文件README.md
详细介绍
这项技能会结合当前对话上下文和对代码库的理解来编写 PRD。不要采访用户——只需综合你已经了解的信息。
问题跟踪工具和分类标签的词汇表应该已经提供给你;如果没有,请运行 /setup-matt-pocock-skills。
流程
-
探索代码库,了解代码库的当前状态(如果你还没有这么做)。在整个 PRD 中使用项目的领域词汇表,并遵循你要修改部分的 ADR。
-
梳理完成实现所需构建或修改的主要模块。积极寻找提取深层模块的机会,以便单独测试。
深层模块(相对于浅层模块而言)是指封装了大量功能、提供简单且可测试的接口,并且很少变更的模块。
确认这些模块是否符合用户的预期。确认用户希望为哪些模块编写测试。
- 使用以下模板编写 PRD,然后将其发布到项目的问题跟踪工具。应用
needs-triage分类标签,使其进入常规分类流程。
问题陈述
从用户的角度描述他们面临的问题。
解决方案
从用户的角度描述问题的解决方案。
用户故事
一份内容详尽、编号排列的用户故事列表。每条用户故事都应采用以下格式:
- 作为一名 <角色>,我希望拥有 <功能>,以便 <收益>
这份用户故事列表应尽可能详尽,并涵盖该功能的所有方面。
实现决策
列出已做出的实现决策,包括:
- 将构建或修改的模块
- 将修改的模块接口
- 开发者提供的技术澄清
- 架构决策
- 架构变更
- API 契约
- 具体交互方式
不要包含具体文件路径或代码片段。它们很快就可能过时。
测试决策
列出已做出的测试决策,包括:
- 对优质测试的描述(只测试外部行为,不测试实现细节)
- 将接受测试的模块
- 测试的先例(即代码库中类似类型的测试)
范围之外
描述本 PRD 范围之外的事项。
补充说明
有关此功能的其他说明。
评论
支持 Markdown