Общие правила для навыков lark-* при работе с lark-cli: помогают выбрать user или bot identity, пройти настройку и авторизацию, корректно трактовать JSON-ответы и безопасно выполнять рискованные операции. Навык также указывает, какие reference читать перед конкретными действиями.

Возможности

• Объясняет разницу между --as user и --as bot: bot работает только со своими ресурсами, а запрос bot к ресурсам пользователя может вернуть пустой успешный ответ.
• Задаёт правила для авторизации: URL из вывода команды нужно показывать вместе с QR-кодом, созданным через lark-cli auth qrcode.
• Помогает правильно проверять JSON-ответы: успешный результат определяется по ok == true или коду выхода 0, а не по code == 0.
• Задаёт меры безопасности: не выводить секреты, подтверждать операции записи и удаления, использовать --dry-run, если он поддерживается.
• Описывает обработку высокого риска: код выхода 10 требует показать пользователю детали операции и получить явное согласие до повтора команды.
• Направляет к нужным reference при настройке CLI, проверке identity и permissions, обработке _notice и других задачах.

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

• Настраиваете lark-cli, выполняете auth login, проверяете авторизацию или разбираетесь с missing_scopes.
• Нужно выбрать identity — пользователя или приложение — для работы с календарём, облачным пространством или другими ресурсами.
• Пишете скрипт или обёртку для команд с --format json и проверяете результат выполнения.
• Команда требует подтверждения высокого риска, выдаёт URL авторизации или сообщает о проблеме через _notice.

Примеры

lark-cli config init

lark-cli auth qrcode

--as user
--as bot

Установка

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