<< All versions
Skill v1.0.0
currentAutomated scan96/100larksuite/cli/lark-skill-maker
──Details
PublishedApril 27, 2026 at 05:15 PM
Content Hashsha256:8591158289a3cb00...
Git SHA17a85d319dbf
──Files
Files (1 file, 2.4 KB)
SKILL.md2.4 KBactive
SKILL.md · 86 lines · 2.4 KB
name: lark-skill-maker version: 1.0.0 description: "创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill(包装原子 API 或编排多步流程)时使用。" metadata: requires: bins: ["lark-cli"]
Skill Maker
基于 lark-cli 创建新 Skill。Skill = 一份 SKILL.md,教 AI 用 CLI 命令完成任务。
CLI 核心能力
bash
lark-cli <service> <resource> <method> # 已注册 APIlark-cli <service> +<verb> # Shortcut(高级封装)lark-cli api <METHOD> <path> [--data/--params] # 任意飞书 OpenAPIlark-cli schema <service.resource.method> # 查参数定义
优先级:Shortcut > 已注册 API > api 裸调。
调研 API
bash
# 1. 查看已有的 API 资源和 Shortcutlark-cli <service> --help# 2. 查参数定义lark-cli schema <service.resource.method># 3. 未注册的 API,用 api 直接调用lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'
如果以上命令无法覆盖需求(CLI 没有对应的已注册 API 或 Shortcut),使用 lark-openapi-explorer 从飞书官方文档库逐层挖掘原生 OpenAPI 接口,获取完整的方法、路径、参数和权限信息,再通过 lark-cli api 裸调完成任务。
通过以上流程确定需要哪些 API、参数和 scope。
SKILL.md 模板
文件放在 skills/lark-<name>/SKILL.md:
markdown
---name: lark-<name>version: 1.0.0description: "<功能描述>。当用户需要<触发场景>时使用。"metadata:requires:bins: ["lark-cli"]---# <标题>> **前置条件:** 先阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)。## 命令\```bash# 单步操作lark-cli api POST /open-apis/xxx --data '{...}'# 多步编排:说明步骤间数据传递# Step 1: ...(记录返回的 xxx_id)# Step 2: 使用 Step 1 的 xxx_id\```## 权限| 操作 | 所需 scope ||------|-----------|| xxx | `scope:name` |
关键原则
- description 决定触发 — 包含功能关键词 + "当用户需要...时使用"
- 认证 — 说明所需 scope,登录用
lark-cli auth login --domain <name> - 安全 — 写入操作前确认用户意图,建议
--dry-run预览 - 编排 — 说明数据传递、失败回滚、可并行步骤