前言¶
产品侧常见情况是：discovery 已经做完，材料散落在笔记、Slack 线程和会议记录里，工程要开工时却缺一份能把问题、用户、方案和成功标准串起来的文档。直接让 Agent「写一份 PRD」，往往得到泛泛的模板，既难对齐干系人，也难作为工程交接的单一事实来源。
下面介绍的是 Product Manager Skills 库中的 prd-development workflow：用固定章节与分阶段引导，把零散输入填进结构化 PRD，并标出假设与未决问题，面向 major initiative 的工程就绪文档，而不是瀑布式一次性规格。
这是什么¶
prd-development 是类型为 workflow、主题 pm-artifacts 的 Agent Skill，维护方与源码位于 deanpeters/Product-Manager-Skills 仓库的 skills/prd-development 目录。
官方描述：将 problem framing、用户研究归纳、方案定义与 success criteria 编排进一份 cohesive 的 PRD；适用于把 discovery notes 转成 engineering-ready document。单次引导对话的预估时长在 Skill 元数据中为 60–120 分钟；完整 workflow 在资料中写明为 8 个阶段、约 2–4 天，并会调用多个 component / interactive skills。
它强调 PRD 是 living document：保留战略上下文、客户问题、方案与成功标准，随交付学习而演进；不是逐像素 UI spec，也不替代协作对话。
核心功能¶
PRD 要回答的问题¶
Skill 将 PRD 定义为结构化回答以下七点：
- 解决什么问题（Problem statement）
- 为谁解决（Target users / personas）
- 为什么现在做（Strategic context）
- 做什么（Solution overview）
- 如何衡量成功（Metrics / success criteria）
- 具体需求是什么（User stories、acceptance criteria、constraints）
- 明确不做什么（Out of scope）
标准文档骨架（10 节）¶
输出对齐官方模板，章节包括：Executive Summary、Problem Statement、Target Users & Personas、Strategic Context、Solution Overview、Success Metrics、User Stories & Requirements、Out of Scope、Dependencies & Risks、Open Questions。各节在 Skill 内附有可复制的 Markdown 大纲，便于直接填充。
template.md 与缺口标记¶
实际填写以同目录下的 template.md 为载档。资料中说明该模板包含：
- 每节的 Instructions、Steps、Contributing Skills、Activities，便于脱离主 workflow 自学填写
- 行内缺口标记：Assumption（合理但未验证）与 Open Question（待发现），标在缺口出现处
- 每节结束前的「Before moving on」一致性检查
- 第 10 节后的自评：最强/最弱章节、待验证假设、分享前的建议下一步
- 与约 15 个相关 Skill 的交叉引用表（例如
problem-framing-canvas对应第 2 节，epic-breakdown-advisor对应第 7 节）
分阶段编排（8 phases）¶
Workflow 按 facilitation 顺序推进；资料完整给出的前两阶段示例如下：
Phase 1：Executive Summary（约 30 分钟）
目标是一段给「扫读者」看的概述。推荐句式：We're building [solution] for [persona] to solve [problem], which will result in [impact]. 建议先写 forcing clarity，全部章节完成后再回头润色。
Phase 2：Problem Statement（约 60 分钟）
目标是把问题框定清楚（后续阶段在截断资料中延续）。
以对话方式运行时，交互协议引用同仓库的 workshop-facilitation Skill：单次一问、进度标签、中断与暂停恢复、决策点的编号建议等；若与本文 workflow 冲突，以 prd-development 的 workflow 逻辑为准。
输入与调用方式¶
- 最适合携带：本次 PRD 所覆盖的 feature 或 initiative（
argument-hint为[feature or initiative]）。 - 可同时粘贴：discovery notes、problem statements、用户研究、成功指标、约束；已有内容会落入对应阶段，已回答项不再重复追问。
- Skill 名后的文本、
ARGUMENTS:行或整段 context dump 均视为已给答案。 - 空手调用也可以：从 problem definition 起逐步搭建。
官方示例 invocation：
Build a PRD for self-serve workspace provisioning — here are my discovery notes and the OKR it ladders to.
明确不做什么（Anti-Patterns）¶
- 不是详细 spec，不替代设计稿级 UI 说明
- 不是冻结合同的瀑布文档
- 不替代面对面协作
不适合：小 bug 修、 trivial feature；问题与方案已对齐时可直接写 user stories；持续 discovery 实验宜用 Lean UX Canvas 等路径（Skill 原文如此建议）。
安装与启用¶
Skill 本体是仓库内的 SKILL.md 及配套 template.md 等文本，属通用 Agent Skills 形态。父仓库 Product-Manager-Skills 标明可用于 Claude Code、Cursor、Codex 等；并出现在 Claude Code Plugin Marketplace 文档链路中。社区索引 awesome-agent-skills 给出的通用做法如下（针对整个 skill 集合或 GitHub 路径，而非单独安装脚本）：
Claude Code：
/skills add <github-url>
可将本 Skill 的目录或仓库 URL 交给平台文档中的 add 流程（具体以 Claude Code 当前 skills 文档为准）。
Claude.ai： 在新对话中粘贴 SKILL.md 的 raw URL。
Codex / GitHub Copilot 等： 按各平台「Agent Skills」文档将 skill 目录纳入 agent 可见范围。
Vercel skills CLI（社区推荐）：
npx skills find prd-development
npx skills add deanpeters/Product-Manager-Skills
npx skills list
安装后通过自然语言要求 Agent 使用 prd-development，并带上 initiative 名称与已有材料即可。本 Skill 资料未单独列出 Cursor 专有配置文件名；在 Cursor 中通常与同类 Skill 一样，将 skill 纳入项目或用户 skills 目录后由 Agent 按需加载 SKILL.md。
典型用法¶
- 确定 major feature 或 initiative 名称。
- 整理已有的 discovery、OKR、约束，准备一次性粘贴。
- 调用 Skill，例如：
prd-development
Build a PRD for [your feature] — [paste discovery notes, metrics, constraints]
- 按阶段回答引导问题；模板中无法确认处让 Agent 标 Assumption / Open Question。
- 完成第 10 节后做自评，再对外分享或交给工程做 handoff。
父仓库 README 中的场景示例与 Skill 元数据一致，例如：电商 AI 推荐功能需要 PRD；discovery sprint 结束后要把结论转成工程师可执行的文档。
适用场景与注意¶
更适合：
- 从零写完整 PRD（
best_for原文） - 重大新功能开发前的需求结构化
- 跨职能对齐范围与需求，并留存决策记录
时间与预期：
- 元数据
estimated_time：60–120 min（偏单次 facilitated 会话） - Application 一节：8 phases / 2–4 days（含多 Skill 编排的完整产出）
注意：
- 工程侧需要的是 problem → personas → solution → metrics → stories 的闭环；缺证据的段落应保留 Open Question，避免 Scope creep 与「按 PM 脑内版本开发」。
- 与库内
user-story、problem-framing-canvas、epic-breakdown-advisor等 Skill 可组合；PRD 第 7 节用户故事质量可再单独用 user-story Skill 收紧。 - 许可证以父仓库为准（资料载明 CC BY-NC-SA 4.0，版本标签以仓库 release 为准）。
结尾¶
prd-development 把 PM 交付物写作从「一次性生成文档」拉回到可核对的分阶段 workflow：标准十节结构、模板内教练块与假设标记，并指向工程可执行的 user stories 与 acceptance criteria。若你手头已是 discovery 碎片，可以用它收敛成单一 PRD 事实来源。
官方路径：https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/prd-development
