AI 生码 - PRD2CODE：Schema2PRD 全流程设计与实现

摘要针对低代码平台场景产品经理配置页面字段后需快速生成可复制的标准化 PRD本文拆解 Schema 转 PRD 自动化转换服务的实现方案涵盖背景、关键决策、架构设计、核心机制、规则编写及扩展性解决转换稳定性与高效性问题助力开发者快速复用。一、背景1.1 使用场景低代码平台中产品经理完成页面字段、属性配置后点击「生成 PRD」按钮系统需自动完成 Schema 到 PRD 的转换生成标准化内容并支持一键复制至文档平台替代人工编写提升 PRD 产出效率。核心页面配置区域包括筛选区域、批量工具区域创建按钮、下拉菜单、导出等、表格区域多类型列及属性配置。1.2 核心流程Schema 转 PRD 全流程无缝衔接确保高效稳定具体如下用户点击生成 PRD调用接口传入 template_id 和 schema后端接收处理调用 AI 服务组合 role/scene/check 三层规则调用 AI 模型转译返回 PRD HTML 内容格式校验处理用户一键复制使用1.3 关键决策1.3.1 输入输出均为英文决策Schema、规则提示及 PRD 输出均采用英文。核心原因模型适配性英文语料占比高主流 AI 模型英文语料占 80% 以上理解更扎实转换更精准转换准确性英文逻辑严谨可有效减少模型幻觉保障结果准确开发效率适配 AI 提示工程规范无需额外适配降低开发测试成本。1.3.2 输出采用 HTML 格式决策PRD 输出为 HTML 格式而非 Markdown。核心原因可直接复制适配主流文档平台无需二次编辑省去 Markdown 转 HTML 步骤减少耗时与格式错乱。二、整体架构设计2.1 目录结构采用模块化设计分离规则、角色、场景与质量检查便于维护扩展基于 TypeScriptrules/├── index.ts # 主入口规则路由与组合 ├── roles/│ └── index.ts # 角色定义与基础提示词 ├── scenes/│ ├── basicFormRule.ts # 表单场景规则 │ ├── basicTableRule.ts # 表格场景规则 │ └── othersComponentRule.ts # 其他组件规则 └── checklists/└── index.ts # 质量检查清单2.2 核心处理流程系统接收 Template ID 和 Schema 后通过规则路由选择适配规则组合后调用 AI 生成 PRD已知模板未知模板含 form含 table其他Template ID SchemagetRulesByTemplateIdTemplate ID 映射判断匹配预设规则Schema 解析→提取组件名称组件类型basicFormRulebasicTableRuleotherComponentRulegetFinalRules组合角色场景质量规则输出规则调用 AI三、核心实现机制3.1 规则路由系统核心功能根据 Template ID 和 Schema 智能选择转换规则兼顾稳定性与灵活性。// 规则路由核心方法根据模板 ID 和 Schema 匹配转换规则constgetMatchedRule(templateId:string,schema:string){// 静态映射已知模板 ID 直接匹配对应规则仅保留核心示例construleMapping{FORM_TEMPLATE_01:basicFormRule,// 表单模板TABLE_TEMPLATE_01:basicTableRule// 表格模板};// 动态解析兜底未知模板按组件类型匹配规则if(!ruleMapping[templateId]){constschemaObjJSON.parse(schema);// 提取页面核心组件名称constcoreComponentschemaObj.children?.[0]?.componentName||schemaObj.componentName;if(coreComponent?.toLowerCase().includes(form))returnbasicFormRule;if(coreComponent?.toLowerCase().includes(table))returnbasicTableRule;returnotherComponentRule;// 其他组件通用规则}returnruleMapping[templateId];}设计亮点说明静态映射优先保证转换稳定性与可预测性动态解析兜底提升系统扩展性3.2 规则组合策略采用「角色层场景层质量层」三层架构确保 PRD 准确规范组合逻辑简洁可扩展。层级核心作用角色层定义 AI 职责确保转换方向不偏离场景层适配不同页面类型实现精准转换质量层规范输出标准降低返工率// 规则组合核心逻辑整合角色、场景、质量三层规则constgetFinalConvertRules(templateId:string,schema:string){constsceneRulegetMatchedRule(templateId,schema);// 获取匹配的场景规则// 拼接三层规则确保转换规范return${roleRule}\n${sceneRule}\n${qualityChecklists};};四、规则编写规范与核心技巧核心目标制定标准化规则编写规范结合前文规则路由、三层规则组合逻辑确保规则可维护、可复用保障 Schema 转 PRD 的准确性与效率降低维护成本。4.1 统一编写模板基础规范所有场景规则表单、表格、详情页等统一遵循以下模板确保格式一致、便于 AI 解析和团队复用适配前文规则组合逻辑## Input Format * 明确 Schema 核心结构与必填字段适配 AI 解析需求 ## Output Format **页面配置区域**筛选、批量工具、表格等 **Extraction Rules:** 字段提取与处理逻辑贴合三层规则组合要求 **Output Format:** 统一 HTML 模板4.2 专项处理规则结合页面核心组件制定专项处理规则避免格式错乱与信息冗余适配前文页面配置场景筛选/表格区域自动移除全为「-」的属性列精简无效信息保障转换准确性选项处理提取 label/value页面展示用 label数据传递用 value规范格式避免转译歧义操作组件下拉菜单、按钮需明确功能描述批量工具按配置展示4.3 核心编写技巧聚焦高效编写、精准转换提炼 4 个核心技巧贴合规则路由与组合逻辑分块处理按页面功能分区编写规则降低耦合适配规则模块化管理类型映射遵循标准化组件映射如 input→Input保证 PRD 输出规范递归处理、条件输出递归解析 Schema 配置过滤无效内容并输出有效数据提高处理效率示例适配每个规则配套 1 组输入输出示例便于验证与复用。4.4 质量校验机制形成「编写-校验」闭环确保规则合规、转换准确呼应前文质量层规则要求内容校验标题、字段映射准确无遗漏、无错误格式校验遵循统一模板、HTML 输出规范层级清晰场景适配专项规则贴合页面配置场景适配规则路由匹配逻辑可复用性规则表述简洁便于新场景扩展与版本管理。五、扩展性设计方案支持新场景扩展与规则版本管理适配业务迭代无需重构核心逻辑。5.1 新场景规则添加// 新场景规则添加示例// 1. 新增详情页规则其他场景可参考此格式constdetailPageRule## Input Format...;// 2. 在规则映射中添加新模板示例 ID详情页模板 01construleMapping{DETAIL_TEMPLATE_01:detailPageRule,...};// 3. 扩展动态解析逻辑适配详情页组件if(componentName?.toLowerCase().includes(detail))returndetailPageRule;5.2 规则版本管理策略说明向后兼容不修改旧规则且新规则兼容旧规则保障现有业务稳定渐进升级逐步迁移旧模板降低风险版本标注规则文件标注版本便于追溯回滚六、总结6.1 核心亮点本方案聚焦 Schema 转 PRD 自动化核心需求核心亮点围绕四层技术架构展开采用「角色场景质量」三层规则架构对应架构层中的规则层搭配“静态映射优先、动态解析兜底”的智能路由系统对应路由层通过模块化设计实现规则高效管理内置质量校验机制保障转换准确性同时具备良好扩展性可适配业务迭代与新场景拓展生成层与输出层则支撑自动化转译与便捷使用。6.2 技术架构梳理方案采用四层架构逻辑清晰、可落地性强各层级核心职责明确与前文核心亮点精准呼应路由层通过静态映射动态解析智能匹配适配的转换规则对应核心亮点中的“智能路由系统”兼顾稳定性与扩展性规则层以「角色场景质量」三层规则组合为核心对应核心亮点的“三层规则架构”确保 PRD 转换准确、规范贴合业务场景生成层调用 AI 模型完成转译支撑核心亮点中“转换准确性”的实现输出符合要求的 HTML 格式的 PRD输出层完成格式校验支持用户一键复制提升使用体验支撑自动化转译的最终落地。6.3 关键决策与方案价值核心决策支撑方案落地最终实现研发提效核心目标具体如下关键决策核心价值英文输入输出提升 AI 转译准确性减少模型幻觉HTML 格式输出无需二次编辑提升用户操作效率方案核心价值彻底替代人工编写 PRD实现 Schema 到 PRD 全自动化转换统一研发标准、缩短交付周期、降低操作门槛有效解决低代码平台中 PRD 产出效率低、格式不统一的痛点助力研发团队提效降本。附录参考文档AI 生码PRD2CODE 全流程自动化方案