API ВЕГА

Навык помогает создавать SKILL.md для lark-cli: упаковывать вызовы API или многошаговые процессы в повторно используемые skills. Он подсказывает, как найти нужные методы, параметры и scope, а затем оформить команды и требования к доступам.

Возможности

  • Показывает порядок выбора способа вызова: Shortcut, зарегистрированный API, затем прямой вызов через api.
  • Помогает изучить доступные ресурсы и Shortcut командой lark-cli <service> --help.
  • Позволяет проверить параметры метода через lark-cli schema.
  • Для незарегистрированных методов предлагает вызывать OpenAPI напрямую через lark-cli api.
  • Даёт шаблон SKILL.md с командами, передачей данных между шагами и таблицей необходимых scope.
  • Учитывает правила безопасности: перед операциями записи нужно подтвердить намерение пользователя; для предварительного просмотра рекомендуется --dry-run.

Когда использовать

  • Нужно оформить операции с API Feishu как повторно используемый skill.
  • Требуется объединить несколько вызовов lark-cli в один процесс.
  • Нужный метод не найден среди зарегистрированных API или Shortcut.
  • Нужно описать параметры команд и необходимые scope в SKILL.md.

Установка

npx skills add https://github.com/larksuite/cli --skill lark-skill-maker

Примеры

Проверить параметры метода:

lark-cli schema <service.resource.method>

Вызвать API для поиска комнат:

lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'

Шаблон skill размещается в skills/lark-<name>/SKILL.md:

Команды

lark-cli api POST /open-apis/xxx --data '{...}'

Права

ОперацияНеобходимый scope
xxxscope:name