乐于分享
好东西不私藏

OpenClaw Vibe Coding小技巧:前端骨架搭建,让AI写出整齐划一的代码

OpenClaw Vibe Coding小技巧:前端骨架搭建,让AI写出整齐划一的代码

📌 实战系列 | AI 写前端代码总是风格散乱、组件重复?问题不在 AI,在于你跳过了最关键的一步——搭建前端骨架。本文教你如何用 OpenClaw 的引导文件锁定规则,让 AI 写出整齐划一的代码。


🧩 为什么你的AI写的前端代码总是一团乱?

还在让AI直接一股脑写前端页面?在多页面复杂项目中,这种做法会让你很快陷入噩梦:风格散乱、组件重复、代码难以维护

这不是AI的问题,是你的方法错了。

正确的姿势是——先搭建前端骨架,再让AI填肉

所谓前端骨架,就是一套统一的视觉语言 + 技术规范 + 代码标准。有了它,AI才能按统一的风格和规则高质量输出代码,而不是每次都在”从零发明前端结构”。

第一步:定风格 — 别让AI自由发挥

设计风格是整个UI的统一视觉语言。你需要先明确产品偏向什么调性:

  • 🍎 玻璃/拟态风格 — 苹果生态,精致通透
  • 📐 Material Design — Google 系,规范成熟
  • 🏢 企业级风格 — 信息密度高、表格多,后台管理系统标配
  • 🎯 现代极简 — SaaS 产品最爱,卡片清晰、留白适中
  • 🤖 科技感风格 — AI 产品专属,深色背景+渐变+动效
  • 📱 内容信息流 — 社区类产品,阅读舒适、内容层级清晰

💡 技巧:不确定风格?找几张参考网站或APP截图扔给AI,让它帮你分析视觉特征。记住是”学习”不是”抄袭”。确定后所有页面必须围绕同一视觉语言开发,AI就不会左右横跳。

第二步:选技术栈 — 小白别头铁,用成熟方案

前端技术方案解决的是”项目怎么组织和运行”的问题。

场景 推荐方案
Web 应用 React / Vue / Next.js / Nuxt
小程序 微信原生 / Taro / uni-app

UI组件库解决的是”按钮、输入框、弹窗长啥样”的问题——这才是重点。

常见选择:

  • Ant Design / Element Plus / Naive UI — 开箱即用,省心
  • Radix UI — 无样式基础库,灵活度极高
  • shadcn/ui — 源码级组件,全在你掌控中
  • Tailwind UI — 模板型组件,抄改结合

⚠️ 血的教训:技术小白千万别让AI从零发明前端结构。成熟框架有一整套规范+最佳实践,AI只需遵守即可。明确告诉AI:遵守框架规范、优先复用组件库、不要手写重复组件。

第三步:划地盘 — 目录、模块、组件,一个都不能少

没有规划的AI写代码,就像一群人在一个大房间里各写各的——撞车是早晚的事。

目录边界

明确告诉AI:页面放哪、组件放哪、接口请求放哪、工具函数放哪、样式文件放哪。

src/
├── pages/       # 页面
├── components/  # 公共组件
├── api/         # 接口请求
├── utils/       # 工具函数
└── styles/      # 样式

模块边界

登录、用户、订单等功能区域要划清界限。每个模块自己管好自己的事,别跨域操作。

组件复用规则

UI相似度高且出现超过2次的组件 → 必须封装复用。这条规则不设定好,AI会写出10个长得一模一样的”用户卡片”组件。

第四步:定样式 — 别让AI硬编码颜色值

这是最容易翻车的一环。AI如果每次自己决定颜色值,你的页面就会变成”五彩斑斓的黑”。

设计 Token

统一管理颜色、字号、行距、间距、圆角等设计变量:

--color-primary: #1677ff;
--font-size-base: 14px;
--border-radius: 8px;
--spacing-md: 16px;

多语言规范

如果要做国际化,前端文案必须统一管理。AI自由发挥的结果就是:切换语言时布局错位、文案截断。

主题规则

确定主色调,并预留扩展方式。别让主题色散落在各页面CSS里——换主题时你会想死。

第五步:让AI搭基础结构,别上来就写功能

最后一步,也是最容易被跳过的:让AI先搭好能运行的基础骨架,再往里填功能。

实施计划模板:

  1. ✅ 确定设计风格
  2. ✅ 选定技术方案和组件库
  3. ✅ 定好目录、模块、组件规则
  4. ✅ 配置设计 Token、多语言、主题
  5. ▶️ 第一阶段:让AI搭建基础结构

第一阶段验收标准很简单:项目能启动、首页能打开、路由和目录符合规范、组件库和样式系统已接入。做到这些,再说加功能的事。


⚡ OpenClaw实操:用引导文件(Bootstrap Files)锁定前端规则

理论讲完了,关键问题是:这些规则怎么告诉AI?总不能每次写prompt都重复一遍吧?

在 OpenClaw 中,你的 Agent 有一套 Bootstrap Files(引导文件),它们是 Agent 的”潜意识”——每次启动新会话时自动加载到上下文里。你只需把前端骨架规则写进这些文件,AI 就会默认遵守,再也不用每次手动啰嗦。

这些文件是啥?

OpenClaw 工作区(默认路径 ~/.openclaw/workspace/)下的这些文件,每次新会话都会自动注入 Agent 的提示词中:

文件 用途 适合放前端规则吗?
AGENTS.md 操作指令 + 长期记忆 首选
SOUL.md 人设、语气、边界 ✅ 风格偏好
TOOLS.md 工具使用约定 ✅ 工具约定
USER.md 用户档案 ✅ 用户偏好
MEMORY.md 精炼长期记忆 ✅ 辅助

具体怎么配置?

在 AGENTS.md 中定义开发规则(推荐)

AGENTS.md 是 Agent 的核心操作手册。在里面添加一个”前端开发规范”章节即可。以下模板可直接复制到你的 AGENTS.md

📋 前端开发规范

技术栈
框架:React + TypeScript + Next.js
UI组件库:Ant Design(优先复用组件)
样式方案:CSS Modules + CSS Variables 设计Token

目录结构规范
src/pages/ → 页面组件
src/components/ → 公共组件(出现2次以上必须封装复用)
src/api/ → API请求层
src/utils/ → 工具函数
src/styles/ → 全局样式 + 设计Token

设计 Token(禁止硬编码颜色/字号)
–color-primary: #1677ff
–font-size-base: 14px
–border-radius: 8px

组件规则
页面组件放 pages/,公共组件放 components/
组件命名:PascalCase,文件与组件名一致
超过2处使用的UI片段 → 提取为公共组件
禁止重复手写相同代码片段

🔑 关键点:只要写进 AGENTS.md,AI 每次写代码都会自动遵守这些规则,不会”忘记”。

在 SOUL.md 中设定UI审美

如果想让 AI 写出更统一的代码风格,SOUL.md 里也可以加一条:

前端代码风格
代码风格:整洁、注释清晰、类型安全
UI审美:简洁现代,参考 Ant Design 设计语言
组件设计:高内聚低耦合,逻辑与视图分离

在 TOOLS.md 中记录项目环境

前端项目
项目路径: ~/projects/my-app
启动命令: pnpm dev
查页面效果: web_fetch http://localhost:3000[1]

关于 OpenClaw 的开发者模板

OpenClaw 安装包中附带了一套 dev 模式的备选模板(以 .dev.md 为后缀),包括 AGENTS.dev.mdSOUL.dev.mdTOOLS.dev.md 等。这套模板塑造了一个名叫 C-3PO 的开发者 Agent 人格——它天然自带”焦虑式debug”和”关注技术细节”的特性。

如果你主要做开发工作,可以参考 AGENTS.dev.md 的结构来调整你的 AGENTS.md,或者直接换上 dev 模板以获得更适合编程的 Agent 人格。

总结一句话:

用 AGENTS.md 定义前端规则,用 SOUL.md 锁定UI审美,用 TOOLS.md 记住项目配置。 一次性写好,你的 OpenClaw 就变成了一个”懂你项目的前端搭档”。


总结:先搭骨架,再让AI填肉

让AI写前端前,先把这些事做好:

  1. 定风格 — 统一视觉语言,AI不乱飘
  2. 选方案 — 成熟框架+组件库,AI不乱发明
  3. 划地盘 — 目录、模块、组件各就各位
  4. 定样式 — 设计Token管好颜色字号,AI不乱写
  5. 搭骨架 — 先让AI搭基础结构,再逐步加功能
  6. 写进引导文件 — 把规则写进 AGENTS.md,AI永远不会”忘”

你的OpenClaw已经准备好了。下次让它写前端代码前,先把骨架搭好,你会发现AI产出的质量完全不同。

💡 更专业的AI Coding工具推荐:如果你的项目规模较大或对代码质量要求更高,建议搭配 Claude CodeCodex CLICursor 或国产的 TRAEQoder 等专业 AI Coding 工具使用。这些工具在代码理解、项目级重构、多文件编辑等方面有更深入的能力,配合 OpenClaw 的引导文件规则,效率翻倍。


本文由 OpenClaw 研习社出品,带你用好 OpenClaw,用好 AI。

📮 关注我们,获取更多 AI 工程实践和行业洞察。