11---
2- cloudbaseAIVersion:1.8.36
32description: CloudBase AI 开发规则指南 - 提供场景化的最佳实践,确保开发质量
43globs: *
54alwaysApply: true
@@ -19,21 +18,22 @@ alwaysApply: true
1918
2019### 1. 场景识别
2120首先需要识别当前的开发场景类型:
22- - **Web 项目**:React/Vue/原生 JS 等前端项目
23- - **微信小程序**:小程序云开发项目
21+ - **Web 项目**:React/Vue/原生 JS 等前端项目(**注意**:所有 Web 项目涉及页面/界面生成时,必须同时参考 UI 设计规则)
22+ - **微信小程序**:小程序云开发项目(**注意**:所有小程序项目涉及页面/界面生成时,必须同时参考 UI 设计规则)
2423- **云托管项目**:CloudBase Run 后端服务项目(支持 Java/Go/Python/Node.js/PHP/.NET 等任意语言,适合 WebSocket 长连接、长耗时任务、需要连接数据库/消息队列等场景)
2524- **数据库相关**:涉及数据操作的项目
26- - **UI 设计**:需要界面设计的项目
25+ - **UI 设计/界面生成 **:需要界面设计的项目、生成页面、创建原型、设计组件等(**强制适用**:所有涉及前端界面、页面、组件、样式的开发任务)
2726
2827### 2. 规则文件选择
2928根据识别的场景,需要参考对应的专业规则文件:
3029
3130**📋 场景规则映射表(必须遵守):**
32- - **Web 项目** → 必读:`rules/web-development.mdc` + `rules/cloudbase-platform.mdc`
33- - **微信小程序** → 必读:`rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc`
34- - **云托管项目** → 必读:`rules/cloudrun-development.mdc` + `rules/cloudbase-platform.mdc`
31+ - **Web 项目** → 必读:`rules/web-development.mdc` + `rules/cloudbase-platform.mdc` + **`rules/ui-design.mdc`**(生成页面/界面时强制参考)
32+ - **微信小程序(小程序+ CloudBase) ** → 必读:`rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc` + **`rules/ui-design.mdc`**(生成页面/界面时强制参考)
33+ - **云托管项目(部署后端服务) ** → 必读:`rules/cloudrun-development.mdc` + `rules/cloudbase-platform.mdc`
3534- **数据库操作** → 额外读:`rules/database.mdc`
36- - **UI 设计** → 额外读:`rules/ui-design.mdc`
35+ - **MySQL数据库操作** → 额外读:`rules/data-model-creation.mdc`
36+ - **UI 设计/界面生成** → **强制必读**:`rules/ui-design.mdc`(所有涉及页面、界面、组件、样式、原型设计的任务)
3737
3838### 3. 开发确认
3939在开始工作前建议向用户确认:
@@ -51,14 +51,15 @@ alwaysApply: true
51517. **认证规则**:当用户开发项目的时候,如果用到用户登录认证,需要用到内置的认证功能,必须严格区分平台的认证方式
5252 - **Web 项目**:必须使用 CloudBase Web SDK 内置认证(如 `auth.toDefaultLoginPage()`)
5353 - **小程序项目**:天然免登录,云函数中获取 `wxContext.OPENID`
54+ 8. **UI 设计规则强制应用**:当任务涉及生成页面、界面、组件、样式或任何前端视觉元素时,**必须首先阅读并严格遵循 `rules/ui-design.mdc` 规则文件**,确保生成具有独特美学风格和高质量视觉设计的界面,避免通用 AI 美学
5455
5556## 工作流
5657
5758你会根据用户的需求智能判断使用哪种模式来开发,默认情况下采用 spec 来开发
5859
5960**智能判断标准:**
60- - **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
61- - **跳过 spec**:简单修复、文档更新、配置修改、代码重构
61+ - **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计(**注意**:涉及 UI 设计时,spec 流程中必须参考 `rules/ui-design.mdc`)
62+ - **跳过 spec**:简单修复、文档更新、配置修改、代码重构(**注意**:即使是简单修复,如果涉及界面/样式修改,也必须参考 `rules/ui-design.mdc`)
6263
6364### Workflow 命令控制
6465
@@ -75,7 +76,7 @@ alwaysApply: true
75760. 请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;
76771. 如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作, 必要时向我确认,可以采用 interactiveDialog 工具来收集
77782. 每当我输入新的需求的时候,为了规范需求质量和验收标准,必须首先会搞清楚问题和需求,必须跟我确认之后,然后再进入下一阶段
78- 3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,需要在需求中提前确定好设计风格和配色 ,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,跟我确认清楚后,才继续进入下一个阶段,参考格式如下
79+ 3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,**必须严格参考 `rules/ui-design.mdc` 规则文件**,在需求中提前确定好设计风格和配色 ,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,跟我确认清楚后,才继续进入下一个阶段,参考格式如下
7980
8081```markdown
8182# 需求文档
@@ -120,6 +121,8 @@ alwaysApply: true
120121
1211222. **小程序 TabBar等素材下载下载远程素材链接**:小程序的 Tabbar 等素材图片,必须使用 **png** 格式,必须使用 downloadRemoteFile 工具下载文件到本地,可以从 Unsplash、wikimedia【一般选用 500 大小即可、Pexels、Apple 官方 UI 等资源中选择
122123
124+ **重要提醒**:在生成任何页面、界面、组件或样式之前,必须首先阅读并理解 `rules/ui-design.mdc` 规则文件,确保遵循设计思维框架和前端美学指南,避免生成通用 AI 美学风格的界面。
125+
123126如果应用中需要远程链接,可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
124127
1251283. **从知识库查询专业知识**: 如果对于云开发某块知识不确定,可以使用 searchKnowledgeBase 工具智能检索云开发知识库(支持云开发与云函数、小程序前端知识等),通过向量搜索快速获取专业文档与答案
@@ -135,7 +138,9 @@ alwaysApply: true
135138### 部署流程
1361391. **部署云函数流程**:可以通过 getFunctionList MCP 工具来查询是否有云函数,然后直接调用 createFunction 或者 updateFunctionCode 更新云函数代码,只需要将functionRootPath 指向云函数目录的父目录(例如 cloudfuncitons 这个目录的绝对路径),不需要压缩代码等操作,上述工具会自动读取云函数父目录下的云函数同名目录的文件,并自动进行部署
137140
138- 2. **部署静态托管流程**:通过使用 uploadFiles 工具部署,部署完毕后提醒用户 CDN 有几分钟缓存,可以生成一个带有随机 queryString 的markdown 格式 访问链接
141+ 2. **部署云托管流程**:对于非云函数的后端服务(Java、Go、PHP、Python、Node.js等),使用 manageCloudRun 工具进行部署。确保后端代码支持 CORS,准备好 Dockerfile,然后调用 manageCloudRun 进行容器化部署
142+
143+ 3. **部署静态托管流程**:通过使用 uploadFiles 工具部署,部署完毕后提醒用户 CDN 有几分钟缓存,可以生成一个带有随机 queryString 的markdown 格式 访问链接
139144
140145
141146### 文档生成规则
@@ -160,10 +165,10 @@ alwaysApply: true
160165## 🔍 专业规则文件详细说明
161166
162167## 使用指导
163- - **Web 项目开发**:主要参考 `rules/web-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`
164- - **微信小程序开发**:主要参考 `rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`
168+ - **Web 项目开发**:主要参考 `rules/web-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc` + **`rules/ui-design.mdc`**(生成页面/界面时强制参考)
169+ - **微信小程序开发**:主要参考 `rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc` + **`rules/ui-design.mdc`**(生成页面/界面时强制参考)
165170- **数据库相关**:额外参考 `rules/database.mdc`, MySQL 数据库参考 `rules/data-model-creation.mdc`
166- - **UI 设计需求 **:额外参考 `rules/ui-design.mdc`
171+ - **UI 设计/界面生成 **:**强制必读** `rules/ui-design.mdc`(适用于所有页面、界面、组件、样式、原型设计任务)
167172- **数据模型建模**:额外参考 `rules/data-model-creation.mdc`
168173
169174
@@ -197,9 +202,21 @@ alwaysApply: true
197202- 错误处理和数据更新
198203
199204### 🎨 rules/ui-design.mdc
200- **条件必读**:需要界面设计时
201- - 高保真原型设计
202- - UI/UX 规范和样式处理
205+ **强制必读**:所有涉及界面、页面、组件、样式生成的任务
206+ - **适用场景**:
207+ - 生成 Web 页面或界面时
208+ - 生成小程序页面或界面时
209+ - 创建前端组件时
210+ - 设计原型或界面时
211+ - 处理样式和视觉效果时
212+ - 任何涉及用户界面的开发任务
213+ - **核心内容**:
214+ - 设计思维框架(目的分析、风格定位、技术约束、差异化思考)
215+ - 完整的设计流程(用户体验分析、产品界面规划、美学方向确定、高保真 UI 设计、前端原型实现)
216+ - 前端美学指南(字体设计、色彩与主题、动效设计、空间布局、背景与视觉细节)
217+ - 避免通用 AI 美学(禁止使用过度常见的字体、陈词滥调的色彩方案、模板化设计)
218+ - 创意实施原则(创造性解释、避免重复、复杂度匹配)
219+ - **特别注意**:在开始任何界面/页面生成工作前,必须先阅读并严格遵循此规则文件,确保生成具有独特美学风格和高质量视觉设计的界面
203220
204221### rules/data-model-creation.mdc
205222描述数据模型AI建模和创建的专业规则,包含:
@@ -218,14 +235,17 @@ alwaysApply: true
218235### ✅ 推荐完成的步骤
2192360. **[ ] 环境检查**:调用 `envQuery` 工具检查云开发环境状态(适用于所有交互)
2202371. **[ ] 场景识别**:明确当前是什么类型的项目(Web/小程序/数据库/UI)
221- 2. **[ ] 规则声明**:明确列出将要遵循的规则文件清单
222- 3. **[ ] 用户确认**:向用户确认场景识别和规则选择是否正确
223- 4. **[ ] 规则执行**:严格按照选定的规则文件进行开发
238+ 2. **[ ] 规则声明**:明确列出将要遵循的规则文件清单
239+ - **特别注意**:如果涉及页面/界面生成,必须明确声明将参考 `rules/ui-design.mdc`
240+ 3. **[ ] UI 设计规则检查**:如果任务涉及生成页面、界面、组件或样式,必须确认已阅读并理解 `rules/ui-design.mdc` 规则
241+ 4. **[ ] 用户确认**:向用户确认场景识别和规则选择是否正确
242+ 5. **[ ] 规则执行**:严格按照选定的规则文件进行开发
224243
225244### ⚠️ 常见问题避免
226245- 避免跳过场景识别直接开始开发
227246- 避免混用不同平台的 API 和认证方式
228247- 避免忽略专业规则文件的指导
248+ - **避免在生成页面/界面时忽略 UI 设计规则**:所有涉及界面、页面、组件、样式的任务,必须严格参考 `rules/ui-design.mdc`
229249- 重要技术方案建议与用户确认
230250
231251### 🔄 质量保障
0 commit comments