SuperAPI AI 工具集

lark-skill-maker

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:基于 lark-cli 创建新 Skill。Skill 即一份 SKILL.md,教会 AI 用 CLI 命令完成任务,适合把飞书 API 操作封装成可复用技能(包装原子 API 或编排多步流程)。

主要能力:lark-cli 支持已注册 API(lark-cli <service> <resource> <method>)、Shortcut 高级封装(lark-cli <service> +<verb>)、任意飞书 OpenAPI 裸调(lark-cli api <METHOD> <path> [--data/--params])以及参数定义查询(lark-cli schema <service.resource.method>)。调用优先级为 Shortcut > 已注册 API > api 裸调。

调研流程:先用 lark-cli <service> --help 查看已有 API 资源和 Shortcut,再用 lark-cli schema 查参数定义;未注册的 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 裸调完成。

使用方式:编写 SKILL.md 并放在 skills/lark-<name>/SKILL.md,包含 name、version、description、metadata.requires.bins 等头部字段,正文写命令、权限表与关键原则。description 需包含功能关键词与“当用户需要……时使用”以决定触发;需说明所需 scope,登录用 lark-cli auth login --domain <name>;写入操作前确认用户意图,建议 --dry-run 预览;多步编排需说明数据传递、失败回滚与可并行步骤,并先阅读 lark-shared/SKILL.md。

限制:资料未提供具体支持的服务清单、可用 Shortcut 明细及定价信息,暂未提供。