Agent skill · software engineering · aiskillstore
lark-calendar
飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-vc)、待办任务(走 lark-task)。
Why this skill is useful
Adds specific commands and workflows for managing calendar events and meeting rooms that the AI wouldn't reliably generate on its own.
What it needs
Requires lark-cli installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
calendar (v4) 开始前先读 ../lark-shared/SKILL.md(认证、权限处理)。 CRITICAL — 凡涉及预约日程/会议室、调整时间或查询/搜索会议室,第一步 MUST 读 references/lark-calendar-schedule-meeting.md。仅编辑字段(改标题/描述)或增删参会人(不涉及时间和会议室)时可跳过,直接读 references/lark-calendar-update.md。 身份 日程操作默认使用 --as user(查看和管理当前用户的日程)。--as bot 只能访问 bot 自己的(空)日历,会拿到空结果——不要用 bot 身份查用户日程。 Shortcuts Shortcut 说明 ---------- ------ +agenda 查看日程安排(默认今天) +meeting 通过日程事件 ID 获取关联的视频会议信息(meetingid、meetingnote),日程开过视频会议才会有meetingid +create 创建日程并邀请参会人(ISO 8601 时间) +update 更新既有日程字段,或独立增量添加/移除参会人和会议室 +freebusy 查询用户主日历的忙闲信息和 RSVP 状态(纯查询场景;预约场景走 +suggestion) +room-find 针对一个或多个明确的时间块查找可用会议室(无明确时间时禁止直接调用,需先走 +suggestion) +rsvp 回复日程(接受/拒绝/待定) +suggestion 根据非明确时间或一段时间范围,推荐多个可用时间块方案 +get — 单日程详情 通过 calendarid + eventid 获取单个日程详情。 +search-event — 按关键词、时间范围和参会人搜索日程 仅返回基础字段(eventid/summary/start/end 等),需要详情请走 +get。 +agenda — 查看近期日程安排 默认查询当天。结果应整理为按日期分组、按开始时间升序的易读时间线。 注意: 已取消的日程自动过滤;无日程时直接告知"日程清空"。 时间范围超过 40 天会自动拆分查询并合并结果。 +freebusy — 查询主日历忙闲时段和 RSVP 状态 仅返回忙碌时段起止时间,不含日程标题等隐私信息;其他订阅日历不在范围内。 用法提示: 仅判断是否有空 → +freebusy;需要日程详情 → +agenda。 检查多人可用性:分别调用并对比,找共同空闲。 预约/改约场景下,调用规则(参与人过多、含群组、来自 +suggestion 等)详见 schedule-clear-time.md § 查询忙闲。 前置条件路由 场景 前置要求 ------ ---------- 预约日程/会议、调整时间、查会议室 先读 lark-calendar-schedule-meeting.md 仅编辑字段(标题/描述)或增删参会人 先定位 eventid,再读 lark-calendar-update.md 编辑已有日程(涉及时间或会议室) 先定位目标日程 eventid;若是重复性日程,必须定位到具体实例的 eventid(禁止使用原重复日程 ID) 编辑/删除重复性日程 先读 重复性日程操作规范,按操作范围(仅此次/全部/此次及后续)执行 调用任何 Shortcut 先读其对应 reference 文档 写操作反馈 创建、更新、删除、RSVP 等写操作完成后,直接基于命令返回结果反馈用户;不要为了“确认是否生效”主动发起二次查询。只有用户明确要求复查,或命令返回信息不足以回答用户问题时,才需要再查询。 核心概念 日程实例(Instance):重复性日程展开后的具体时间实例。「仅此次」操作时使用具体实例的 eventid;「全部」或「此次及后续」操作时需对原重复性日程操作(使用原日程 eventid),并按需处理例外。 重复性日程例外(Exception):对重复性日程某次实例做过「仅此次」编辑后产生的独立日程(拥有独立 eventid)。删除/更新「全部」时必须同时处理例外,否则例外会残留。 全天日程(All-day Event):只按日期占用、没有具体起止时刻的日程,结束日期是包含在日程时间内的。 时间块 vs 时间范围:时间块是具体确定的连续时间段(如 14:00~15:00),时间范围是泛指(如"今天下午")。+room-find 必须基于确定时间块,不能基于模糊范围。 会议室(Room):"room"不是"房间",是"会议室"。会议室是日程的一种参与人(resource attendee),不能脱离日程单独预定。 日程会议 ID(Meeting ID):日程的历史视频会议 ID,在日程上开过视 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/lark-calendar