API ВЕГА

Навык ищет нативные OpenAPI Feishu и Lark, если нужной операции нет среди зарегистрированных команд lark-cli или существующих skills. Он помогает найти спецификацию в официальной документации и вызвать API через lark-cli api.

Возможности

  • Проверяет, есть ли нужная команда или shortcut в lark-cli.
  • Ищет API по официальной документации: от llms.txt через документ модуля к полной спецификации API.
  • Извлекает HTTP-метод, путь, параметры, поля запроса и ответа, права доступа и коды ошибок.
  • Вызывает API напрямую через lark-cli api.
  • Для запросов на запись и удаление требует подтвердить намерение; не допускает угадывания путей и параметров.
  • Перед началом требует ознакомиться с ../lark-shared/SKILL.md — там описаны аутентификация, переключение личности и правила безопасности.

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

  • Нужной операции нет среди команд lark-cli или существующих skills.
  • Нужно найти API, не обёрнутый в CLI, например для управления участниками чата или объявлением.
  • Требуется проверить точные параметры, права доступа и ограничения API перед вызовом.

Установка

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

Примеры

Добавить участников в чат:

lark-cli api POST /open-apis/im/v1/chats/oc_xxx/members \
  --data '{"id_list":["ou_xxx","ou_yyy"]}' \
  --params '{"member_id_type":"open_id"}'

Установить объявление в чате:

lark-cli api PATCH /open-apis/im/v1/chats/oc_xxx/announcement \
  --data '{"revision":"0","requests":["<html>公告内容</html>"]}'