القائمة
飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。
| name | lark-calendar |
| version | 1.0.0 |
| description | 飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。 |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli calendar --help"} |
开始前先读 ../lark-shared/SKILL.md（认证、权限处理）。
CRITICAL — 凡涉及预约日程/会议或查询/搜索会议室，第一步 MUST 读 references/lark-calendar-schedule-meeting.md。禁止跳过此步直接调用 API 或 Shortcut！
日程操作默认使用 --as user（查看和管理当前用户的日程）。--as bot 只能访问 bot 自己的（空）日历，会拿到空结果——不要用 bot 身份查用户日程。
# BAD — bot 身份查用户日程，返回空列表
lark-cli calendar +agenda --as bot
# GOOD — user 身份查日程
lark-cli calendar +agenda --as user
| Shortcut | 说明 |
|---|---|
+agenda | 查看日程安排（默认今天） |
+create | 创建日程并邀请参会人（ISO 8601 时间） |
+update | 更新既有日程字段，或独立增量添加/移除参会人和会议室 |
+freebusy | 查询用户主日历的忙闲信息和 RSVP 状态 |
+room-find | 针对一个或多个明确的时间块查找可用会议室（无明确时间时禁止直接调用，需先走 +suggestion） |
+rsvp | 回复日程（接受/拒绝/待定） |
+suggestion | 根据非明确时间或一段时间范围，推荐多个可用时间块方案 |
| 场景 | 前置要求 |
|---|---|
| 预约日程/会议、查会议室 | 先读 lark-calendar-schedule-meeting.md |
| 编辑已有日程 | 先定位目标日程 event_id；若是重复性日程，必须定位到具体实例的 event_id（禁止使用原重复日程 ID） |
| 删除/修改后验证 | 等待 2 秒再查询（API 最终一致性），不要告知用户你等待了 |
| 调用任何 Shortcut | 先读其对应 reference 文档 |
event_id，禁止使用原重复日程的 event_id。14:00~15:00），时间范围是泛指（如"今天下午"）。+room-find 必须基于确定时间块，不能基于模糊范围。用户日常说的"帮我约个日历""查一下今天的日历"，实际意图是针对**日程（Event）**的创建或查询，而非操作日历（Calendar）容器本身。自动将口语化的"日历"意图映射为"日程"操作。
| 用户意图 | 路由到 |
|---|---|
| 查询过去的会议（"昨天的会议""上周的会"） | ../lark-vc/SKILL.md（会议数据含即时会议，仅查日程会遗漏） |
| 查询日历/日程或未来时间的会议 | 本 skill |
| 预约/改约日程、添加/移除参会人、添加/更换会议室、调整时间 | 先判断新建 vs 编辑，再进入 schedule-meeting 工作流 |
处理"预约/改约日程、添加/移除参会人、添加/更换会议室、调整时间"时，必须先判断新建 vs 编辑：
这个日程、这场会）并表达修改动作（添加、移除、改到、换会议室、调整时间）。默认走编辑流，绝不能按新建处理。+room-find 的时间输入必须是确定时间块，不能是时间区间搜索。+suggestion 获取可用时间块，再将时间块交给 +room-find。严禁猜测时间盲目调用。lark-cli calendar <resource> <method> [flags]
create — 创建共享日历delete — 删除共享日历get — 查询日历信息list — 查询日历列表patch — 更新日历信息primary — 查询用户主日历search — 搜索日历batch_delete — 删除日程参与人create — 添加日程参与人list — 获取日程参与人列表create — 创建日程delete — 删除日程get — 获取日程instance_view — 查询日程视图patch — 更新日程search_event — 搜索日程（仅返回 日程ID/主题/时间，详情需走 events get）share_info — 获取日程分享链接list — 查询主日历日程忙闲信息注意（强制性）：
飞书云文档（Docx / Wiki 文档，v2 API）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 URL 路径模式和 token，而不是域名。不负责文档评论管理，也不负责表格或 Base 的数据操作。
Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, VC meeting ended, Minutes generated, Whiteboard updated, etc.). Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers. Supports `--max-events` / `--timeout` bounded runs and a stderr ready-marker contract — designed for AI agents running as subprocesses.
飞书云空间（云盘/云存储）：管理云空间（云盘/云存储）中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV/PPTX 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable、slides）。当用户需要上传或下载文件、整理云空间（云盘/云存储）目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base/幻灯片 时使用。"云空间"、"云盘"和"云存储"是同一概念，用户说"云盘"、"云存储"、"网盘"、"我的空间"时均路由到本 skill。当用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是资源类型、URL 路径模式和 token，而不是域名。
飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
飞书妙记：搜索妙记列表、查看妙记基础信息、下载妙记音视频文件、上传音视频生成妙记、更新妙记标题、替换说话人。当需要获取、操作或者生成妙记时使用。也支持将本地音视频文件转成纪要和逐字稿（优先使用本 skill，不要用 ffmpeg/whisper 本地转写）。不负责：获取会议关联妙记、纪要/逐字稿内容获取走 lark-vc
飞书视频会议：搜索历史会议记录、查询会议纪要（总结/待办/章节/逐字稿）、查询参会人快照。当用户查询已结束的会议、获取会议产物（纪要/妙记）、查看参会人时使用；查询未来日程走 lark-calendar。不负责：Agent 真实入会/离会、会中实时事件（走 lark-vc-agent）。