dingtalk-calendar

name	dingtalk-calendar
description	钉钉日历与会议室。Use when 用户说 约会议/查日程/订会议室/查闲忙/加参会人/改期/取消会议/今天的日程/本周日程/共同空闲。视频会议发起/邀请入会/会中控制当前 CLI 不支持，应提示在钉钉客户端操作。Distinct from dingtalk-minutes(听记)、dingtalk-todo(待办)。命令前缀：dws calendar。
cli_version	>=0.2.14
metadata	{"category":"product","stability":"experimental","requires":{"bins":["dws"]}}

钉钉日历 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。

PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.

⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。

命令参考：calendar.md；剧本：03-meeting.md。

Shortcuts（无专用脚本/recipe 时优先）

以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service calendar --format json 读取参数、约束、风险和示例，并以 dws calendar <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。

Shortcut	风险	适用场景
dws calendar +agenda	read	查询日程列表（不传时间默认查询今天）
dws calendar +attendee-list	read	查看日程参会人
dws calendar +book	write	创建日程，并可按姓名邀请参会人（自动解析 userId，失败自动回滚删除日程）
dws calendar +book-list	read	查询用户的日历本列表
dws calendar +book-search	read	按名称模糊搜索日历本
dws calendar +cancel-event	high-risk-write	取消（删除）一个已有日程（删除前先确认它真实存在）
dws calendar +conflicts	read	检测我某天日程的时间冲突（重叠/双重预订，默认今天）
dws calendar +free	read	按姓名查询某人在指定时间段内的忙闲状态（自动解析 userId）
dws calendar +free-slots	read	找我某天工作时段内的空闲时间段（默认今天 09:00-18:00）
dws calendar +freebusy	read	查询用户 / 会议室闲忙状态（--users 与 --rooms 至少其一）
dws calendar +invite	write	按姓名把参会人加入已有日程（自动解析 userId 后批量添加）
dws calendar +my-free	read	查我自己在某时间段的忙闲（默认今天，无需输入姓名）
dws calendar +next-event	read	查看接下来最近的一个日程（默认扫描未来 7 天）
dws calendar +reschedule	write	改一个已有日程的时间（只动开始/结束时间，其他字段不变）
dws calendar +room-groups	read	会议室分组列表
dws calendar +room-search	read	按名称模糊搜索会议室（不检查可用性）
dws calendar +suggest-time	read	按姓名解析多位参与者，推荐大家都有空的可开会时间段（自动解析 userId）
dws calendar +today	read	列出我今天的日程（自动计算今天的起止时间，无需手动填时间范围）
dws calendar +tomorrow	read	列出我明天的日程（自动计算明天的起止时间，无需手动填时间范围）
dws calendar +week	read	列出我本周的日程（自动按周一为周首计算本周起止时间，无需手动填时间范围）

意图表

用户说	命令
"今天 / 明天 / 本周日程"	python scripts/calendar_today_agenda.py [today|tomorrow|week]
"约会议（含参会人 + 会议室）"	python scripts/calendar_schedule_meeting.py --title "<主题>" --start "<起>" --end "<止>" [--users <ids>] [--book-room]
"多人共同空闲"	python scripts/calendar_free_slot_finder.py --users <ids> --date <yyyy-MM-dd>
"查闲忙"	dws calendar busy search --users <id> --start "<ISO>" --end "<ISO>"
"加参会人" / "订房" / "取消"	dws calendar attendee add / room add / event delete

执行硬约束

• 多轮日程任务必须保留 eventId，后续加人、移人、订房、换房、改描述、删除都基于同一个 eventId 执行；不要重新创建重复日程。
• 用户明确说"帮我订一个空闲会议室"时，room search 返回可用会议室后直接选择第一个可预订且不需要自定义审批的 roomId 执行 room add；不要把选择权抛回用户导致任务停住。
• 已有日程订房：dws calendar room search --start ... --end ... --format json → dws calendar room add --event <EVENT_ID> --rooms <ROOM_ID> --format json → event get 或 room/busy 验证。
• 换会议室：先 room delete --event <EVENT_ID> --rooms <OLD_ROOM_ID>，再 room add --event <EVENT_ID> --rooms <NEW_ROOM_ID>，最后回查；不要只更新 --location。
• 参会人变化用 attendee add/delete，日程描述变化用 event update --desc，删除日程用 event delete --id。用户当前消息已明确要求删除/取消时可直接执行；否则先确认。
• 脚本失败或参数不完整时，立即降级到明确的 dws calendar event/attendee/room 命令，不要停在"我要查看用法"。
• 所有 dws 命令带 --format json；查询时间必须显式 --start / --end。

跨产品协作

• 视频会议发起 / 入会链接 / 邀请入会 / 会中控制 → 当前 CLI 不支持，请在钉钉客户端操作；预约日程仍走 calendar
• 会后摘要 / 待办 → 切到 dingtalk-minutes
• 参会人按人名 → 先用 dingtalk-aisearch 解析

注意

schedule-meeting 必须读 03-meeting.md 中的「两准则」「搜房失败硬门禁」，禁止假设 roomId。