lark-skill-maker

用途

lark-skill-maker 用于基于 lark-cli 创建新的 Skill。这里所说的 Skill 是一份 SKILL.md，用来教 AI 使用 CLI 命令完成任务。该技能聚焦于如何调研 API、确定所需参数与权限，并按模板编写 SKILL.md。

主要能力

CLI 核心能力

lark-cli 提供以下命令形式：

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

可通过以下步骤调研 API：

# 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 从飞书官方文档库逐层挖掘原生 OpenAPI 接口，获取完整的方法、路径、参数和权限信息，再通过 lark-cli api 裸调完成任务。通过以上流程确定需要哪些 API、参数和 scope。

使用方式

SKILL.md 模板

文件放在 skills/lark-<name>/SKILL.md：

---
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，登录用 lark-cli auth login --domain <name>。
• 安全：写入操作前确认用户意图，建议 --dry-run 预览。
• 编排：说明数据传递、失败回滚、可并行步骤。

适用场景

适用于需要为飞书开放平台能力编写 Skill、教 AI 通过 lark-cli 命令完成任务的场景，涵盖已注册 API、Shortcut 以及通过 api 裸调任意飞书 OpenAPI 的方式。

限制

资料未提供该工具的收费、价格、平台支持范围及效果等信息，暂未提供。