Agentskillz Logo

larksuite/cli / lark-calendar

lark-calendar

Установки
423,989
Автор
larksuite/cli
Источник
github.com/larksuite/cli

Скилл для работы с календарём Lark: просмотр и поиск событий, создание и изменение встреч, управление участниками и переговорными комнатами. Помогает проверять занятость, подбирать удобное время для встречи и бронировать переговорки. Пригодится для планирования расписания и организации совещаний.

Установить скилл

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

Аудит безопасности

Gen Agent Trust Hub

pass

The skill is safe and provides a robust framework for managing Lark calendars using the vendor-provided lark-cli. It includes comprehensive instructions to ensure user confirmation and data integrity.

Audited: 5/27/2026, 3:05:53 AM

Socket

pass

No alerts

Audited: 5/27/2026, 3:06:45 AM

Snyk

pass

Risk: LOW · No issues

Audited: 5/27/2026, 3:05:52 AM

ZeroLeaks

pass

Score: 93/100 · 2 sections analyzed

Audited: 4/16/2026, 2:52:27 AM

Промпт скилла

calendar (v4)

开始前先读 ../lark-shared/SKILL.md（认证、权限处理）。

CRITICAL — 凡涉及预约日程/会议室、调整时间或查询/搜索会议室，第一步 MUST 读 references/lark-calendar-schedule-meeting.md。仅编辑字段（改标题/描述）或增删参会人（不涉及时间和会议室）时可跳过，直接读 references/lark-calendar-update.md。

身份

按日程归属选身份：

  • 查看/管理登录用户本人的日程 → --as user（默认，绝大多数场景）。
  • 查看/管理 bot 自己创建/拥有的日程 → --as bot

对话人称映射：「我」= 登录用户，「你」= 应用（bot）；作为字段取值的人称（参会人、会议 owner 等）不参与身份判定，如「你创建日程，邀请我、会议 owner 为我」→ --as bot 创建，登录用户仅作参会人与会议 owner。

# 用户本人日程 → user
lark-cli calendar +agenda --as user
# bot 自建或参与的日程 → bot
lark-cli calendar +agenda --as bot

Shortcuts

Shortcut说明
+agenda查看日程安排（默认今天）
+meeting通过日程事件 ID 获取关联的视频会议信息（meeting_id、meeting_note），日程开过视频会议才会有meeting_id
+create创建日程并邀请参会人（ISO 8601 时间）
+update更新既有日程字段，或独立增量添加/移除参会人和会议室
+freebusy查询用户主日历的忙闲信息和 RSVP 状态（纯查询场景；预约场景走 +suggestion）
+room-find针对一个或多个明确的时间块查找可用会议室（无明确时间时禁止直接调用，需先走 +suggestion）
+rsvp回复日程（接受/拒绝/待定）
+join-event凭分享 token 加入日程（分享链接/二维码/分享卡片/RSVP 卡片）
+suggestion根据非明确时间或一段时间范围，推荐多个可用时间块方案
+transfer把日程组织者转让给另一个用户或机器人；不可逆，需 --yes

+get — 单日程详情

通过 calendar_id + event_id 获取单个日程详情。

# calendar_id不传，默认primary
lark-cli calendar +get --calendar-id <calendar_id> --event-id <event_id>

日程描述统一使用 description 一个字段，按 Markdown 富文本处理。读取日程时 description 返回 Markdown 富文本（仅有纯文本描述时返回该纯文本）；创建/更新日程时也通过 --description 传入 Markdown。

+search-event — 按关键词、时间范围和参会人搜索日程

仅返回基础字段（event_id/summary/start/end 等），需要详情请走 +get。

# query 按关键词 可选
# start/end 按时间范围（ISO 8601 或 YYYY-MM-DD）可选
# attendee-ids 按参会人（自动识别 ou_ 用户 / oc_ 群聊 / omm_ 会议室前缀）可选
# page-token 分页游标，用于继续翻页 可选
# page-size 每页数量，默认 30 可选
lark-cli calendar +search-event --query "周会" --start 2026-04-20 --end 2026-04-27 --attendee-ids "ou_user1,oc_chat1,omm_room1" --page-token <page_token> --page-size 30

+agenda — 查看近期日程安排

默认查询当天。结果应整理为按日期分组、按开始时间升序的易读时间线。

# start/end 时间范围（ISO 8601 / YYYY-MM-DD / Unix 秒），均可选；默认当天
# calendar-id 日历 ID（默认primary）可选
lark-cli calendar +agenda --start 2026-03-10 --end 2026-03-17 --calendar-id <calendar_id>

注意：

  • 已取消的日程自动过滤；无日程时直接告知"日程清空"。
  • 时间范围超过 40 天会自动拆分查询并合并结果。

+freebusy — 查询主日历忙闲时段和 RSVP 状态

仅返回忙碌时段起止时间，不含日程标题等隐私信息；其他订阅日历不在范围内。

# start/end 时间范围（ISO 8601 / YYYY-MM-DD / Unix 秒），均可选；默认当天
# user-id 目标用户 open_id（ou_ 前缀）可选；默认当前登录用户，bot 身份必须显式指定
lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-12 --user-id ou_xxx

用法提示：

  • 仅判断是否有空 → +freebusy；需要日程详情 → +agenda。
  • 检查多人可用性：分别调用并对比，找共同空闲。
  • 预约/改约场景下，调用规则（参与人过多、含群组、来自 +suggestion 等）详见 schedule-clear-time.md § 查询忙闲。

前置条件路由

先判断是否重复性日程：若操作对象是重复性日程，必须先读 重复性日程操作规范，并在用户未明确范围时先确认「仅此次/全部/此次及后续」（不要默认仅此次），再按下表进入具体操作流程。

场景前置要求
预约日程/会议、调整时间、查会议室先读 lark-calendar-schedule-meeting.md
仅编辑字段（标题/描述）或增删参会人先定位 event_id，再读 lark-calendar-update.md
调用任何 Shortcut先读其对应 reference 文档

写操作反馈

创建、更新、删除、RSVP 等写操作完成后，直接基于命令返回结果反馈用户；不要为了“确认是否生效”主动发起二次查询。只有用户明确要求复查，或命令返回信息不足以回答用户问题时，才需要再查询。

核心概念

  • 日程实例（Instance）：重复性日程展开后的具体时间实例。「仅此次」操作时使用具体实例的 event_id；「全部」或「此次及后续」操作时需对原重复性日程操作（使用原日程 event_id），并按需处理例外。
  • 重复性日程例外（Exception）：对重复性日程某次实例做过「仅此次」编辑后产生的独立日程（拥有独立 event_id）。删除/更新「全部」时必须同时处理例外，否则例外会残留。
  • 全天日程（All-day Event）：只按日期占用、没有具体起止时刻的日程，结束日期是包含在日程时间内的。
  • 时间块 vs 时间范围：时间块是具体确定的连续时间段（如 14:00~15:00），时间范围是泛指（如"今天下午"）。+room-find 必须基于确定时间块，不能基于模糊范围。
  • 会议室（Room）："room"不是"房间"，是"会议室"。会议室是日程的一种参与人（resource attendee），不能脱离日程单独预定。
  • 日程会议 ID（Meeting ID）：日程的历史视频会议 ID，在日程上开过视频会议才会有。

术语映射

用户日常说的"帮我约个日历""查一下今天的日历"，实际意图是针对**日程（Event）**的创建或查询，而非操作日历（Calendar）容器本身。自动将口语化的"日历"意图映射为"日程"操作。

意图路由

用户意图路由到
查询过去的会议（"昨天的会议""上周的会"）../lark-meeting/SKILL.md（会议数据含即时会议，仅查日程会遗漏）
今天有哪些会议需要合并两部分内容：../lark-meeting/SKILL.md 中的 vc +search 查询今天已结束的会议， calendar +agenda 查询进行中或未开始的日程。
查询日历/日程或未来时间的会议本 skill
按关键词搜索日程本 skill（+search-event）
从日程获取关联的视频会议 ID 或用户绑定的会议纪要文档本 skill（+meeting）
把日程分享给某人 / 群本 skill：先 calendar events share_info 取日程分享链接，再走 lark-im 发送该链接；分享链接不是 applink，不要自己拼接或用 applink 代替
从日程进一步拿 AI 智能纪要 / 逐字稿 / 妙记产物先 +meeting 取 meeting_id，再进入 lark-meeting：vc +detail → note +detail / minutes +detail
预约/改约日程、调整时间、添加/更换会议室、查会议室先判断新建 vs 编辑，再进入 schedule-meeting 工作流
仅编辑日程字段（标题/描述）或增删参会人（不涉及时间和会议室）先定位 event_id，再读 +update 执行变更
编辑/删除重复性日程（「改这个重复日程」「删掉后面的」「全部取消」等）先读 重复性日程操作规范，确认操作范围后执行
转让日程组织者（「把这个日程交给 XX」「组织者改成 XX」「这个会转给我」「bot 建完还给我」）读 +transfer；--as 用当前组织者身份，--to-user-id 传接收人，用户和机器人任意互转

任务类型分流

处理"预约/改约日程、添加/移除参会人、添加/更换会议室、调整时间"时，必须先判断新建 vs 编辑：

  • 编辑已有日程的强信号：用户提到已存在的日程锚点（标题、时间段、这个日程、这场会）并表达修改动作（添加、移除、改到、换会议室、调整时间）。默认走编辑流，绝不能按新建处理。
  • 新建日程：用户表达新增意图（"新约一个会""创建一个日程""安排一次会议"），且没有指向既有日程的修改动作。

时间推断规范

  • 星期的定义：周一是一周的第一天，周日是最后一天。计算"下周一"等相对日期时，基于当前真实日期推算。
  • 一天的范围：用户提到"明天""今天"等泛指某天时，时间范围应覆盖整天，不要自行缩减。
  • 历史时间约束：不能预约已经完全过去的时间。唯一例外是"跨越当前时间"的日程（开始在过去、结束在未来）。

会议室规则

  • 凡是"预定/查询/搜索可用会议室"，都必须进入 schedule-meeting 工作流，会议室参数规范详见 +room-find。
  • +room-find 的时间输入必须是确定时间块，不能是时间区间搜索。
  • 用户仅要求"查会议室"但未提供明确时间时，必须先调用 +suggestion 获取可用时间块，再将时间块交给 +room-find。严禁猜测时间盲目调用。
  • 编辑已有日程时，"添加会议室"默认是增量语义，保留已有会议室；只有用户明确说"更换会议室""移除会议室"时才删除旧会议室。

API Resources

# 通用调用格式
lark-cli calendar <resource> <method> [flags]

# 查询用户主日历
lark-cli calendar calendars primary

# 获取日程详情及 app_link
lark-cli calendar events get --calendar-id <calendar_id> --event-id <event_id>

# 获取日程分享链接（分享给他人/群前必须先拿到）
# 返回形如 {{domain}}/calendar/share?token=<token> 的分享链接，不是 applink；直接把该链接发给对方（对方可凭链接中的 token 走 +join-event 加入）
lark-cli calendar events share_info --calendar-id <calendar_id> --event-id <event_id>

# 删除日程
lark-cli calendar events delete --calendar-id <calendar_id> --event-id <event_id>

calendar_id 可以直接传 primary，代表当前调用身份的主日历 ID。

查询资源的方法列表以及方法的使用方式

  • 列出某资源下的方法：lark-cli calendar <resource> -h
  • 查看方法的cli flag：lark-cli calendar <resource> <method> -h
  • 查看方法API参数：lark-cli schema calendar.<resource>.<method>

<resource> 为 calendars（日历本身）/ events（日程）/ event.attendees（参与人）/ freebusys（忙闲）。例：lark-cli schema calendar.events.delete。

常用其他域命令

# 搜索用户，更多参数详见 lark-contact
lark-cli contact +search-user --query <query> --as user

# 搜索群聊，更多参数详见 lark-im
lark-cli im +chat-search --query <query> --as user

搜索用户/群不支持 bot 身份，必须用 --as user。解析不到或类型不明确时，向用户澄清该参会人类型，不要靠名字形态硬猜类型。

不在本 skill 范围

注意（强制性）：

  • 涉及日期（时间）字符串与时间戳的相互转换时，务必调用系统命令或脚本代码等外部工具进行处理，以确保转换的绝对准确；换算禁止依赖容器默认时区（常为 UTC，会导致 8 小时偏移），必须显式指定目标时区。违者将导致严重的逻辑错误！

Все файлы скилла

Другие скиллы автора

lark-shared

428,016 установок

larksuite/cli

Базовый скилл для работы с lark-cli: управление аутентификацией, выбором идентичности пользователя или бота, настройкой доменов и прав доступа. Обеспечивает корректную обработку ответов, безопасность операций и генерацию QR-кодов для авторизации.

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-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 продолжали работать.