摘要
针对低代码平台场景,产品经理配置页面字段后需快速生成可复制的标准化 PRD,本文拆解 Schema 转 PRD 自动化转换服务的实现方案,涵盖背景、关键决策、架构设计、核心机制、规则编写及扩展性,解决转换稳定性与高效性问题,助力开发者快速复用。
一、背景
1.1 使用场景
低代码平台中,产品经理完成页面字段、属性配置后,点击「生成 PRD」按钮,系统需自动完成 Schema 到 PRD 的转换,生成标准化内容并支持一键复制至文档平台,替代人工编写,提升 PRD 产出效率。
核心页面配置区域包括:筛选区域、批量工具区域(创建按钮、下拉菜单、导出等)、表格区域(多类型列及属性配置)。
1.2 核心流程
Schema 转 PRD 全流程无缝衔接,确保高效稳定,具体如下:
1.3 关键决策
1.3.1 输入输出均为英文
决策:Schema、规则提示及 PRD 输出均采用英文。
核心原因:
- 模型适配性:英文语料占比高(主流 AI 模型英文语料占 80% 以上,理解更扎实),转换更精准;
- 转换准确性:英文逻辑严谨,可有效减少模型幻觉,保障结果准确;
- 开发效率:适配 AI 提示工程规范,无需额外适配,降低开发测试成本。
1.3.2 输出采用 HTML 格式
决策:PRD 输出为 HTML 格式,而非 Markdown。
核心原因:
- 可直接复制适配主流文档平台,无需二次编辑;
- 省去 Markdown 转 HTML 步骤,减少耗时与格式错乱。
二、整体架构设计
2.1 目录结构
采用模块化设计,分离规则、角色、场景与质量检查,便于维护扩展(基于 TypeScript):
rules/├── index.ts # 主入口,规则路由与组合 ├── roles/│ └── index.ts # 角色定义与基础提示词 ├── scenes/│ ├── basicFormRule.ts # 表单场景规则 │ ├── basicTableRule.ts # 表格场景规则 │ └── othersComponentRule.ts # 其他组件规则 └── checklists/└── index.ts # 质量检查清单2.2 核心处理流程
系统接收 Template ID 和 Schema 后,通过规则路由选择适配规则,组合后调用 AI 生成 PRD:
三、核心实现机制
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]){constschemaObj=JSON.parse(schema);// 提取页面核心组件名称constcoreComponent=schemaObj.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)=>{constsceneRule=getMatchedRule(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:详情页模板 01)construleMapping={'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 全流程自动化方案