larksuite/cli / lark-shared
lark-shared
- Установки
- 428,016
- Автор
- larksuite/cli
- Источник
- github.com/larksuite/cli
Базовый скилл для работы с lark-cli: управление аутентификацией, выбором идентичности пользователя или бота, настройкой доменов и прав доступа. Обеспечивает корректную обработку ответов, безопасность операций и генерацию QR-кодов для авторизации.
Установить скилл
npx skills add https://github.com/larksuite/cli --skill lark-shared
Аудит безопасности
Gen Agent Trust Hub
passThis skill provides safe and structured instructions for using the lark-cli tool. It includes explicit safety rules against secret exposure and detailed protocols for obtaining user consent before executing high-risk operations.
Audited: 5/19/2026, 3:06:52 AM
Socket
passNo alerts
Audited: 5/19/2026, 3:08:15 AM
Snyk
passRisk: LOW · No issues
Audited: 5/19/2026, 3:06:56 AM
ZeroLeaks
passScore: 93/100 · 2 sections analyzed
Audited: 4/16/2026, 2:52:28 AM
Промпт скилла
lark-cli 共享规则
所有 lark-* skill 共享的底座:身份、认证、输出契约与高风险操作。
通用准则
-
调用前先确认用法:执行前读对应 reference 或跑
--help,别猜 flag 盲调。 -
身份决定你代表谁操作:
--as user代表用户本人(能看到、也能操作其日历、云空间/云盘/云存储等个人资源),--as bot代表应用自己,应用级操作,只能访问bot自己的资源,bot 查用户资源会返回空成功而非报错。动手前先搞清楚身份identity。身份模型和权限管理 →lark-shared-identity-and-permissions.md。 -
授权 / 配置类 URL 必须配二维码:当命令输出
verification_url、verification_uri_complete、console_url等 URL 字段时,必须用lark-cli auth qrcode生成并在回复中展示,URL 在前二维码在后;优先生成 PNG(--output),仅当用户明确要求时才使用 ASCII(--ascii)。URL 原样转发——不编解码、不加标点、不重拼 query,二维码和链接请一起展示给用户。 -
--format json(默认)下,判断成功用ok == true(或进程退出码 0),不要用code == 0:成功信封没有顶层code/msg字段,code只出现在错误信封的error内。按 OpenAPI 老格式{"code": 0, "msg": "ok"}判断会把所有成功调用误判为失败——封装写入类命令时尤其危险。JSON 输出契约 →lark-shared-output-contract.md。
安全规则
-
禁止输出密钥(appSecret、accessToken等)到终端明文。
-
写入/删除操作前必须确认用户意图。
-
目标命令支持
--dry-run时,用--dry-run预览危险请求。 -
退出码 10 是高风险确认门禁(
risk: "high-risk-write"),不是错误:停下 → 向用户确认(展示action、risk和关键参数)→ 取得用户显式同意后,将hint指出的确认 flag 追加到你原始 argv 的末尾后重试;绝不静默加确认 flag 绕过 →lark-shared-high-risk-approval.md。 -
文件路径只接受相对路径:
--file、--output、--output-dir、@file等路径参数只接受 cwd 下的相对路径,传绝对路径会报unsafe file path。数据输入(@file、大 JSON)优先用 stdin 传入,避免路径和转义问题。
Reference 强触发索引
命中任一触发条件时,MUST 在执行下一步前读取对应 reference。命中多条时按表中顺序读取,同一reference只读取一次。
| 强触发条件(命中任一即必读) | Reference |
|---|---|
查看自己是谁(user/bot)、获取当前身份详细字段信息、身份诊断、--as选择逻辑、身份延续、登录态、认证、scope、授权和权限管理、missing_scopes 或 console_url、Agent 准备发起或完成 auth login | lark-shared-identity-and-permissions.md |
| 需要依赖 JSON 输出契约判断成功 / 失败、读取 stdout / stderr,或为命令编写脚本与封装 | lark-shared-output-contract.md |
准备执行high-risk-write(高风险操作)、判断命令风险等级、遇到退出码 exit 10、confirmation_required、确认后重试 | lark-shared-high-risk-approval.md |
首次使用CLI需运行 lark-cli config init 完成应用配置、或 CLI 明确提示 config init --new | lark-shared-config-init.md |
用户询问 notice、CLI版本更新、或输出含 _notice(升级 / skills 落后 / 废弃命令提示) | lark-shared-update-notice.md |
Все файлы скилла
- references/lark-shared-config-init.md
- references/lark-shared-high-risk-approval.md
- references/lark-shared-identity-and-permissions.md
- references/lark-shared-output-contract.md
- references/lark-shared-update-notice.md
- references/lark-wiki-token-routing.md
- SKILL.md
Другие скиллы автора
lark-im
427,083 установокlarksuite/cli
Навык для работы с корпоративным мессенджером Lark: отправка и поиск сообщений, управление чатами и группами, работа с вложениями, реакциями, закладками и интерактивными карточками. Поддерживает операции от имени пользователя или бота, включая массовые операции и пагинацию.
lark-wiki
426,048 установокlarksuite/cli
Скилл для работы с корпоративной базой знаний: создаёт и удаляет пространства, управляет их структурой и участниками, перемещает и копирует документы. Помогает быстро находить нужные материалы по ссылке или названию и грамотно организовывать знания.
lark-whiteboard
425,116 установокlarksuite/cli
Скилл для работы с досками в Lark (Feishu): просмотр и экспорт содержимого в изображение, SVG или исходный код, а также создание и редактирование досок по описанию или готовым диаграммам Mermaid, PlantUML и SVG. Упрощает визуализацию и обновление досок прямо из агента.
lark-calendar
423,989 установокlarksuite/cli
Скилл для работы с календарём Lark: просмотр и поиск событий, создание и изменение встреч, управление участниками и переговорными комнатами. Помогает проверять занятость, подбирать удобное время для встречи и бронировать переговорки. Пригодится для планирования расписания и организации совещаний.
lark-mail
422,688 установокlarksuite/cli
Скилл для работы с почтой Lark (飞书): позволяет просматривать, искать и читать письма, создавать черновики, отправлять, отвечать и пересылать сообщения, управлять папками, метками и правилами приёма почты. Включает строгие меры безопасности: содержимое писем считается недоверенным, а отправка и необратимые операции выполняются только после явного подтверждения пользователя.
lark-minutes
422,579 установокlarksuite/cli
Этот навык служит совместимым переходником для старых названий: он перенаправляет все запросы на навык lark-meeting, который выполняет основную работу. Сам по себе он не обрабатывает задачи, а только обеспечивает корректную маршрутизацию.
lark-vc
422,474 установокlarksuite/cli
Скилл lark-vc обеспечивает совместимость со старым названием и перенаправляет все запросы на навык lark-meeting. Он не обрабатывает задачи напрямую, а служит переходным мостом для корректной маршрутизации. Полезен для поддержки старых конфигураций и бе
lark-event
422,235 установокlarksuite/cli
Скилл для подписки на события Lark/Feishu в реальном времени: сообщения, реакции, изменения в чатах, статусы согласований, задачи, встречи, заметки и другие события. Позволяет запускать длительные подписчики с потоковой выдачей NDJSON, фильтрацией через jq и контролем времени или количества событий. Удобен для создания ботов и обработки вебхуков.
lark-workflow-meeting-summary
421,487 установокlarksuite/cli
Этот навык собирает заметки с совещаний за заданный период и формирует структурированный отчёт. Он автоматически запрашивает список встреч, получает тексты заметок и стенограмм, обрабатывает случаи отсутствия доступа, а затем выдаёт итог за день или неделю. При необходимости готовый отчёт можно сохранить прямо в облачный документ.
lark-workflow-standup-report
420,796 установокlarksuite/cli
Формирует сводку по расписанию и незавершённым задачам на указанную дату: подтягивает события календаря и список дел, проверяет пересечения и выдаёт итоговый отчёт. Помогает быстро узнать планы на день, неделю или подготовить утреннюю сводку.
lark-openapi-explorer
420,575 установокlarksuite/cli
Этот скилл помогает находить и вызывать原生 API-интерфейсы Lark/Feishu, когда стандартные команды CLI не подходят. Он автоматически просматривает официальную документацию, извлекает спецификации нужных методов и формирует готовые запросы через `lark-cli`. Полезен для доступа к недокументированным или редко используемым функциям платформы.
lark-skill-maker
420,341 установокlarksuite/cli
Этот навык помогает создавать собственные скиллы для lark-cli, превращая операции с API Lark в переиспользуемые команды. Он позволяет исследовать доступные API, проверять параметры и генерировать шаблоны SKILL.md с описанием команд, разрешений и логики их выполнения. Упрощает автоматизацию рутинных задач с Lark, упаковывая их в понятные для ИИ инструкции.
lark-approval
395,582 установокlarksuite/cli
Управление заявками на утверждение в Lark: поиск и просмотр ожидающих и завершённых задач, инициирование новых заявок, а также выполнение действий — одобрение, отклонение, перенаправление, отзыв, напоминание и добавление подписей.
lark-attendance
373,448 установокlarksuite/cli
Помогает запрашивать свои отметки о посещаемости в Lark (Feishu) через командную строку. Автоматически подставляет обязательные параметры, поэтому достаточно указать только нужные данные. Требует предварительной настройки доступа.
lark-okr
359,391 установокlarksuite/cli
Скилл для управления OKR в Lark: просмотр и редактирование циклов, целей, ключевых результатов, связей выравнивания, количественных показателей и записей о прогрессе. Поддерживает массовое создание, изменение весов и порядка, а также корректно различает оценку (score) и фактический прогресс.
lark-vc-agent
310,424 установокlarksuite/cli
Совместимый навык для работы с видео-конференциями Lark. Не обрабатывает запросы сам, а перенаправляет их на основной навык lark-meeting. Нужен, чтобы старые вызовы по имени lark-vc-agent продолжали работать.