online branch: main

2026-11-18

RSS llms.txt GitHub

AI 做的原型,怎样才能让前端接着用?

$
模块组合成前端界面的文章封面

产品经理用 AI 做出一个原型,页面看起来已经很像产品。需求评审通过后,开发打开代码,却发现表格是自己画的,弹窗是一套临时样式,筛选和权限也只是演示。于是,页面又要重新做一遍。

这并不奇怪。AI 生成页面时,只能使用它拿得到、看得懂的材料。如果它拿到的是截图和几句“遵循智投风格”,它就只能模仿外观;如果它能使用真实组件、业务模式和可运行的项目模板,原型就有机会成为前端工作的起点。

Meta 开源的 Astryx 给了我们一个很好的观察对象。它不仅提供设计规范,还把组件、示例、页面模板和查询工具连接起来,让人和 Agent 都能在制作界面时使用同一套系统。

对智投这样的产品,值得追求的目标不是让 AI 一次生成能直接上线的页面,而是让产品原型里已经确认的界面结构、组件和交互,尽可能保留到开发阶段。要做到这一点,首先需要明确:哪些资产是真实可复用的代码,哪些只是外观相似的示例。

Astryx 的启发:把规范放进生成过程

Astryx 是 Meta 开源的设计系统,目前处于 Beta,基于 React 和 StyleX。官网提供组件、主题和页面模板,也提供给 Agent 使用的工具入口。它的 CLI 能查询组件文档、设计变量和模板,并提供机器可用的接口。

这几部分放在一起才有意义:

  • 设计变量定义颜色、字号和间距等基础规则。
  • 组件代码提供按钮、表格、弹窗等实际可运行的能力。
  • 使用说明和示例告诉人和 AI,组件适合解决什么问题、有哪些状态、如何组合。
  • 工具和 Skill让 Agent 在生成时找到这些材料,而不是只依靠训练记忆猜测。

Astryx 也在 v0 中以设计系统 Skill 的方式提供指导、组件、示例和模板,让这些内容进入生成界面的上下文。来源

对智投的启发,是把现有规则变成生成过程中的工作材料。我们不必因此把产品迁移到 Astryx;更需要借鉴它连接规范、代码和工具的方式,并基于自己的技术栈建设。

智投已经有基础,缺口在代码衔接

本地已有的智投设计资料包含视觉规范、图标、原型组件和一个设计 Skill。Skill 能指导 Agent 使用品牌色、布局和现成的 JSX 组件制作界面。这些资产已经解决了一个重要问题:让不同原型更接近同一套产品语言。

但查到的一份智投前端历史研究快照使用 Vue 3、Element Plus 和 Vite,而设计资料中的原型组件采用 JSX。两者可以参考同一套视觉规则,却不能仅因为看起来相似,就把 JSX 原型组件直接当作 Vue 前端组件使用。

这里有两个需要分开的判断:

  1. 视觉复用:原型与产品使用相同的颜色、布局和交互表达,方便评审。
  2. 代码复用:原型直接引用项目可用的组件和接口契约,开发时能保留对应代码。

前者已经有积累;后者需要先核对当前前端仓库、组件版本和实际使用方式。历史快照不能证明现网仍使用完全相同的实现。现有规范里也有从设计稿推断的交互细节,应由设计和研发核实后再作为正式规则。

这不是要求所有探索都进入工程。早期讨论一个大胆的新流程,静态页面可能足够;当需求进入评审和开发衔接阶段,才更需要使用真实组件和可运行代码。两种产物可以并存,但应标清各自的用途。

规范应该建设成哪几层?

设计规范的五个层次

我会把它拆成五层。前四层提供材料,第五层保证材料能持续使用。

层次 要解决的问题 可交付的资产
基础变量 页面看起来是否属于同一个产品 颜色、字号、间距、图标、层级等变量及使用说明
真实组件 按钮、表格、弹窗是否使用同一份实现 组件代码、版本、参数、事件、示例和状态
页面模式 常见页面如何组合组件 列表筛选、新建表单、详情抽屉、批量操作等可运行模板
业务规则 界面行为是否符合实际任务 字段含义、权限、状态变化、校验与异常处理规则
检查与维护 生成结果是否可信、规范是否过期 构建检查、交互检查、负责人、版本和更新机制

这五层的来源不能都靠一份长文档维护。组件参数应该能指向真实代码或由代码生成;业务规则应该指向已确认的需求或产品规则;页面模板应该能运行,并与引用的组件版本对应。文档负责解释和导航,不重复维护另一份容易过期的组件实现。

例如,规范中写“使用智投表格”还不够。Agent 至少要知道:表格组件从哪里引入,列如何配置,分页和排序由谁负责,加载、空数据和错误状态如何呈现。没有这些信息,它仍然会自己猜。

规范还应允许例外。当现有组件无法支持新场景时,Skill 应说明缺口,使用明确标记的临时实现,并把组件补充建议交给设计和研发判断。把所有创新都硬塞进旧组件,同样会妨碍产品设计。

用一个列表页,看清哪些代码可以留下

假设要做一个“任务列表”:用户可以筛选、查看状态、打开详情,并对允许操作的任务执行重试。下面是建议的拆法,具体权限和状态需要按真实需求确认。

第一步,复用页面骨架。 使用当前项目认可的页面容器、标题区、筛选区和表格组件。字段、列和筛选项作为配置或页面代码传入。这样评审时看到的页面结构,开发可以继续使用。

第二步,隔离演示数据。 页面通过明确的数据接口读取列表,原型阶段由模拟服务提供数据。数据类型、筛选参数和返回格式应清楚标注;真实接口未确认时,把它标为待确认的草案,不能把模拟数据当作后端承诺。

第三步,补齐状态。 至少演示加载中、没有数据、筛选无结果和请求失败;涉及重试时,还要说明操作中、成功、失败以及是否允许再次操作。无权限的用户能看到什么、按钮如何呈现,也要来自已确认规则。

第四步,保留交付边界。 前端接入时替换模拟数据服务,核对接口、权限和实际状态转换;经过构建、交互和业务验收后再合并。是否能直接保留某段代码,以研发检查结果为准。

这里真正想复用的,不只是页面长相。列表结构、组件组合、字段定义和已经确认的交互路径,都可以成为后续开发的起点。真正接入数据后,性能、错误处理和安全检查仍然需要做。

把规则落成 Agent 能查的文件

下面是一份示意,不是智投现有组件的实际路径或参数。假设团队已核对并确认任务表格组件,可以在组件目录中维护一条记录:

name: TaskTable
status: approved
version: 与前端项目依赖版本一致
source: src/components/TaskTable.vue  # 示例路径,需核实
purpose: 展示任务列表和行操作
inputs: [rows, loading, pagination]
events: [page-change, retry]
states: [loading, empty, error, ready]
example: examples/task-list.vue
owner: 前端组件负责人

这条记录应链接到真实代码与可运行示例;具体参数以当前代码为准,变更时由组件负责人同步更新。状态和事件还要写清使用条件,不能只列名称。例如,retry 何时显示、失败后如何恢复,需要引用已确认的业务规则。

配套的 Skill 目录可以保持简单:

ztool-prototype/
├── SKILL.md                 # 触发条件、工作步骤和交付要求
├── references/
│   ├── component-index.md   # 组件入口与版本来源
│   ├── page-patterns.md     # 列表、表单等页面模式
│   └── state-checklist.md   # 状态与权限检查
└── examples/
    └── task-list.vue        # 可运行示例,随依赖版本验证

SKILL.md 中可以写一条具体指令:“制作列表页时,先查组件索引和列表模式;优先引用当前项目已有组件;缺少真实参数时查源码,不确定就列为待确认;完成后运行项目构建并记录验证结果。”目录和文件本身不会自动保证正确,还需要在组件变更时检查示例能否构建。

Skill 应该如何工作?

Skill 从任务识别到交付的工作流程

Skill 可以理解成 Agent 的工作说明书。它不需要把所有组件文档塞进一段提示词,而应告诉 Agent:什么时候查什么,使用哪个版本,生成后如何验证。

一个适合智投的原型 Skill,可以按以下顺序工作:

  1. 识别任务阶段:是快速探索、需求评审,还是准备交付研发?前者可以轻量;后两者优先使用可运行的前端组件。
  2. 确定真实来源:读取当前项目说明、依赖版本、组件目录和对应规范。找不到或版本冲突时,明确提示,不自行编造组件 API。
  3. 检索并组合:先查页面模式,再查组件的参数、事件和示例;优先复用已有实现,不存在时标记新增或临时实现。
  4. 梳理业务状态:根据需求列出主要路径、空态、加载、失败和权限边界;未知规则集中记录,避免把假设伪装成已确认需求。
  5. 生成可运行页面:使用与目标工程兼容的技术栈,把页面、模拟数据和真实接口适配层分开,并提供可启动方式。
  6. 检查与交付:运行可用的构建和静态检查,打开页面核对主要交互;交付时列出复用的组件、模拟部分、未确认规则和接入待办。

例如,同样一句“做一个任务列表”,一个普通提示词可能只生成表格和几行假数据;上述 Skill 则会先查项目中表格与页面模式,再检查筛选、空态、失败和权限,并交付可运行代码及待确认事项。

Skill 也有边界:它能组织材料和检查流程,却不能保证规范本身正确。如果组件示例过期、业务规则没有负责人,Agent 只会更快地重复错误。因此,组件维护、业务确认和最终代码审查仍需要明确的人负责。

从一个页面试点,而不是先建一座组件城

建设顺序可以小一些,也更容易判断是否有效。

先盘点。 以前端当前主分支为准,确认技术栈、已有组件、页面模式和设计规范;对照现有原型 Skill,标出可复用、需要更新和只适合演示的资产。设计师和前端共同确认权威来源。

再选一个高频页面。 可以从列表与筛选场景开始,范围控制在一个真实需求内。补齐页面模板、核心组件说明、模拟数据接口和状态示例,同时明确由谁维护。

然后建设 Skill 最小版本。 先支持查找组件、生成页面、检查状态和输出交付说明。暂时用仓库内文档和示例即可;等检索困难、版本管理确有需要时,再评估是否建设 CLI 或 MCP 服务。

最后用实际交付检验。 让产品、设计、前端共同完成一个从原型到开发的闭环。记录最终保留了哪些原型代码、哪些必须重写,以及原因;同时看评审发现的问题、开发返工和关键状态遗漏。选相近需求作对照,记录任务范围与参与人员,积累样本后再判断是否省时。

这里有一个实际取舍:直接在生产仓库生成代码,组件和构建环境最接近真实开发,但也需要遵守分支、权限和代码审查流程;独立原型工程更安全、方便分享,但必须固定依赖版本,并定期验证它与主工程是否兼容。团队可以先选择现有工程条件允许的一种,不必一开始就把所有系统打通。

原型的终点,是一份共同理解

AI 让做页面更快,也让一份不准确的规范更容易被大量复制。相比继续追求“生成得像不像”,产品团队更值得投资的是:让规范有明确来源,让组件真实可运行,让业务状态可以检查,让生成结果能交给下一个人继续工作。

当产品经理、设计师和开发使用同一套材料,原型就不再只是评审时的一张图。它可以成为一份逐步被确认、被验证、被接入真实数据的界面。至于最终能复用多少,要通过具体项目和代码审查回答。

参考资料:Astryx 官网 · 组件目录 · CLI 文档 · Astryx 与 v0 · 渐进迁移指南