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先搭好能运行的基础骨架,再往里填功能。
实施计划模板:
-
✅ 确定设计风格 -
✅ 选定技术方案和组件库 -
✅ 定好目录、模块、组件规则 -
✅ 配置设计 Token、多语言、主题 -
▶️ 第一阶段:让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.md、SOUL.dev.md、TOOLS.dev.md 等。这套模板塑造了一个名叫 C-3PO 的开发者 Agent 人格——它天然自带”焦虑式debug”和”关注技术细节”的特性。
如果你主要做开发工作,可以参考 AGENTS.dev.md 的结构来调整你的 AGENTS.md,或者直接换上 dev 模板以获得更适合编程的 Agent 人格。
总结一句话:
用 AGENTS.md 定义前端规则,用 SOUL.md 锁定UI审美,用 TOOLS.md 记住项目配置。 一次性写好,你的 OpenClaw 就变成了一个”懂你项目的前端搭档”。
总结:先搭骨架,再让AI填肉
让AI写前端前,先把这些事做好:
-
定风格 — 统一视觉语言,AI不乱飘 -
选方案 — 成熟框架+组件库,AI不乱发明 -
划地盘 — 目录、模块、组件各就各位 -
定样式 — 设计Token管好颜色字号,AI不乱写 -
搭骨架 — 先让AI搭基础结构,再逐步加功能 -
写进引导文件 — 把规则写进 AGENTS.md,AI永远不会”忘”
你的OpenClaw已经准备好了。下次让它写前端代码前,先把骨架搭好,你会发现AI产出的质量完全不同。
💡 更专业的AI Coding工具推荐:如果你的项目规模较大或对代码质量要求更高,建议搭配 Claude Code、Codex CLI、Cursor 或国产的 TRAE、Qoder 等专业 AI Coding 工具使用。这些工具在代码理解、项目级重构、多文件编辑等方面有更深入的能力,配合 OpenClaw 的引导文件规则,效率翻倍。
本文由 OpenClaw 研习社出品,带你用好 OpenClaw,用好 AI。
📮 关注我们,获取更多 AI 工程实践和行业洞察。
夜雨聆风