钉钉日历 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。22 个 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。

意图表

用户说	命令
"今天 / 明天 / 本周日程"	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。