摘要
在产研数字化转型过程中,样板间作为标准化落地的核心载体,已在各业务线广泛应用并凸显价值。随着模板设计与前端代码的逐步统一,传统"标准化"模式已难以满足高效研发需求,为此我们启动样板间 2.0 升级,聚焦"自动化"能力构建,打通 PRD、UI 设计、代码生成全链路,实现产研效率、体验、质量三重提升。本文将详细拆解样板间 2.0 的背景、目标、实现方案及核心价值,为同类产研提效项目提供参考。
一、背景:从标准化到自动化的必然升级
1.1 现有基础与升级契机
样板间 1.0 已完成各业务线模板设计与前端代码的标准化统一,成功解决了产研流程中"规范不统一、重复开发"的核心痛点,在多个项目中验证了标准化的价值。但随着业务迭代加速,新页面需求中,与模板相似度高的场景占比持续攀升,纯标准化模式已出现瓶颈,亟需向"自动化"升级,进一步释放产研效能。
1.2 适用场景
本次升级聚焦核心应用场景,精准覆盖高复用性需求,确保投入产出比最大化:
- 场景定位:面向与模板相似度超 80% 的 C 类场景(按个性化设计占比划分:A / B / C 类,C 类为个性化需求最低、复用性最高的场景);
- 基础依赖:基于 1.0 版本的标准化 PRD 和前端代码体系,无需重构现有基础;
- 核心能力:实现 PRD 到前端 UI 代码、API 接口的自动化生成,同时提供页面 UI 规范度检测能力;
- 适用范围:覆盖表格查询页、表单页、详情页等高频标准化页面,适配产研全链路需求。
1.3 预期收益
根据近期业务数据分析,B / C 类新页面需求仍将保持较高占比。推进样板间 2.0 升级能快速获得收益,主要体现在以下三大方面:
- 效率提升:减少重复编码、PRD 编写、UI 走查等冗余工作,显著提升产研全链路开发效率;
- 体验优化:统一页面设计标准,解决无设计师介入场景下的规范混乱问题,提升用户体验一致性;
- 周期缩短:打通需求落地全流程,消除协作壁垒,显著提升交付效率,加速业务迭代。
二、目标:聚焦产研全链路,明确核心定位
样板间 2.0 的核心目标是"以自动化能力赋能产研全角色",基于产研各角色的核心诉求,构建覆盖"PRD 规范→UI 合规→代码生成"的全链路自动化体系,最终实现效率、体验、质量的三重提升。
2.1 产研全角色诉求
明确产研全链路各角色的需求差异,是样板间 2.0 功能设计的核心依据,具体角色诉求如下表所示:
| 角色 | 原型图 | PRD | UI 规范 | 前端代码 | 接口文档 | PB 代码 | 冒烟测试用例 | 诉求 |
|---|---|---|---|---|---|---|---|---|
| 产品 | 高 | 高 | 中 | - | - | - | - | 高效输出标准 PRD + 原型图,降低研发沟通成本 |
| 设计 | 中 | 中 | 高 | - | - | - | - | 无设计师参与时,保证页面符合设计规范 |
| 前端 | 中 | 中 | 中 | 中 | - | - | - | 自动生成业务字段、组件配置等重复代码 |
| 后端 | 中 | 中 | - | - | 低 | 低 | - | 落地接口规范,自动生成 controller 层重复代码 |
| 测试 | 中 | 中 | - | - | - | - | 低 | 自动生成标准冒烟测试用例,提升用例产出效率 |
2.2 最终目标定位
结合各角色核心诉求,样板间 2.0 的目标聚焦四大核心方向,形成闭环式自动化能力:
- PRD 准确度提升:输出规范、准确的 PRD 文档,构建 AI - ready 数据基础,为后续智能开发提供高质量需求输入;同时提供 PRD 编写辅助、格式校验、字段联想等辅助能力,降低 PM 工作负担。
- UI 规范落地:基于页面组件配置,实现 UI 规范度的自动化检测与实时修复,确保无设计师介入的页面也能符合设计规范。
- UI 代码生成:生成符合模板规范的前端 UI 代码,覆盖高频标准化页面,减少前端重复编码工作,提升前端研发效率。
- CRUD 接口生成:生成符合后端 API 规范的接口代码(含 controller 层),落地接口规范,降低后端重复开发成本。
核心收益总结:
- ✅ 效率:需求开发全周期缩短,冗余工作占比显著降低;
- ✅ 体验:页面设计规范度统一,用户体验一致性大幅提升;
- ✅ 质量:编码标准化程度提升,线上问题率降低,研发质量更可控。
三、实现方案:分阶段落地,构建全链路自动化能力
基于"先解决核心痛点、再逐步拓展能力"的原则,样板间 2.0 采用分阶段实施策略,优先落地 PRD 准确度提升和 UI 规范度检测两大核心能力,再逐步推进 UI 代码生成、CRUD 接口生成,确保方案落地的可行性和高效性。
3.1 核心阶段一:PRD 准确度提升(优先落地)
PRD 作为产研流程的源头,其准确度直接影响后续研发效率和质量。针对样板间 1.0 的 PRD 痛点,重点优化 PM 操作流程和 PRD 输出规范,实现 PRD 标准化、自动化生成。
3.1.1 现状痛点剖析
样板间 1.0 的 PRD 功能描述存在明显痛点,制约研发效率,具体分为两个层面:
- 产品侧(PM):① 纯文本描述难以覆盖复杂 UI 效果(如 Tag 标签颜色、图文排版等),无原型图时易造成研发理解偏差,增加沟通成本;② 全量页面配置项过多,导致 PRD 模板冗长,加重 PM 编写和修改负担。
- 平台侧:格式标准化难度高,PM 复制模板后易随意修改格式 / 关键词,导致后续 AI 解析不准确,影响自动化能力落地。
3.1.2 目标产物
针对上述痛点,样板间 2.0 对 PRD 模块进行核心升级,形成标准化、可视化的 PRD 输出模式:
- 原型展示:页面截图 + URL(平台提供的可配置页面),直观呈现页面效果,替代纯文本描述;
- 描述生成:功能描述由平台自动生成,严格保障格式和参数的规范性,避免人工修改导致的格式混乱。
3.1.3 具体实现方案
核心设计思路:引入浏览器插件,实现"一站式操作",所有 PRD 编写、配置操作均在文档平台内完成,无需在文档平台和样板间之间切换,同时兼容 V1.0 / V2.0 版本,兼顾老用户使用习惯。
PM 操作全流程(以下流程图清晰展示完整操作逻辑,覆盖 V1.0 / V2.0 两种模式):
V1.0 模式
V2.0 模式
配置模式(推荐)
文本模式
打开文档平台
启动浏览器插件
选择目标模板
选择使用模式
点击「复制 PRD」
系统提示「已复制」并关闭弹窗
粘贴至 PRD 文档
点击「编辑 PRD」
选择配置方式
在 UI 界面配置字段/功能,实时预览效果
编写结构化文本更新页面配置
点击「保存并复制」
输入 Jira ID 完成关联,便于项目管理
系统提示「已复制」
在插件中查看/管理所有原型(按 Jira ID 分类)
关键能力补充:
- 配置模式:通过平台预设配置项更新页面,支持表格查询页、表单页、详情页、弹窗等标准化页面的核心配置,实时预览效果,降低 PM 配置难度;
- 文本模式:支持通过编写结构化文本更新页面配置,适配习惯纯文本操作的 PM;
- 自定义能力:提供「占位组件」,支持局部自定义功能(满足 C 类页面的部分个性化需求),组件可拖拽、悬浮,不影响整体标准化布局,自定义部分正常走设计流程。
3.2 核心阶段二:UI 规范度检测(同步落地)
解决 PRD 准确性问题后,重点解决"无设计师介入场景下的 UI 规范混乱"痛点,通过自动化检测机制,确保页面符合设计规范,避免前端开发后返工。
3.2.1 现状痛点
大量页面需求无设计师介入,但设计规范体系复杂,PM 难以完全掌握所有规范细节,导致页面配置后不符合设计要求,前端开发完成后需返工修改,浪费研发资源。
3.2.2 解决方案
将设计规范结构化、可检测化,构建自动化检测机制,在 PRD 原型配置阶段提前规避规范问题,具体实现步骤:
- 规范抽象:将设计规范抽象为组件属性(props)的关联规则,明确组件之间的配置约束;
- 规则落地:基于样板间 1.0 的模板配置规则,将结构化后的设计规范转化为可检测的系统规则;
- 机制构建:搭建自动化检测机制(支持 AI 驱动),实时检测页面配置是否符合规范;
- 实时反馈:在 PRD 原型配置阶段,实时给出规范提示并提供修复建议,确保配置完成后符合设计规范。
规范提示类型:
- 建议类:非强制要求,优化体验,如"表单项数量 < 5 时,建议使用弹窗形式,提升页面简洁度";
- 强制类:必须遵守,否则影响规范一致性,如"表格存在行 / 列合并时,必须使用带分割线表格,确保数据展示清晰"。
核心收益:在需求评审阶段即可完成 UI 规范走查,避免前端开发后因规范问题返工,节省研发时间和资源。
3.3 拓展阶段三:UI 代码生成(规划落地)
基于标准化的 PRD 配置和 UI 规范检测结果,自动生成符合模板规范的前端 UI 代码,覆盖表格查询页、表单页、详情页等 C 类页面的核心代码逻辑。
核心优势:生成的代码符合前端编码规范,无需大量修改即可直接复用,大幅减少前端重复编码工作,聚焦核心业务逻辑开发,进一步提升前端研发效率。
3.4 拓展阶段四:CRUD 接口生成(规划落地)
基于 PRD 中的业务字段和交互逻辑,自动生成符合后端 API 规范的 CRUD 接口代码(含 controller 层),落地接口规范,减少后端重复开发工作。
核心优势:接口代码与 PRD 字段联动,确保接口与需求一致,同时符合后端编码规范,降低后端接口开发成本,减少接口联调问题。
四、附录:核心参考内容
为便于开发落地和使用参考,补充核心配置方案对比、标准化页面设计参考,为产研人员提供实操指引。
4.1 配置能力方案对比
结合业界低代码产品经验,梳理三种主流交互方式,结合项目需求选择最优组合方案,确保开发成本与使用体验平衡。
4.1.1 主流交互方式分析
| 交互类型 | 核心特点 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|---|
| 配置面板类 | 预设页面可调整元素,右侧面板配置参数,实时同步效果 | 开发 / 使用成本低、容错率高、转码简单,适配标准化场景 | 局限性大,仅能在现有模板中配置,后期维护成本高 | C 类页面,纯标准化、低个性化需求 |
| 拖放式界面类 | 拖拽组件布局(支持预设 / 自由布局),灵活调整页面结构 | 自由度高、覆盖 A / B / C 类页面、原型还原准确 | 开发 / 转码难度高、容错率低,需结合属性面板使用 | A / B 类页面,有一定个性化需求 |
| 自然语言描述类 | 通过 "无格式文本" 或 "模板 PRD 格式" 描述需求,系统解析生成页面 | 学习成本低、操作高效,适配习惯文本操作的 PM | 准确性低、覆盖场景有限,不能单独作为核心交互方式 | 辅助配置,补充复杂场景的快速调整需求 |
4.1.2 最终方案选择
采用「配置面板 + 拖放式界面 + 自然语言交互」的组合方案,发挥三种方式的优势,协同作业、相互补充,分批次开发落地,降低初期开发成本,按需迭代:
- 物料准备:将已有样板间模板 + 基础组件库 + 业务组件库整合为可复用物料;
- 拖拽配置:基础组件库、业务组件库支持拖拽,可放置到模板任意位置;
- 参数调整:点击组件或模板,右侧配置面板可调整相关参数,实时同步效果;
- 辅助补充:复杂组件支持自然语言对话式修改,提升操作效率。
4.2 标准化页面设计参考
聚焦高频标准化页面------表格查询页,梳理核心组件结构及典型组合,为 PM 配置、开发落地提供参考。
4.2.1 表格查询页核心组件结构
| 组件 | 功能说明 | 核心配置项 |
|---|---|---|
| Input | 搜索输入框,用于快速检索表格数据 | 占位提示、输入长度限制、模糊搜索 |
| PageHeader | 页面头部,展示页面标题、操作按钮等 | 标题、副标题、操作按钮(如创建、导出) |
| Tab | 标签页切换,用于区分不同分类的数据 | 标签名称、默认选中项、切换逻辑 |
| Filter | 筛选条件区域,用于精准筛选表格数据 | 筛选字段、筛选类型、默认筛选条件 |
| Table | 数据展示表格,核心展示组件 | 列配置、行操作、分页设置、排序规则、筛选条件、行 / 列合并 |
4.2.2 典型组件组合示例
- 基础组合:Input + Tab + Filter + Table(适用于简单查询场景,无需复杂页面头部);
- 标准组合:PageHeader + Tab + Filter + Table(适用于大多数查询场景,含页面操作按钮);
- 简化组合:PageHeader + Tab + Table(适用于筛选条件少、数据展示为主的场景)。
五、总结:核心价值与实施路径
5.1 核心价值对比(V1.0 vs V2.0)
样板间 2.0 在 1.0 的基础上实现了从"标准化"到"自动化"的跨越,核心能力提升如下表所示:
| 能力维度 | V1.0 版本 | V2.0 版本 | 提升点 |
|---|---|---|---|
| PRD 输出 | 文本模板复制 | 可视化配置 + 实时预览 | 提升 PRD 准确性,降低编写成本 |
| 原型图 | 纯文本描述 | 真实页面截图 + 标准化 URL | 直观呈现页面效果,减少研发理解偏差 |
| PRD 格式规范 | 人工维护 | 平台自动生成 PRD 描述 | 保障格式统一,支持后续 AI 解析 |
| UI 规范 | 人工走查 | 自动化实时检测 | 避免规范返工,提升页面一致性 |
5.2 实施路径(分阶段落地)
为确保方案平稳落地,采用分阶段实施策略,逐步推进各核心能力,具体路径如下:
Phase 1:PRD 准确度提升
Phase 2:UI 规范度检测
Phase 3:UI 代码生成
Phase 4:CRUD 接口生成
各阶段核心目标:
- Phase 1:解决 PRD 准确性和标准化问题,落地浏览器插件和 PRD 可视化配置功能;
- Phase 2:实现 UI 规范自动化检测,在需求阶段规避规范问题;
- Phase 3:落地 UI 代码自动生成,提升前端研发效率;
- Phase 4:落地 CRUD 接口自动生成,打通前端与后端的自动化链路。
5.3 最终核心收益
样板间 2.0 的升级,不仅是功能的优化,更是产研全流程效率的重构,核心收益体现在四个方面:
- 效率提升:需求开发全周期缩短,重复编码、PRD 编写、UI 走查等冗余工作占比降低,产研人员聚焦核心业务逻辑;
- 体验提升:页面设计规范度统一,无设计师介入场景下也能保障页面质量,提升用户体验一致性;
- 质量提升:编码标准化程度提升,接口与需求一致性增强,线上问题率降低,研发质量更可控;
- 长期价值:构建 AI - ready 的数据基础,为后续智能开发(如 AI 生成个性化组件、智能排查问题)铺路,持续释放产研效能。