HVE Core PRD Builder实战:7阶段QA生成产品需求文档
2026/9/18 10:50:19 网站建设 项目流程

HVE Core PRD Builder实战:7阶段Q&A生成产品需求文档

【免费下载链接】hve-coreA refined collection of Hypervelocity Engineering components (instructions, prompts, agents, and skills) to start your project off right, or upgrade your existing projects to get the most out of GitHub Copilot项目地址: https://gitcode.com/GitHub_Trending/hv/hve-core

HVE Core是 GitHub 官方的 Hypervelocity Engineering 组件精选仓库,内置了大量指令、提示词、智能体与技能。其中的PRD Builder智能体通过 7 阶段引导式 Q&A,帮你把零散想法变成一份可度量、可追溯的产品需求文档(PRD),新手也能快速上手。

为什么用 PRD Builder 写产品需求文档?

很多人第一次写 PRD 会卡在:不知道写哪些章节、需求写得太虚无法验收、写到一半忘了上下文。PRD Builder 用"智能体 + 结构化问答"的方式解决这些问题:

  • 🧭按阶段推进:内置 Assess → Discover → Create → Build → Integrate → Validate → Finalize 七阶段生命周期
  • 📝模板驱动:按规范模板逐节填充,章节覆盖一致、不缺项
  • 💾会话持久化:进度存为 JSON 状态文件,关掉窗口明天还能继续
  • 质量把关:自动派发 PRD Quality Reviewer 子智能体做完整性与质量审查

💡 如果你要写的是"商业立项文档",请选 BRD Builder(三阶段);要写"产品功能需求与验收标准",就用 PRD Builder(七阶段)。两者对比详见 docs/agents/project-planning/brd-prd-builders.md。

PRD Builder 的7阶段生命周期一览

阶段干什么
Assess 评估判断现有上下文是否足够命名并创建 PRD 文件
Discover 发现通过聚焦提问确定标题、核心问题与基础范围
Create 创建标题清晰后,生成 PRD 文件与会话状态文件
Build 构建迭代收集功能需求(FR)与非功能需求(NFR)
Integrate 集成纳入参考文档、外部资料并附引用
Validate 验证派发质量审查子智能体,确认完整性
Finalize 交付输出完整可执行的 PRD 与完成度摘要

七阶段的具体行为由requirements-author技能逐阶段加载,实现细节见 docs/reference/skills/project-planning/requirements-author.md。

Copilot 智能体调用统计面板——团队可以据此观察 PRD Builder 等智能体的使用情况

实战步骤:从一句话到完整PRD

第1步:选对智能体,给足上下文

在 Copilot Chat 面板的智能体选择器中选中PRD Builder,然后描述你要构建的产品。上下文越具体,Assess 阶段越快通过:

为自助式分析看板创建 PRD。目标用户是区域销售经理, 现有数据管道在 src/etl/,写入 Azure Synapse。 需求范围:15 分钟刷新的实时营收指标、区域下钻、 PDF/Excel 导出、按角色控制可见范围。 验收标准:P90 加载时间小于 3 秒。

如果只说"帮我写个 PRD",智能体会先追问"我们在构建什么?解决什么问题?"——这是设计使然,别跳过。

第2步:回答聚焦问题,锁定标题与范围(Discover)

智能体每轮只问 3–5 个问题,用 ❓/✅/❌ 标记问题状态,并分主题分组(如 🎯 产品上下文、📋 范围边界),不会一次性砸你一堆问题。

第3步:自动创建 PRD 与状态文件(Create)

上下文足够后,智能体会同时创建两个文件:

  • PRD 正文:docs/project-planning/<kebab-case-name>.md
  • 会话状态:.copilot-tracking/prd-sessions/<kebab-case-name>.state.json

状态文件记录已问/已答问题、下一步动作与引用资料处理情况,是"断点续写"的关键。

第4步:迭代构建功能与非功能需求(Build)

智能体逐轮追问目标、角色、约束,并给每条需求分配稳定编号:FR-###功能需求、NFR-###非功能需求、GOAL-###产品目标,每条 FR 都要挂到目标并链接AC-###验收标准。模板骨架来自 prd-full.md,保证章节结构规范。

第5步:纳入参考资料(Integrate)

丢给智能体市场调研、竞品分析等文档,它会读取、提取要点、写入对应章节并标注引用,同时在状态文件中登记每份资料的处理状态。信息冲突时按"用户说法 > 近期文档 > 更早引用"的优先级提醒你裁决。

第6步:质量验证(Validate)

智能体派发PRD Quality Reviewer子智能体(定义见 .github/agents/project-planning/subagents/),按 ISO 需求质量标准打分,检查目标是否 SMART、FR 是否可测试、验收标准是否描述"结果"而非"实现细节"。

第7步:交付与后续衔接(Finalize)

最终回复会附带产物清单表:PRD 路径、状态文件路径、生命周期状态、目标/FR/NFR 数量、未决问题数。之后可以把 PRD 交给 Functional Planner 生成待办工作项,或用 ADR Creator 沉淀架构决策——完整生命周期定位见 docs/hve-guide/lifecycle/product-definition.md。

四种输出模式:随时复查文档进度

长会话中不必每次全文重读,PRD Builder 支持四种复查模式:

模式用途
summary进度更新 + 接下来要问的问题
section [name]只看某一命名章节
full渲染完整文档
diff只看上次重大更新后的变化

中断与恢复:跨天推进不丢上下文

状态文件让 PRD 编写可以跨多个会话进行。新对话中说一句:

恢复"通知系统"的 PRD 会话。已确认 3 个通知渠道的优先级: 应用内提醒(MVP)、推送(Q3)、邮件摘要(Q4)。 按此分期交付继续构建需求。

智能体会读取.copilot-tracking/prd-sessions/下的状态文件,从上一完成阶段继续,并避免重复已回答过的问题。

实用技巧与避坑清单

  • ✅ 开头就给清晰的项目名/范围,可跳过大量基础提问
  • ✅ 充分利用summary/diff模式跟踪长会话进度
  • ✅ 让智能体对照代码库交叉校验需求与现状
  • ❌ 别试图一次性把全部需求倒出来——Discover 阶段需要上下文
  • ❌ 会话进行中不要手改.copilot-tracking/里的状态文件
  • ❌ BRD 与 PRD 不要混在同一个会话里写

相关资料速查

  • 智能体定义:.github/agents/project-planning/prd-builder.agent.md
  • 参考文档:docs/reference/agents/project-planning/prd-builder.md
  • BRD/PRD Builder 完整教程与示例提示词:docs/agents/project-planning/brd-prd-builders.md
  • 行为评测用例:evals/agent-behavior/stimuli/prd-builder.yml
  • PRD 规范模板:.github/skills/project-planning/requirements-author/templates/prd/prd-full.md

按七阶段走完一遍,你会得到一份带稳定编号、可追溯、可验收的产品需求文档——这正是让后续开发、评审和排期都不跑偏的起点。🚀

【免费下载链接】hve-coreA refined collection of Hypervelocity Engineering components (instructions, prompts, agents, and skills) to start your project off right, or upgrade your existing projects to get the most out of GitHub Copilot项目地址: https://gitcode.com/GitHub_Trending/hv/hve-core

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询