PRD 需求文档写作
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/asyrafhussin-agent-skills-prd-writing。
技能介绍
要解决什么问题
功能从「口头对齐」直接进开发,往往在 scope、验收标准和 NFR 上反复拉扯。PRD 写得宏大却不可测,工程师也无法从一份文档里判断该建什么数据模型、哪些路由、什么算完成。本技能针对的是:在动笔写方案之前,先把问题、用户、边界和可验证需求钉死,并输出团队可共用的结构化 PRD。
技能如何工作
技能规定 六步顺序流程,并强调未完成 discovery 不得开写正文:
- 评估项目状态 — 已有代码则先探查仓库(models、routes、鉴权等);绿地项目则先一起澄清要做什么、技术栈与约束。
- 提出澄清问题 — 3~5 个定向问题,覆盖问题、用户、非目标 scope、成功标准、约束;有选项用 A/B/C,未知标
TBD而非假设。 - 按模板起草 PRD — 使用 12 节标准结构(Executive Summary、Problem Statement、Goals & KPIs、Personas、User Stories、FR/NFR、技术规格、Out of Scope、Dependencies 等),功能需求编号为
FR-1、FR-2。 - 提交评审 — 对照问题陈述、用户故事缺口、范围边界与开放问题请用户确认。
- 按反馈修订 — 必要时记录 review history。
- 落盘 — 保存为
docs/prd/{feature-name}.md(kebab-case),含 frontmatter。
起草阶段需遵守跨 7 类的 25 条规则:例如 problem-first(先问题后方案)、metric-no-vague-language(模糊词换成数字)、quality-acceptance-criteria(每条需求可测试,复杂场景用 Given/When/Then)。
适用边界与注意点
- 面向单功能/特性的 PRD,不是替代完整产品战略或 Roadmap 工具。
- 依赖用户参与澄清与评审;若 stakeholder 未对齐,技能会刻意保留 Open Questions 而非杜撰结论。
- 技术节要求写清 data model、auth、API routes、集成点,适合与工程联调;若只需营销一页纸,节结构和粒度可能偏重。
使用场景
- 已有代码库要加新能力,需先对照 models/routes 再写带 FR 编号的 PRD 再排期开发
- 绿地项目方向模糊,需用 3~5 个澄清问题锁定用户、非 scope 和 KPI 后再起草 12 节文档
- 功能评审会上工程师质疑「完成标准」,需把 User Story 改成带 Given/When/Then 的可测验收条件
- 多人协作特性需在合并前进 review,并把定稿存到 docs/prd 作单一事实来源
适合人员
- 负责新功能立项的产品经理,要把问题陈述和 Out of Scope 写进团队可评审的 PRD
- 带后端团队的技术负责人,需在 PRD 里明确 data model、鉴权与 API routes 再拆任务
- 创业联合创始人,在写第一行代码前用结构化模板对齐成功指标与依赖风险
- 业务方提出模糊需求时,用 TBD 与 Open Questions 列清未知项而非直接拍板方案