BFF 脚本：本地与远端同步

这一节说明如何让 Agent 帮你开发和同步平台上的 BFF 脚本。你不需要记脚本同步命令；只要说明要新增、修改、复用或发布哪段服务端逻辑，Agent 会检查本地文件、平台资源和风险。

适合交给 Agent 的任务

• 检查本地 BFF 脚本和平台上是否一致。
• 新增一个接口类脚本，给前端或页面调用。
• 把重复逻辑抽成公共函数。
• 为数据集操作增加钩子逻辑。
• 把本地修改同步到平台，或把平台脚本拉回本地。

准备工作

• 已经打开目标项目，并确认这是要修改的应用。
• 知道本次服务端逻辑的输入、输出和调用方。
• 涉及线上影响时，先要求 Agent 预览差异和风险。

常用 Prompt

检查本地与平台是否一致

请帮我检查当前项目的 BFF 脚本和平台是否一致。
请列出：本地已修改但未同步的脚本、平台有但本地没有的脚本、可能冲突的脚本。
先不要执行覆盖或删除，只给我差异和建议处理方式。

AI 可能调用：rabetbase bff status、rabetbase bff list、rabetbase bff detail。

新增一个接口类脚本

请帮我新增一个 BFF 接口，名称是「客户跟进摘要」。
它用于「客户详情页展示最近 5 条跟进记录、下一次跟进时间和未完成待办数量」。
输入参数包括「customerId」，返回字段包括「最近跟进记录列表、下一次跟进时间、未完成待办数量、最后跟进人」。
请先根据相关数据集确认字段和查询方式，再生成脚本，并告诉我如何验证。

AI 可能调用：rabetbase dataset detail、rabetbase dataset operations、rabetbase bff create、rabetbase bff push。

抽取公共逻辑

我发现「客户详情页、销售工作台、客户列表页」里都在计算客户跟进状态。
请帮我抽成一个公共 BFF 函数，并调整调用方复用它。
修改前先列出会影响哪些脚本，修改后给出验证清单。

AI 可能调用：rabetbase bff list、rabetbase bff detail、rabetbase bff status、rabetbase bff push。

增加数据操作钩子

请为「客户」数据集的「更新客户状态」操作增加一个钩子。
业务规则是：当客户状态变为「已成交」时，自动写入一条成交跟进记录，并更新客户最近跟进时间。
请先确认这个操作的入参和返回结构，再生成脚本。
执行前预览影响范围，避免影响无关操作。

AI 可能调用：rabetbase dataset operations、rabetbase bff create、rabetbase bff push。

同步到平台

本地的「客户跟进摘要」脚本已经改完。
请先检查它和平台当前版本的差异，说明是否会覆盖远端内容。
如果风险可接受，再把它同步到平台，并告诉我同步结果和验证方式。

AI 可能调用：rabetbase bff status、rabetbase bff detail、rabetbase bff push。

写 Prompt 时要补充的信息

• 脚本目标：查询、写入、校验、封装公共逻辑或挂钩子。
• 输入输出：参数名、必填项、返回字段、错误处理要求。
• 依赖对象：相关数据集、SQL、前端页面或调用方。
• 同步策略：只检查、拉回本地、推到平台或先预览再执行。

完成检查

• Agent 已说明新增或修改了哪些本地文件。
• 平台和本地脚本状态一致，或者差异已明确保留。
• 脚本输入输出与业务需求一致。
• 有可执行的验证方式，例如示例参数、页面调用或运行态试跑。

下一步：如果脚本依赖复杂查询，先看「自定义 SQL：从写到执行」；如果要给前端生成调用片段，继续看「代码生成与菜单」。