把 SQL、BFF、Backend Function 接到 Skill

本页把稳定查询、接口编排和写回逻辑接到 Skill。Skill 负责流程，SQL、BFF、Backend Function 负责稳定执行。

操作人

技术负责人、实施人员。

SQL：固定统计口径

1. 打开 App Management。
2. 点击左侧 Custom SQL Management。
3. 对照下方截图，确认当前页面是 Custom SQL Management。
4. 点击 Add SQL。
5. 填写 SQL 名称，例如 weekly_crm_followup_summary。
6. 选择数据库 crm_demo。
7. 写入统计 SQL。
8. 保存。
9. 用运行态 CLI 验证：

截图指引：SQL 资产入口如下。统计口径类 SQL 从这里新建和维护。

lovrabet sql exec --code weekly_crm_followup_summary --params '{"range":"this_week"}'

BFF：固定多步骤查询

适合把「查客户、查商机、组装建议」合成一个入口。

1. 在研发态创建 BFF。
2. 输入参数固定为时间范围、团队、阶段。
3. 输出字段固定为客户、负责人、商机阶段、金额、建议动作。
4. 发布后用运行态 CLI 验证：

lovrabet bff exec --name prepare_high_risk_opportunity_review --params '{"stage":"proposal"}'

Backend Function：固定写回动作

1. 打开 App Management。

2. 点击左侧 Backend Function。

3. 对照下方截图，确认当前页面是 Backend Function。

4. 找到需要接入的资料，例如销售机会或跟进记录。

5. 给写回动作添加 Function。

6. 在 Function 里处理：

   • 参数校验
   • 权限检查
   • 写回
   • 通知
   • 审计日志

7. 保存后回到运行态试跑。

截图指引：Backend Function 入口如下。写回、通知、审批和审计逻辑从这里配置。

写进 Skill

Skill 中写清调用顺序：

1. 调用 SQL weekly_crm_followup_summary 生成本周统计。
2. 调用 BFF prepare_high_risk_opportunity_review 生成候选商机。
3. 展示候选清单和依据。
4. 用户确认后调用 Backend Function 标记高风险。

看到什么算完成

• SQL 能返回稳定统计结果。
• BFF 能返回固定结构。
• Backend Function 能处理写回和审计。
• Skill 中能看到明确的能力名称和调用顺序。

如果执行失败

现象	检查
SQL 没结果	检查时间范围和数据表字段
BFF 参数错误	检查入参名称和格式
写回失败	查看 Backend Function 日志
Skill 找不到能力	检查能力是否已发布

Claude Code 操作 prompt

请使用 rabetbase 为目标应用检查 SQL、BFF、Backend Function 接入状态。
执行 rabetbase sql list --appcode <你的应用 appCode> --format compress。
执行 rabetbase bff list --appcode <你的应用 appCode> --format compress。
如果需要新增 SQL，先输出 sql create / sql pull / sql validate / sql push --dry-run 的命令，不直接 push。
如果需要新增 BFF，先输出 bff create / bff status / bff push --dry-run 的命令，不直接 push。
输出可以写进 Skill 的能力名称、入参和返回字段。

下一步

继续《8. 固定多表指标口径》。