用 Vibe Coding 完成研发任务

这一组子文档讲的是：在 Vibe Coding 工具里，如何把研发需求交给 Agent，让它调用 rabetbase 能力完成数据集、SQL、BFF、系统页面开发、代码生成和菜单同步等任务。读者不需要手动拼命令，也不需要记参数；重点是把业务目标、约束和验收标准说清楚。

使用方式：打开 Codex、Claude Code、Trae 或 Cursor，把需求按文档里的 Prompt 描述给 Agent。Agent 会负责检查项目、选择合适能力、预览风险、执行变更并反馈结果。

这组文档应该怎么读

开发任务	子文档	你要告诉 Agent 什么	完成后应看到什么
看清数据与接口	API 与数据集：拉配置、看清数据	要同步哪个项目、要查哪个数据集、要确认哪些字段或操作。	本地 API 配置已对齐，字段、操作和表关系被说明清楚。
沉淀查询能力	自定义 SQL：从写到执行	业务要查什么、入参是什么、期望返回哪些字段、是否需要保存成平台 SQL。	SQL 已校验、已保存或已更新，并能用示例参数试跑。
封装服务端逻辑	BFF 脚本：本地与远端同步	要新增或修改哪类服务端逻辑、输入输出、复用规则和发布范围。	本地脚本与平台状态清楚，变更已预览，确认后同步到平台。
开发系统页面	系统页面开发：用 SDK 完成业务页面	页面要解决什么问题、用哪些数据、需要哪些交互状态和验收路径。	页面已接入 Lovrabet SDK，数据读写、状态处理和本地验证路径清楚。
生成调用与同步入口	代码生成与菜单	要生成哪段调用代码、放到哪里、页面菜单或资源地址要如何对齐。	TypeScript 调用片段、菜单结构或线上资源引用已完成并可验证。

Prompt 写法

一个好 Prompt 通常包含四件事：业务目标、对象范围、约束条件和验收标准。

请帮我开发一个客户列表页。
背景是：销售需要按客户等级、负责人和最近跟进时间筛选客户，并快速看到客户最近一次跟进情况。
对象是：客户、联系人、跟进记录、客户活跃度统计 SQL、客户跟进摘要 BFF 和客户列表页菜单。
约束是：不要使用 mock 数据；写入前先确认可写字段；菜单和资源更新前先预览影响范围。
完成后请告诉我：改了哪些文件，页面路由是什么，本地如何验证，还有哪些风险需要确认。

AI 可能调用的 CLI 能力（按任务选择）：rabetbase api、rabetbase dataset、rabetbase sql、rabetbase bff、rabetbase codegen、rabetbase run、rabetbase menu。

不要这样使用

• 不要把文档当成命令参数手册逐条照抄。
• 不要只说“帮我处理一下”，要说明业务对象、期望结果和验收方式。
• 不要把敏感信息、密钥、个人路径写进 Prompt；用占位符描述即可。
• 涉及写入、删除、覆盖、发布时，要求 Agent 先预览影响，再执行。

推荐工作流

1. 先描述业务目标，让 Agent 查清数据集、字段、操作和关系。
2. 需要复杂查询时，让 Agent 设计并校验平台托管 SQL。
3. 需要服务端逻辑时，让 Agent 新增或修改 BFF，并说明本地与平台差异。
4. 开发系统页面时，让 Agent 使用 SDK 接入真实数据，并补齐页面状态和验证路径。
5. 前端接入时，让 Agent 生成调用片段，放到指定文件或页面中。
6. 上线前，让 Agent 检查菜单、资源引用和验证路径。

子文档列表

<sub-page-list space-id="7535363963853209604" wiki-token="S71hw5c2HiwyoHkLgyecKrI8n3M"><sub-page doc-id="HOIEdnXNDoNEbsxlIcAcsYhNnUd" file-type="docx" title="API 与数据集：拉配置、看清数据"/><sub-page doc-id="WgMjd6rzooJPiaxgRIYcKGk1nYg" file-type="docx" title="系统页面开发：用 SDK 完成业务页面"/><sub-page doc-id="U69vdbaq9oYz2SxC1sXcwTDynQd" file-type="docx" title="BFF 脚本：本地与远端同步"/><sub-page doc-id="LiETd90f9oWk8Vx3UQUcPe7nn7b" file-type="docx" title="自定义 SQL：从写到执行"/><sub-page doc-id="DAHxdf4C8oqKwAxBU7PcfjpDnQb" file-type="docx" title="代码生成与菜单"/></sub-page-list>