SuperAPI AI 工具集

lark-skill-maker

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:基于 lark-cli 创建新的自定义 Skill。Skill 本质是一份 SKILL.md,用来教 AI 通过 CLI 命令完成任务,适用于把飞书 API 操作封装为可复用能力,或编排多步流程。

主要能力与命令:

  • 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 的流程:先用 lark-cli <service> --help 查看已有资源和 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 无法覆盖需求,可用 lark-openapi-explorer 从飞书官方文档逐层挖掘原生 OpenAPI 的方法、路径、参数和权限,再通过 lark-cli api 裸调完成。

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

限制:资料未提供具体收费、平台支持范围或效果数据。