SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场01-prd-generation

01-prd-generation

写作与研究

查看项目

更新于 10-16 07:09

技能介绍

用途

本技能是 Phase 01（战略愿景）中的第二个技能，用于把已批准的发现证据转化为一份可追溯的产品需求文档（PRD）。它在 Vision Statement 的基础上，连接战略意图与后续详细的需求工程，是下游功能分解前关于产品范围、功能优先级和可衡量目标的权威来源。

适用时机

  • 在 03-vision-statement 技能已产出 Vision_Statement.md（位于 projects/<ProjectName>/<phase>/<document>/）之后使用。
  • 若团队没有正式愿景文档，但已在 projects/<ProjectName>/_context/ 中填充 vision.md 和 features.md，也可在 00-meta-initialization 之后直接使用。
  • 不适用场景：不要用于测试尚未验证的商业模式（应使用 04-lean-canvas）；不要用于实现设计，已批准的需求应路由至 Phase 03。

必需输入

  • 项目上下文与发现证据：来自 projects/<ProjectName>/_context/ 与已批准研究（必需）。缺失时停止并列出缺失的发现决策，不得臆造需求。
  • 愿景、范围与利益相关方决策：来自已批准的 Phase 01 制品与决策日志（必需）。缺失时标记未解决冲突，并暂缓受影响的需求。
  • 具体文件输入：vision.md（必需，业务目标、问题陈述、约束）、features.md（必需，功能列表及描述）、stakeholders.md（必需，用户角色、画像、利益相关方群体）、Vision_Statement.md（可选，用于丰富执行摘要和市场背景）。

工作流程

  1. 读取命名输入，确认其批准状态、版本与未解决决策。
  2. 起草前应用决策规则；若缺少权威依据、存在不安全假设或范围驱动因素未解决，则停止。
  3. 通过既有领域流程生成 PRD 与清单，仅为所选分支加载所需参考。
  4. 将 PRD 与清单中的每项实质性陈述追溯到输入、决策或明确限定的假设。
  5. 验证可观察的验收条件，记录未评估的检查，并将制品移交其命名消费方。
  6. 若验证失败，通过纠正源决策或制品并重跑受影响检查来恢复；不得削弱验收条件。

核心步骤（九步）

  1. 读取上下文文件：读取 vision.md、features.md、stakeholders.md，可选读取 Vision_Statement.md；记录所有读取路径；若 vision.md 或 features.md 缺失则停止并报告缺口。
  2. 生成文档头：项目名（来自 vision.md）、版本 1.0、日期、作者（缺失标记 [AUTHOR-TBD]）、状态 Draft。
  3. 生成执行摘要：一段主动语态文字，提炼产品目的、主要用户群与核心价值主张，避免最高级和营销语言。
  4. 生成市场背景：问题空间直接取自 vision.md 的问题陈述；目标市场细分来自 stakeholders.md 的用户角色与领域；竞争格局由领域约束与技术选择推断，缺乏依据的断言标 [INFERRED]；若面向高端/企业/精英等用户，先加载 premium-product-positioning 技能并应用其需求门。
  5. 生成产品目标：为 vision.md 中每个业务目标创建一条 SMART 目标（具体、可衡量、可实现、相关、有时限）；缺少可衡量指标的业务目标标 [METRIC-TBD]。
  6. 生成目标用户与画像：来自 stakeholders.md，包含画像名称与角色、关键特征与目标、相关痛点、使用频率与技术熟练度。
  7. 生成功能优先级矩阵：列为 Feature、Description、Priority、Effort、Value、MoSCoW、Rationale；Priority 为 Critical/High/Medium/Low（按业务影响），Effort 为 S/M/L/XL（按技术复杂度），Value 为 High/Medium/Low（按用户收益），MoSCoW 为 Must/Should/Could/Won't（按 MVP 关键性），Rationale 为一句话理由；features.md 中每个功能都必须出现。
  8. 生成成功指标：定义 3-5 个 KPI，每个包含 KPI、Baseline、Target、Measurement Method、Timeline；未知基线标 [BASELINE-TBD]。
  9. 生成其余章节并写出：约束与依赖（来自 vision.md 的预算、时间线、技术、法规约束；外部系统依赖与 API 集成）；发布策略（按优先级分层将功能映射到发布的分阶段计划，采用 Now/Next/Later 成果格式，仅 Now 时域携带已承诺的功能范围与日期）；标准可追溯性附录（将各 PRD 章节映射到 IEEE 29148-2018 与 IEEE 1233-1998 条款号）；写入 projects/<ProjectName>/<phase>/<document>/PRD.md，记录章节数与功能数。

最后一步：生成 manifest.md，列出章节文件并按正确装配顺序排列（如 01-purpose.md、02-scope.md、03-stakeholders.md、04-features.md、05-constraints.md），以确保 build-doc.sh 按预期顺序装配。

输出与验收

  • 输出：Product Requirements Document 与清单；消费方为需求、UX、架构与交付团队。
  • 可观察验收条件：每个功能可追溯到目标并具有可衡量的验收或成功条件；排除项与未决决策明确。
  • 产生的证据：来源与决策追溯（消费方为评审者与下游负责人），每项实质性陈述引用已批准输入、命名决策或限定的未决问题；完成验证记录（消费方为发布或阶段门负责人），每项适用检查记录通过/失败，不可用检查保持未评估。

能力与权限边界/降级模式

默认只读用于分析、评审、评估与规划；需要读取与搜索已授权项目制品的权限；编辑仅限明确请求的项目交付物；可运行文档、语法或验证检查；网络访问仅用于需要当前验证的事实。未经明确授权，不得发布、花费、变更生产、批准策略或声称认证。若必需能力不可用，返回最窄可用的限定 PRD 与清单草稿，外加缺口登记（缺失项、受影响章节、风险、负责人）；绝不将未评估检查转为通过。

决策规则

  • 发现成熟度：证据已解决目标用户、问题与成果 → 撰写 PRD，避免过早需求固化猜测。
  • 重大假设仍未测试 → 路由到 Lean Canvas 假设板，避免虚假确定性进入待办。
  • Opportunity Record O1-O4 未回答，或 Must-have 功能在证据阶梯 E0 存在产品风险 → 将 PRD 标记为 SPECULATIVE 并阻止基线，避免工程构建未验证的猜想。
  • 需求无路径通向有资金的目标，或其成果无遥测 → 标记 [TRACE-ORPHAN] 或 [TRACE-BLIND]，在基线前解决，避免无法证明或判断的范围。

质量与反模式

质量要求：保留仓库术语，将每个重要选择追溯到项目上下文；使用确定性验收条件，将模糊质量主张替换为可观察检查、阈值或命名批准；覆盖错误、空、边缘、恢复与运维案例；依赖前核实标准、引用、API 与包名，无法核实的要限定；安全、安保、法律、财务、无障碍或数据完整性门失败时停止发布。 反模式及修复：无目标可追溯性的功能列表（映射到命名目标与度量）；将利益相关方愿望当作需求而无证据（标注来源与决策负责人）；无规则地使用高/中/低（应用本技能优先级矩阵）；在散文里隐藏范围排除（维护明确的超范围登记）；声称指标但无基线或测量方法（命名基线缺口与埋点负责人）。

集成与标准

上游：01-strategic-vision/03-vision-statement，消费 Vision_Statement.md。下游：01-strategic-vision/02-business-case（提供目标与指标）；02-requirements-engineering（提供功能列表用于 SRS 分解）。标准：IEEE 29148-2018（需求工程，约束需求文档结构与内容）；IEEE 1233-1998（系统需求规格说明编写指南，提供良构需求与可追溯性指导）。本技能还包含战略基础检查（Levy + Branson）：四项原则检查（业务战略、价值创新、已验证用户研究、杀手级 UX 设计，任一缺证据则 PRD 为“speculative”）、画像纪律（每个主要用户角色声明一个 Essential Persona，含完整要素，功能论证使用具名画像）、Field-of-Dreams 标记（若无已验证用户研究且无获取计划，则在 PRD 顶部标记 speculative）。

最终验证清单

所有必需输入文件已读取并记录；vision.md 中每个业务目标映射到至少一条 SMART 目标；features.md 中每个功能出现在功能优先级矩阵且所有列已填；成功指标每条 KPI 含基线、目标、方法与时间线；无未定义指标的主观形容词或营销语言；标准可追溯性附录映射章节到 IEEE 29148 与 IEEE 1233 条款；最终门通过（在人工评审门之前运行最终需求质量门：ID、单一性、验证方法、可追溯、无实现细节、ISO/IEC 25010:2023 非功能需求、假设/约束/超范围、术语表、版本管理、反 AI 粗糙内容）。

限制

关于具体收费、价格、平台支持范围等信息，当前资料未提供。