AI 生码：可扩展、可审阅的 PRD2CODE 落地实践

一、背景与问题定义1.1 现状流程当前 PRD 生成核心流程共 4 步逻辑清晰但存在适配隐患选择 PRD 模板 → 通过 AI 对话生成页面结构 → 对话调整页面至符合需求 → 点击「生成 PRD」按钮系统按模板输出文档1.2 新变化带来的核心挑战原有 “模板 PRD 提示词” 的映射方案因图形化配置界面升级而逐渐不适用原有模板无法覆盖所有组件组合与变体生成的 PRD 常出现字段缺失、交互描述错误、与页面实际不匹配等问题核心变更有 3 点组件类型扩展从“固定模板集”升级为“组件组合空间”打破模板约束变体更灵活引入槽位、区块等概念页面变体多样性大幅提升页面描述升级由“模板归类”变为“结构化 DSL 少量自然语言意图”定义。二、整体交互流程2.1 系统侧体验交互流程用户点击「生成PRD」按钮系统输出结构化内容系统整合所有修改输出可交付格式输入DSL生成PRD草稿PRD可视化审阅直接编辑模块/字段/交互调整Chat修改自然语言修订合并修改PRD最终版本一键复制HTML文档格式2.2 界面原型说明界面以“高效审阅、便捷修改”为核心左侧对话输入框支持自然语言修订指令右侧展示 PRD 内容支持富文本直接编辑、实时预览交互优化有效时间内可同一轮对话重复交互提升效率。2.3 交互形式升级从“生成文档”到“生成可审阅 PRD”PRD 生成是“可验证、可修改”的中间过程分 4 步实现Step 0页面已完成用户通过 AI 对话调整页面至满意系统获取两大输入页面/组件 DSL页面结构、自然语言/对话摘要业务意图/约束。Step 1点击「生成 PRD可审阅」系统输出 3 类内容支撑后续审阅PRD 草稿结构化可视化、检查清单研发核心确认项、边界问题清单待产品确认。Step 2审阅与修改支持两种并行修改方式富文本直接编辑 PRD 内容自然语言对话输入修订指令系统自动同步。Step 3一键操作交付完成修改后支持一键复制 HTML 格式直接粘贴文档平台未来可扩展自动同步至文档平台。关键点审阅是主流程将 PRD 转化为可验证、可修改的中间产物提升质量。三、整体流程技术层面PRD 生成分为 4 个核心层级形成完整链路以下先拆解流程图对应模块再补充核心思想与生成策略输入层产出层最终PRD → HTML文档最终PRD → 同步至文档平台审阅层PRD可视化审阅直接编辑自然语言修改合并处理修改内容生成层系统提示词PRD生成器PRD物料 组件物料PRD 草稿 检查清单 边界问题清单物料匹配层PRD物料匹配组件物料匹配自然语言/对话摘要页面/组件DSL3.1 流程图模块拆解3.1.1 物料匹配层确保 PRD 准确性的基础分两大通道匹配自然语言/对话摘要→PRD 物料匹配需求模板、检查清单、常见问题库等补齐“业务语义”页面/组件 DSL→组件物料匹配组件能力、约束、规范确保“页面事实”准确。3.1.2 生成层采用“约束式生成”避免内容失控输入系统提示词结构约束/生成规则、双物料PRD 物料 组件物料通过 PRD 生成器结构化生成 “PRD 草稿 检查清单 边界问题清单”。3.1.3 审阅层提升 PRD 质量的核心支持 PRD 可视化审阅提供直接编辑结构/字段/交互调整、对话修改Chat 指令修订两种方式系统自动合并修改内容并支持版本追溯。3.1.4 产出层聚焦可交付性基础输出 HTML 文档一键复制未来扩展直接同步至文档平台。3.2 核心思想双物料系统 约束生成核心创新是构建双物料系统结合约束生成保障 PRD 准确可扩展3.2.1 组件物料Component Materials聚焦“页面事实”含组件语义定义、属性、交互等和 PRD 映射规则组件对应 PRD 的段落/表格/字段。3.2.2 PRD 物料PRD Materials聚焦“业务语义”含可拼装的 PRD 章节片段及边界问题、验收用例等补充信息。3.3 生成策略先结构化 IR再渲染文档采用两段式生成提升可控性避免模型自由生成长文3.3.1 PRD-IR中间表示生成输出结构化 JSON包含模块、字段等核心内容标记来源DSL 事实/物料推断/待确认 TBD避免编造。3.3.2 PRD 渲染将 PRD-IR 转换为标准化 HTML 文档支持可视化预览与一键交付。四、方案详情4.1 PRD 物料生成4.1.1 物料分层物料分 4 层支持按需拼装提升复用性与扩展性L0 通用骨架片段背景、目标、权限等通用章节片段L1 领域通用片段列表页、详情页等高频场景专用片段L2 团队规范片段命名、埋点、性能等团队标准L3 历史归纳片段从历史 PRD 抽取的可复用“标准块”。4.1.2 物料组织形式采用 Chunk 形态结合 RAG 签名机制每个物料块需包含示例/描述避免召回无效物料。4.1.3 PRD 边界问题库按模块输出两类清单降低 PRD 遗漏风险检查清单权限、空态、校验、埋点等必须确认项显著提升 PRD 可用性指导产品人员针对性修改问题清单阈值、默认值、灰度方案等待产品确认项。4.2 RAG 能力设计核心目标可控召回 可解释拼装保障物料匹配准确可追溯。4.2.1 双通道 RAG组件 RAGDSL→组件物料输入 DSL 组件树、属性等输出匹配的组件定义、变体及 PRD 映射块PRD RAG自然语言→PRD 物料输入对话摘要、业务关键词输出业务片段、验收模板等。4.2.2 页面规格说明提取将 DSL 转换为页面规格说明含页面类型、可见交互、数据形态、权限点支撑 RAG 检索与检查清单生成。4.2.3 召回-拼装-校验三段式召回多路召回向量 关键词 标签提升物料覆盖与准确拼装按 PRD-IR schema 结构化拼装避免自由写作校验确保 PRD-IR 与 DSL 一致字段/模块可追溯。4.2.4 避免模板失准的关键核心转变PRD 是“DSL 事实 物料推断 待确认项”拼装的可审阅结构而非模板填空题。4.3 工作流能力设计节点化工作流便于扩展、回滚与灰度发布提升流程可控性。4.3.1 推荐节点输入标准化输入 DSL 对话上下文输出标准化 DSL、对话摘要等页面规格说明提取输入 DSL输出页面规格说明支撑后续流程组件/PRD 物料检索分别输出组件物料包、PRD 物料包PRD-IR 生成输出带来源标记的 PRD-IR JSONIR 校验校验追溯性关键项缺失触发补问/标黄渲染输出 “PRD 草稿 检查清单 边界问题清单”支持 Markdown/文档平台格式审阅循环人工修改生成补丁回写物料库实现流程进化。4.3.2 审阅的工程落点聚焦结构修改避免修改长文支持字段、交互、验收用例修改修改记录保存为可追踪、复用的 IR 补丁。4.4 系统对接方案4.4.1 接入点页面完成态含最终 DSL用户点击「生成 PRD」触发流程对话上下文可选。4.4.2 服务分层工作流编排服务负责流程节点调度与监控物料检索服务管理组件物料库平台 PRD 提取与 PRD 物料库历史沉淀 人工补充。4.4.3 最小数据结构page_id页面唯一标识dsl_snapshotDSL 版本化快照chat_summary对话摘要prd_irPRD 中间表示 JSONprd_renderedPRD 渲染结果prd_patch审阅修改补丁publish_target发布目标标识。4.5 MVP最小可行版本核心目标实现 PRD “可信 可用 可审阅”快速落地核心功能。MVP 范围输入DSL 对话摘要支持自动生成组件 RAG覆盖列表、表单、详情、弹窗 4 类高频场景PRD RAG接入通用片段 基础检查清单支持 PRD-IR 生成与 Markdown 渲染审阅 v1模块级标注、Chat 修改、版本保存发布一键复制 HTML。MVP 验收指标一致性PRD 与 DSL 字段/按钮一致率可用性审阅修改段落比例、平均修改量效率从生成到可提交 PRD 的总时间。4.6 流水线编排流程拆分为标准化节点实现自动化流转替代原文图片校验通过校验失败输入标准化DSL→页面规格提取组件物料检索PRD物料检索PRD-IR生成器IR校验器渲染器补问/标黄提示PRD可视化审阅人工修改/对话修改合并修改生成补丁生成最终PRD一键复制HTML未来同步至文档平台补丁回写物料库五、关键风险与应对措施风险 1大语言模型编造内容应对措施强制两段式生成先 IR 后渲染强化 IR 校验确保内容可追溯完善 TBD 机制不确定内容标黄待确认不随意编造。风险 2组件变体多物料维护成本高应对措施组件物料分层基础定义 原子化物料支持自由组合DSL 信号优先从 DSL 推导组件减少人工维护。风险 3RAG 命中不稳定PRD 质量波动应对措施召回层增加结构过滤先判断页面类型再召回物料块添加语义元信息提升场景匹配度高频组件模板兜底固化格式避免随机。六、总结本方案通过“双物料系统 约束生成”构建了可扩展、可审阅、可交付的 PRD 标准化生成体系。核心创新是将 PRD 从“模板填空题”转为“可审阅结构化产物”通过 PRD-IR 保障准确性与可追溯性通过可视化审阅、版本管理提升质量与效率通过节点化工作流、分层物料确保可扩展性。最终实现从“DSL 自然语言意图”到高质量 PRD 的自动化生成解决原有模板映射失效问题提升产出效率与质量。