理解 Skill 的研发视角

适用对象

编写 Skill 的研发同学。

研发写 Skill = 写 Agent 可调用的 SOP，不是写给人看的 Wiki。

Step 1. 对齐运行边界

在 Skill 正文明确：

• 可调用的 CLI 命令 / 数据集 code / SQL code / BFF 名
• 哪些步骤必须 dry-run 或人工确认（参考 rabetbase riskLevel）

Step 2. 与平台资产映射

Skill 步骤	平台资产
查结构	rabetbase dataset detail
查数据	lovrabet data filter
复杂统计	自定义 SQL code
写回	Backend Function

Step 3. 版本与编码

• skillCode 全局唯一，建议 team_scenario_v1。
• Breaking 变更升版本，旧 Skill 保留只读。

Step 4. 联调

1. Skills 保存 Markdown。
2. 对话 用 skillCode 试跑。
3. 失败则改 Skill 或补 Knowledge。

参考

• Skill 开发指南
• 文库 Rabetbase CLI 风险等级