TIP

你已经创建了项目工程（或接手了一个已有工程），在 Claude Code、Codex、Trae、Cursor 里打开项目目录。接下来你需要做的不是学 rabetbase 命令，而是把下面的 prompt 交给 AI——AI 会自己读项目配置、数据模型和已有代码，完成后面的工作。

开始之前：先让 AI 确认项目状态

不要先问 AI 应该敲什么命令。先让它读一遍项目事实，确认能开发。

INFO

直接对 AI 说：

请检查当前目录是否已经具备 Rabetbase 项目开发条件。
确认项目结构、Lovrabet 应用绑定、环境、数据模型、页面目录、本地脚本、Backend Function 和 SQL 管理目录。
如果缺少准备工作，请按影响程度列出来，并说明下一步需要我确认什么。

AI 返回结果里至少要包含：

• 当前目录是不是 Rabetbase 项目工程
• 项目绑定的 Lovrabet 应用和环境
• 数据模型是否已同步到本地
• 页面入口、构建脚本和本地调试是否可用
• Backend Function 和 SQL 是否已有本地受管目录

如果 AI 直接开始写代码，让它停下来。

让 AI 同步并检查业务模型

Lovrabet 平台已经有你的业务模型——数据集、字段、枚举、关联关系。让 AI 拉取这些事实，而不是猜字段名。

INFO

直接对 AI 说：

请同步并检查当前 Lovrabet 应用的数据模型。
拉取所有的API列表到本地；
围绕我要开发的功能，列出相关数据集、字段名、显示名、字段类型、必填项、枚举值、关联关系和可用操作。
标出哪些字段可以写入，哪些字段由平台自动维护。

验收重点：

• 字段名来自平台，不来自猜测
• 枚举写入用 value，展示用 label
• 外键来自真实关联关系

WARNING

如果 AI 开始猜字段：

请先停止写代码。
重新读取相关数据集字段、枚举值、必填项和关联关系。
把当前代码里所有猜测字段列出来，确认后再修改。

开发页面

告诉 AI 你要什么页面、有什么内容、数据从哪来。AI 会基于项目已有的 React 工程和 SDK 客户端生成页面代码。

INFO

直接对 AI 说：

请基于当前项目新增一个 <页面名称> 页面。
页面需要包含 <筛选区 / 列表 / 详情抽屉 / 表单 / 图表>。
数据读写使用项目里的 Lovrabet SDK 客户端。
先检查数据集字段、枚举和关联关系，不要使用 mock 数据。
完成后说明新增或修改了哪些文件、页面路由是什么、还有哪些未验证风险。

页面完成后，让 AI 自查：

• 是否使用真实数据接口
• 是否处理加载、空态、错误态和权限不足
• 是否避免循环单条查询
• 是否符合项目已有 UI 和路由风格

WARNING

如果页面看起来完成但实际在用 mock 数据：

请检查这个页面是否仍在使用 mock、静态数组或临时数据。
如果有，请改成 Lovrabet SDK 或 Backend Function 的真实调用，并说明权限或环境是否阻断。

本地调试

页面写完后先在本地跑起来，不要直接跳去平台配置。

INFO

直接对 AI 说：

请启动当前项目的本地开发环境。
如果端口被占用，请换一个可用端口。
启动后告诉我访问地址，并检查首页、目标页面路由、接口请求和浏览器控制台错误。

如果打不开，让 AI 优先检查端口、证书、依赖和当前路由。

封装 Backend Function

当页面需要校验、事务、多表写入、脱敏、权限或外部集成时，把逻辑封装成 Backend Function——不要让 AI 在页面代码里硬塞复杂事务。

INFO

直接对 AI 说：

请帮我设计一个 <功能名称> Backend Function。
先判断它应该是 ENDPOINT、HOOK 还是 COMMON。
检查相关数据集字段、必填项、枚举值、关联关系和权限边界，再生成本地脚本。
推送前先做状态检查和预览，并说明它会影响哪些数据集或接口。

WARNING

如果不知道该写 SQL 还是 Backend Function：

请先判断标准数据操作是否足够。
如果目标是复杂查询或统计，评估 SQL。
如果目标是事务、校验、脱敏、多表写入或外部系统集成，评估 Backend Function。
给出推荐方案和风险。

编写自定义 SQL

标准数据操作无法表达复杂统计、聚合或联表查询时，让 AI 评估 SQL。

INFO

直接对 AI 说：

请帮我设计一个 <查询目标> 自定义 SQL。
先确认标准数据操作或已有 SQL 是否能复用。
如果必须新写，请先校验数据集来源、表名、字段名、筛选条件和风险。
完成后把 SQL 放到项目同步目录，并在推送前给我预览。

SQL 适合查询和统计，不适合绕过业务模型做随意写入。涉及删除、清空或批量替换时，先停下来做风险确认。

构建打包并接入主应用

本地验证通过后，让 AI 做生产构建和接入检查。

INFO

直接对 AI 说：

请为当前项目做一次生产构建。
构建后检查 dist 目录、JS/CSS 产物、模块格式和资源路径。
如果我要接入 Lovrabet 主应用，请告诉我页面路由、微应用唯一标识、资源加载方式和需要配置的资源 URL。

接入主应用前确认：

• 页面路由和本地文件路由一致
• JS/CSS 资源 URL 可以直接访问
• 资源加载方式符合微前端产物
• 嵌入主应用后不会重复显示本地外层导航

发布前检查

功能完成后，让 AI 做一次从本地到平台的闭环检查。

INFO

直接对 AI 说：

请对这次改动做发布前检查。
检查页面路由、数据模型、SDK 调用、Backend Function、SQL、构建产物、菜单资源和高风险写入。
把通过项、阻断项、未验证项分开列出来，不要把环境阻断写成已通过。

发布前至少看到：

• 页面可本地访问
• 字段、枚举、外键都来自平台事实
• 没有用 mock 数据冒充真实接入
• 构建产物已生成，资源路径明确
• Backend Function 和 SQL 的写入动作已做预览和确认
• 不能验证的部分被明确标为环境阻断或权限阻断