lark-skill-maker
创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。
Datos de origen
- Repositorio
- MiniMax-AI/minimax-code
- Última actividad en el origen
- 18 de septiembre de 2026 a las 11:25
- Idioma detectado de SKILL.md
- chino
- Estrellas
- 589
- Forks
- 67
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Mostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- 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> # 已注册 API
lark-cli <service> +<verb> # Shortcut（高级封装）
lark-cli api <METHOD> <path> [--data/--params] # 任意飞书 OpenAPI
lark-cli schema <service.resource.method> # 查参数定义
```
优先级：Shortcut > 已注册 API > `api` 裸调。
## 调研 API
```bash
# 1. 查看已有的 API 资源和 Shortcut
lark-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](../lark-openapi-explorer/SKILL.md) 从飞书官方文档库逐层挖掘原生 OpenAPI 接口，获取完整的方法、路径、参数和权限信息，再通过 `lark-cli api` 裸调完成任务。
通过以上流程确定需要哪些 API、参数和 scope。
## SKILL.md 模板
文件放在 `skills/lark-<name>/SKILL.md`：
```markdown
---
name: lark-<name>
version: 1.0.0
description: "<功能描述>。当用户需要<触发场景>时使用。"
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。缺权限时让 agent 按 `cli-skills/lark-shared/SKILL.md` §Agent 代理发起认证 canonical 模板补：缺基础 scope 跑 `--recommend`，缺推荐之外的高敏感 scope 跑 `--scope <name>`，两者都通过 agent 自己 `--no-wait --json` + 后台 `--device-code`。文档里**指向 canonical 模板**，不要重复贴整条 `lark-cli auth login` 命令，也不要再教 `--domain`。
- **安全** — 写入操作前确认用户意图，建议 `--dry-run` 预览
- **编排** — 说明数据传递、失败回滚、可并行步骤
Ver en GitHub