当前位置：首页 > news >正文

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

news 2026/4/14 23:52:31

摘要

针对低代码平台场景，产品经理配置页面字段后需快速生成可复制的标准化 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 自动化核心需求，核心亮点围绕四层技术架构展开：采用「角色+场景+质量」三层规则架构（对应架构层中的规则层），搭配“静态映射优先、动态解析兜底”的智能路由系统（对应路由层），通过模块化设计实现规则高效管理，内置质量校验机制保障转换准确性，同时具备良好扩展性，可适配业务迭代与新场景拓展，生成层与输出层则支撑自动化转译与便捷使用。