dingtalk-calendar

钉钉日历 Skill

前置条件 — 执行操作前必读

**CRITICAL — 执行任何 dws 操作前，MUST 先用 Read 工具完整读取 dingtalk-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。

常用路径直接按本文件执行，不要预读大而全的 calendar.md。仅在循环日程、响应邀请、共享/ACL、附件、日历本或低频参数无法由本文件定位时按需读取对应小节；订会议室的范围与失败收束才读取 03-meeting.md。

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

以下 shortcut 同时进入公开 catalog 与 Runtime Schema。按本 skill/recipe 路由，命中时 Shortcut 优先于原子命令。参数只查 dws schema --cli-path "calendar +<shortcut>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json；仅需且已发布 result 时查 --jq '{cli_path,outcomes:.result.outcomes,pagination}'，字段级再查 data_schema；缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help；unknown flag 用同 leaf Help 修正一次。unknown command 禁 Help：错误 suggestion → 已加载 Skill/reference 明确入口；均无则报漂移。禁全 Catalog/root/parent/product Help；仅映射、接口或 provenance 审计省略 --compact。现有路由和 reference 均无法定位低频能力时，才用 dws shortcut list --service calendar --format json 发现。

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-find	read	按时间段搜索可用会议室（不传时间默认当前起 1 小时）
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	列出我本周的日程（自动按周一为周首计算本周起止时间，无需手动填时间范围）