prd-skill

产品经理专用的 Claude Code skill,用于生成和优化 PRD(产品需求文档)。

灵感来自 spec-kit-cn 的 specify 和 clarify 命令,但去除了 git 集成,专为产品经理的 PRD 写作工作流设计。

主要功能: 原始 Prompt 溯源管理

本技能的核心特性是把用户所有原始输入 prompt 作为 PRD 的一部分显式管理。每份 PRD 顶部都有一个 ## 输入历史 (Input History) 章节,按时间顺序逐字保存驱动 PRD 演进的每一次用户输入——包括最初的需求描述、后续澄清的回答、以及每次扩展时的新功能描述。

这样做的好处:

• 评审方便: 评审人不仅能看到 AI 综合解读后的 PRD 正文,还能一眼看到产品经理当时的原话,判断解读是否忠实,发现遗漏或过度引申
• 需求溯源: 每条用户故事/功能需求都能追溯到其背后的原始输入,避免"这条需求是谁拍脑袋加的"式争论
• 只追加日志: 输入历史章节是只追加的——任何模式都不得修改或删除既有条目,即便产品经理后来反悔,也是追加一条新输入说明作废原因,原话永远保留
• 逐字不改写: 用户原话不翻译、不压缩、不润色,错别字和口语化表达都照原样保存,确保审阅时看到的是未经 AI 修饰的真实输入

输入历史与 PRD 的其它章节形成"原话 / 解读"互补:

章节	内容	用途
输入历史 (Input History)	用户原话逐字档案	需求来源凭据,评审时的事实依据
PRD 正文(用户故事 / FR / SC)	AI 基于原话的结构化解读	可执行的交付物
Clarifications	结构化 Q→A 摘要	快速查阅关键决策
Change Log	扩展模式下的变更摘要	追踪 PRD 演进历史

三种模式

• 生成模式: 从一段自然语言功能描述生成一份结构化 PRD(用户故事 + 功能需求 + 可衡量成功标准 + 假设),同时把原始描述落盘到输入历史
• 澄清模式: 审阅已有 PRD,按 10 个维度扫描模糊点,一次一个问题地与你确认,答案直接写回 PRD,每一次问答的用户原始回答同步写入输入历史
• 扩展模式: 向已有 PRD 追加新功能,自动保持术语/编号/优先级一致,维护变更日志,并把新功能描述的用户原话追加到输入历史

安装

在任意 Claude Code 项目中执行:

/plugin marketplace add xu4wang/prd-skill
/plugin install prd@prd-skill

• 第一条命令添加 marketplace(仓库根目录的 .claude-plugin/marketplace.json 会被识别为名为 prd-skill 的 marketplace)
• 第二条命令从该 marketplace 安装 prd 这个 plugin,语法 <plugin>@<marketplace>

安装后在对话中直接使用:

/prd 要做一个相册应用,用户可以按日期分组照片,支持拖拽排序

或对已有 PRD 进入澄清模式:

/prd ./prds/photo-albums.md

向已有 PRD 追加新功能(扩展模式):

/prd ./prds/photo-albums.md 新增分享功能,支持生成带过期时间的分享链接

模式判定

• 参数是已存在的文件路径 + 新功能描述 → 扩展模式
• 参数只是已存在的文件路径 → 澄清模式
• 参数是自然语言描述 → 生成模式

输出位置

生成模式默认写入 ./prds/<short-name>.md。如果当前目录本身就叫 prd/prds/docs/prd,则直接写到当前目录。

特性

• 原始 prompt 溯源: 所有用户输入作为 PRD 的一部分显式管理,方便评审时对照原话(见上文"主要功能")
• 纯中文 PRD 输出
• 关注 What / Why,不涉及技术栈和实现细节
• 用户故事按 P1/P2/P3 优先级排序,每个故事可独立测试、独立交付价值
• 成功标准必须可衡量、技术无关
• 生成模式最多保留 3 个 [NEEDS CLARIFICATION] 标记,澄清模式最多问 5 个问题
• 不涉及任何 git 操作

License

MIT