跳到主要内容

AI Skills 安装

Lovrabet AI Skills 是一套为 AI IDE 定制的开发规范和指南，帮助 AI 正确使用 Lovrabet SDK 和 CLI，减少错误代码，提高开发效率。

什么是 AI Skills？​

Skills 包含以下内容：

技能说明
TypeScript SDK 使用指南Filter、SQL、BFF 三大核心 API 使用规范
MCP SQL 创建工作流5 步强制流程，创建自定义 SQL 查询
AntD UI 开发规范避免生成 "AI 味道" 的 UI 代码
API 集成指南lovrabet api pull 流程和使用
菜单管理指南menu sync/update 流程
Backend Function 脚本编写规范权限过滤、数据脱敏、业务逻辑

安装后的文件结构​

your-project/
├── .cursorrules              # Cursor 通用规则
├── .cursor/
│   └── skills/               # Cursor 技能
├── .windsurf/
│   └── workflows/            # Windsurf 工作流
├── .claude/
│   └── skills/               # Claude Code 技能
├── .lovrabet/
│   ├── skill-manifest.json   # skill 清单
│   └── skill/
│       └── .shared/
│           └── guides/       # 共享指南
│               ├── 01-typescript-sdk/guide.md
│               ├── 02-mcp-sql-workflow/guide.md
│               ├── 03-antd-style/guide.md
│               ├── 05-api-integration/guide.md
│               ├── 06-menu-management/guide.md
│               └── 07-backend-function/guide.md
└── agents.md                 # Claude Code 规则

支持的 IDE​

IDE配置位置说明
Cursor.cursorrules, .cursor/Cursor IDE
Windsurf.windsurf/Windsurf IDE
Claude Code.claude/, agents.mdClaude Code
Codex.codex/Codex IDE
OpenCode.opencode/OpenCode IDE
Qoder.qoder/Qoder IDE
CodeBuddy.codebuddy/CodeBuddy IDE
Trae.trae/Trae IDE
通用/其他.agent/通用 AI 助手

安装方式​

方式一：npx skills（推荐）​

使用 skills 工具安装，这是官方推荐的方式：

npx skills add lovrabet/lovrabet-skill

优点：

  • ✅ 无需额外安装 CLI
  • ✅ 总是使用最新版本
  • ✅ 跨平台兼容
  • ✅ 自动检测并配置多个 IDE

安装过程：

  1. skills 工具会自动检测你使用的 IDE
  2. 将 Lovrabet Skills 安装到对应的配置目录
  3. 生成统一的清单文件

方式二：企业 CDN（内部使用）​

如果团队配置了企业 CDN，可以从内部源安装：

lovrabet skill install --cursor
注意

此方式仅限企业内部使用，需要配置企业 CDN 访问权限。普通用户请使用 npx skills add 方式。

技能内容详解​

1. TypeScript SDK 使用指南​

掌握 Lovrabet SDK 的三大核心 API：Filter、SQL、BFF。

包含内容：

  • Filter 高级查询 - 复杂条件筛选、字段选择、排序
  • SQL 自定义查询 - 执行已注册的 SQL 查询
  • BFF 端点调用 - 调用后端函数
  • 三大 API 对比和使用场景
  • 错误处理最佳实践

示例对比：

// Filter - 数据集高级查询
const result = await client.models.users.filter({
  where: { status: { $eq: 'active' } },
  select: ['id', 'name'],
  currentPage: 1,
  pageSize: 20,
});

// SQL - 自定义查询
const data = await client.sql.execute({
  sqlCode: 'fc8e7777-06e3847d',
  params: { userId: '123' }
});

// BFF - 后端函数调用
const result = await client.bff.execute({
  scriptName: 'getUserDashboard',
  params: { userId: '123' }
});

2. MCP SQL 创建工作流​

掌握创建自定义 SQL 的 5 步流程。

流程步骤：

  1. 使用 MCP 获取数据集信息
  2. 确定查询需求和字段
  3. 在平台创建自定义 SQL
  4. 使用 SDK executeSql() 调用
  5. 处理结果和错误

3. AntD UI 开发规范​

统一 AntD 组件使用风格，避免 "AI 味道"。

规范内容：

  • 组件选择原则
  • 样式约定
  • 表格配置规范
  • 表单布局规范

4. API 集成指南​

使用 lovrabet api pull 集成数据集 API。

流程说明：

  • 初始化项目配置
  • 拉取 API 配置
  • 生成 API 文档
  • 在代码中使用

5. 菜单管理指南​

使用 lovrabet menu sync/update 管理菜单。

流程说明：

  • 开发新页面
  • 同步菜单到平台
  • 更新 CDN 资源

6. Backend Function 脚本编写规范​

编写后端函数脚本的规范。

规范内容：

  • 权限过滤
  • 数据脱敏
  • 业务逻辑封装
  • 错误处理

查看已安装的技能​

安装完成后，可以查看技能文件：

# 查看 manifest
cat .lovrabet/skill-manifest.json

# 查看指南目录
ls .lovrabet/skill/.shared/guides/

# 阅读特定指南
cat .lovrabet/skill/.shared/guides/01-typescript-sdk/guide.md

更新 Skills​

Skills 会定期更新。要更新到最新版本：

npx 方式：

# 重新安装即可更新
npx skills add lovrabet/lovrabet-skill

企业 CDN 方式：

lovrabet skill install --cursor

与 MCP 配合使用​

Skills 与 MCP 配合使用效果更佳：

# 1. 安装 Skills
npx skills add lovrabet/lovrabet-skill

# 2. 配置 MCP（如使用 Claude Code）
# 编辑 ~/.config/claude-code/mcp.json

配合效果：

  • MCP 让 AI 能访问数据集信息
  • Skills 教 AI 如何正确使用 SDK
  • 两者结合，AI 可以生成更准确的代码

故障排查​

问题：技能文件未生效​

检查项：

  1. 确认文件已创建
  2. 重启 IDE
  3. 检查 IDE 是否支持该格式的规则文件

解决方法：

# 检查文件是否存在
ls -la .cursorrules
ls -la .lovrabet/skill/.shared/guides/

# 重新安装
npx skills add lovrabet/lovrabet-skill

问题：IDE 不识别规则文件​

不同 IDE 对规则文件的支持不同：

  • Cursor: 支持 .cursorrules 和 .cursor/skills/
  • Windsurf: 支持 .windsurf/workflows/
  • Claude Code: 支持 .claude/skills/ 和 agents.md

如果 IDE 不识别，请检查 IDE 版本和官方文档。

问题：npx skills 安装失败​

可能原因：

  • 网络连接问题
  • npm 源访问受限

解决方法：

# 尝试使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npx skills add lovrabet/lovrabet-skill

相关文档​