@lovrabet/rabetbase-cli 2.0.2-beta.1

package/templates/skill/SKILL.md.tpl

@@ -0,0 +1,120 @@
+---
+name: lovrabet
+description: 当用户请求涉及 Lovrabet/云兔/yuntoo 平台的数据集查询、SQL 创建、BFF 开发时使用。触发词：数据集、数据表、自定义 SQL、filter、sql.execute、bff.execute、get_dataset_detail、validate_sql_content、save_or_update_custom_sql、save_or_update_bff_script、@lovrabet/sdk、MCP SQL 工作流、多表关联、lovrabet 开发。
+---
+
+# Lovrabet 开发工作流（路由指南）
+
+Lovrabet 中文名为**云兔**，也常写作 **yuntoo**。本文档是**路由指南**，告诉你什么场景用什么工具/文档。
+
+## 强制读取规则（不可跳过）
+
+以下情况必须先调用 Read 工具读取对应文件，禁止依赖记忆直接回答或执行：
+
+| 触发条件 | 必须读取的文件 |
+|---------|--------------|
+| 创建 / 修改 / 保存 SQL | `.lovrabet/skill/guides/02-mcp-sql-workflow.md` |
+| 涉及 SQL 本地落盘、目录规范 | `.lovrabet/skill/guides/07-sql-creation-workflow.md` |
+| 创建 / 修改 / 保存 BFF 脚本 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
+| 涉及 BFF 本地落盘、目录规范 | `.lovrabet/skill/guides/05-backend-function.md` |
+| 遇到冲突提示 / blocked / confirmationRequired | `.lovrabet/skill/guides/09-conflict-detection.md` |
+| 使用 TypeScript SDK / filter / sql.execute | `.lovrabet/skill/guides/01-typescript-sdk.md` |
+| 数据接口设计、多表关联、性能优化 | `.lovrabet/skill/guides/06-data-api-guidelines.md` |
+| 报错、行为异常、无法确定原因 | `.lovrabet/skill/guides/04-troubleshooting.md` |
+
+**执行顺序**：读完对应 guide → 再调用 MCP 工具 → 再回答用户。
+
+## 前置条件检测
+
+### 检测 MCP 是否可用（必需）
+
+```
+检测方式：尝试调用任何 Lovrabet 相关的 MCP 工具
+- 查找工具名包含 "lovrabet" 或 "dataset" 的 MCP 工具
+- 常见工具：get_auth_status、list_datasets、get_dataset_detail
+- ✅ 找到 → MCP 可用，继续
+- ❌ 未找到 → 提示用户：lovrabet mcp install
+```
+
+**注意**：MCP 服务器名字可能是自定义的，不一定叫 `lovrabet-dataset`
+
+## 工具路由规则
+
+### 查询和分析 → 用 MCP Tools
+
+| 场景 | 使用的 MCP Tool |
+|------|----------------|
+| 列出所有数据集 | `list_datasets` |
+| 搜索数据集 | `search_datasets` |
+| 获取数据集详情 | `get_dataset_detail` |
+| 执行已保存的 SQL | `execute_custom_sql` |
+| 列出 SQL 查询 | `list_sql_queries` |
+| 列出 BFF 脚本 | `list_bff_scripts` |
+| 获取 BFF 详情 | `get_bff_script_info` |
+| 生成 SDK 代码 | `generate_sdk_code` |
+| 生成 SQL 代码 | `generate_sql_code` |
+
+**规则**：直接调用 MCP 工具，不要生成脚本
+
+### 验证和保存 → 用 MCP Tools（含冲突检测）
+
+| 场景 | 使用的 MCP Tool | 说明 |
+|------|----------------|------|
+| 验证 SQL 语法 | `validate_sql_content` | 静态语法 + 可选 schema 验证 |
+| 保存 SQL | `save_or_update_custom_sql` | 通过 toolbox，自动冲突检测 |
+| 保存 BFF | `save_or_update_bff_script` | 通过 toolbox，自动冲突检测 |
+
+**冲突处理**：保存工具返回 `blocked: true`（例如他人为最后提交者）时，告知用户在平台上手动处理，**不要**自动重试同一保存。`confirmationRequired` / `nextAction` 等字段以工具返回为准；细节见 `09-conflict-detection.md`。
+
+**BFF 写入类 MCP**：若看不到 `list_bff_scripts` / `save_or_update_bff_script`，请在数据集 MCP 的启动参数中加入 `--enable-bff-save`，旧名 `--dangerously-bff-save` 仍可用；详见 `11-bff-sync-workflow.md`。
+
+## 快速决策树
+
+```
+用户请求
+    │
+    ├─ 查询数据？
+    │   └─ 用 MCP: execute_custom_sql / generate_sql_code
+    │
+    ├─ 创建/修改 SQL？
+    │   ├─ 0. 读取 .lovrabet/skill/guides/02-mcp-sql-workflow.md（必须）
+    │   ├─ 1. 用 MCP: get_dataset_detail（了解结构）
+    │   ├─ 2. 生成 SQL 代码
+    │   ├─ 3. 用 MCP: validate_sql_content（验证）
+    │   ├─ 4. 用 MCP: save_or_update_custom_sql（保存，含冲突检测）
+    │   └─ 5. 用 MCP: execute_custom_sql（测试）
+    │
+    ├─ 创建/修改 BFF？
+    │   ├─ 0. 读取 .lovrabet/skill/guides/08-bff-creation-workflow.md（必须）
+    │   ├─ 1. 生成 BFF 代码
+    │   └─ 2. 用 MCP: save_or_update_bff_script（保存，含冲突检测）
+    │
+    ├─ 生成 SDK 代码？
+    │   └─ 用 MCP: generate_sdk_code
+    │
+    └─ 不确定？
+        └─ 读取 `.lovrabet/skill/guides/04-troubleshooting.md`
+```
+
+## 全部 Guides 索引
+
+> 通过 `lovrabet skill install` 安装后，guide 位于项目根目录的 `.lovrabet/skill/guides/` 下。若使用 `npx skills add lovrabet/lovrabet-skill`，路径以 skills 生态落盘为准，可读本文档同级的 `./guides/`。
+
+| 用户需求 | 参考的 Guide 文档 |
+|---------|------------------|
+| 使用 TypeScript SDK | `.lovrabet/skill/guides/01-typescript-sdk.md` |
+| 创建自定义 SQL（MCP 模式） | `.lovrabet/skill/guides/02-mcp-sql-workflow.md` |
+| React 前端开发 | `.lovrabet/skill/guides/03-frontend-development.md` |
+| 故障排查 | `.lovrabet/skill/guides/04-troubleshooting.md` |
+| 创建 BFF 脚本 | `.lovrabet/skill/guides/05-backend-function.md` |
+| 数据接口规范 | `.lovrabet/skill/guides/06-data-api-guidelines.md` |
+| SQL 创建工作流 | `.lovrabet/skill/guides/07-sql-creation-workflow.md` |
+| BFF 创建工作流 | `.lovrabet/skill/guides/08-bff-creation-workflow.md` |
+| BFF 同步与协作（平台脚本列表、保存） | `.lovrabet/skill/guides/11-bff-sync-workflow.md` |
+| 冲突检测和处理 | `.lovrabet/skill/guides/09-conflict-detection.md` |
+| 团队协作最佳实践 | `.lovrabet/skill/guides/10-best-practices.md` |
+
+## 配置文件位置
+
+- **详细配置说明**：`.lovrabet/CONFIG.md`（若存在）
+- **Guides 目录**：`.lovrabet/skill/guides/`