github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
codex/aitable-run2
dingtalk-workspace-cli/internal/cli/schema_hints/selection/calendar.json
T
修雨 2c10be2a1a feat(schema): publish 210 built-in shortcuts (#802) 
Publishes all 210 public built-in shortcuts as reviewed Agent-visible
leaf tools across 16 product groups, with stable canonical identities,
executable +shortcut CLI paths, parameter and cross-parameter
constraints, selection guidance, interface metadata, and runtime-aligned
safety/confirmation semantics. Catalog grows from 603 to 813 tools.
2026-07-28 00:11:29 +08:00

847 lines
43 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-agent-selection/calendar",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"calendar.add_attachments": {
"agent_summary": "为日程添加附件",
"use_when": [
"已知 eventId，已有钉盘 fileId，需要为日程添加附件时（订阅日历日程不支持）"
],
"avoid_when": [
"尚未上传钉盘文件取得 fileId 时不要调用",
"只需查询日程时改用 dws calendar event get"
],
"examples": [
"dws calendar attachment add --event <EVENT_ID> --files <FILE_ID>:report.pdf,<FILE_ID2>:slides.pptx",
"dws calendar attachment add --event <EVENT_ID> --files <FILE_ID>:report.pdf --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar attachment add --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.add_attachments"
]
},
"calendar.add_calendar_participant": {
"agent_summary": "添加日程参与人",
"use_when": [
"已知 eventId，需要向已有日程批量添加参会人时（订阅日历日程无参会人）"
],
"avoid_when": [
"要查看参会人时改用 dws calendar attendee list",
"要移除参会人时改用 dws calendar attendee delete"
],
"examples": [
"dws calendar attendee add --event <EVENT_ID> --attendees <USER_ID_1>,<USER_ID_2>",
"dws calendar attendee add --event <EVENT_ID> --attendees <USER_ID> --optional"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar attendee add --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.add_calendar_participant"
]
},
"calendar.add_meeting_room": {
"agent_summary": "为日程预订会议室",
"use_when": [
"已知 eventId 与 roomId，需要为已有日程预订线下会议室时"
],
"avoid_when": [
"要搜索空闲会议室时先用 dws calendar room search",
"要取消会议室预订时改用 dws calendar room delete"
],
"examples": [
"dws calendar room add --event <EVENT_ID> --rooms <ROOM_ID>",
"dws calendar room add --event <EVENT_ID> --rooms <ROOM_ID> --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar room add --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.add_meeting_room"
]
},
"calendar.create_calendar_event": {
"agent_summary": "创建日程",
"use_when": [
"需要创建新日程（时间、可选参会人/提醒/会议室/循环规则）并提取 eventId 时"
],
"avoid_when": [
"只需查询日程列表或详情时改用 event list/get",
"只改已有日程字段时改用 event update；改参会人/会议室用 attendee/room 命令"
],
"examples": [
"dws calendar event create --title \"Q1 复盘会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\"",
"dws calendar event create --title \"周会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --attendees userId1,userId2"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event create --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.create_calendar_event"
]
},
"calendar.delete_calendar_event": {
"agent_summary": "删除指定日程",
"use_when": [
"用户明确要求删除/取消指定日程，且 eventId 已确认时（组织者删除会通知所有参与者）"
],
"avoid_when": [
"只需从自己日历移除参与身份且非组织者场景需区分影响范围",
"目标 eventId 未确认或仍需保留日程时不要删除"
],
"examples": [
"dws calendar event delete --id <id>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event delete --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.delete_calendar_event"
]
},
"calendar.delete_meeting_room": {
"agent_summary": "移除日程中的会议室",
"use_when": [
"已知 eventId 与 roomId，需要取消日程会议室预订并释放占用时"
],
"avoid_when": [
"要新增预订时改用 dws calendar room add",
"eventId/roomId 未确认时不要移除"
],
"examples": [
"dws calendar room delete --event <event> --rooms <rooms>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar room delete --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.delete_meeting_room"
]
},
"calendar.get_calendar": {
"agent_summary": "查询指定日历信息",
"use_when": [
"已知日历 id（主日历固定 primary），需要查询该日历本信息时"
],
"avoid_when": [
"要列全部日历时改用 dws calendar book list",
"要按名称搜索日历本时改用 dws calendar book search"
],
"examples": [
"dws calendar book get --id primary",
"dws calendar book get --id CALENDAR_ID"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar book get --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.get_calendar"
]
},
"calendar.get_calendar_detail": {
"agent_summary": "查询日程详情",
"use_when": [
"已知 eventId，需要查看日程明细时"
],
"avoid_when": [
"要按时间查列表时改用 dws calendar event list",
"要创建/删除时改用 create/delete"
],
"examples": [
"dws calendar event get --id <EVENT_ID>",
"dws calendar event get --id <EVENT_ID> --calendar-id primary"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event get --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.get_calendar_detail"
]
},
"calendar.get_calendar_participants": {
"agent_summary": "获取日程参与人",
"use_when": [
"已知 eventId，需要查看参会人列表及状态时（订阅日历日程无参会人）"
],
"avoid_when": [
"要添加/移除参会人时改用 attendee add/delete"
],
"examples": [
"dws calendar attendee list --event <EVENT_ID>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar attendee list --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.get_calendar_participants"
]
},
"calendar.list_acls": {
"agent_summary": "查询主日历访问控制列表",
"use_when": [
"需要查看主日历共享给了谁、各自权限时（不是日历本列表）"
],
"avoid_when": [
"要列日历本时改用 dws calendar book list"
],
"examples": [
"dws calendar acl list"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar acl list --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.list_acls"
]
},
"calendar.list_calendar_events": {
"agent_summary": "查询当前用户日程列表",
"use_when": [
"需要按起止时间检索指定日历本下的日程列表时（未传起止默认查当天）"
],
"avoid_when": [
"已知 eventId 要详情时改用 dws calendar event get",
"要创建日程时改用 dws calendar event create"
],
"examples": [
"dws calendar event list --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"",
"dws calendar event list --calendar-id primary"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event list --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.list_calendar_events"
]
},
"calendar.list_calendars": {
"agent_summary": "查询用户日历列表",
"use_when": [
"需要列出自己的、已订阅的、他人共享的日历本（主日历 id=primary）时"
],
"avoid_when": [
"已知日历 id 要详情时改用 dws calendar book get",
"要按名称模糊搜索时改用 dws calendar book search"
],
"examples": [
"dws calendar book list"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar book list --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.list_calendars"
]
},
"calendar.list_meeting_room_groups": {
"agent_summary": "查询会议室分组列表",
"use_when": [
"需要分页查看企业会议室分组（groupId/parentId）时"
],
"avoid_when": [
"要搜空闲会议室时改用 dws calendar room search"
],
"examples": [
"dws calendar room list-groups",
"dws calendar room list-groups --limit 20 --page 0"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar room list-groups --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.list_meeting_room_groups"
]
},
"calendar.list_suggested_event_times": {
"agent_summary": "建议日程时间",
"use_when": [
"时间未定，需要基于参会人闲忙推荐可用时间块时"
],
"avoid_when": [
"时间已确定只需创建日程时改用 event create",
"只查闲忙片段时改用 busy search"
],
"examples": [
"dws calendar event suggest --users userId1,userId2 --duration 60",
"dws calendar event suggest --start \"2026-03-10T09:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\" --users userId1"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event suggest --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.list_suggested_event_times"
]
},
"calendar.query_available_meeting_room": {
"agent_summary": "查询空闲或按名搜索会议室",
"use_when": [
"需要按名称模糊搜会议室，或按时间段查询全程空闲且可预订的会议室时"
],
"avoid_when": [
"要完成预订时在取得 roomId 后改用 room add",
"只要会议室分组时改用 room list-groups"
],
"examples": [
"dws calendar room search --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\"",
"dws calendar room search --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --group-id <GROUP_ID>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar room search --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.query_available_meeting_room"
]
},
"calendar.query_busy_status": {
"agent_summary": "查询用户或会议室闲忙",
"use_when": [
"需要查询指定用户和/或会议室在时间范围内的已占用时段时（users 与 rooms 至少其一）"
],
"avoid_when": [
"需要创建或改日程时不要使用；本命令只返回闲忙时间片段"
],
"examples": [
"dws calendar busy search --users <USER_ID_1>,<USER_ID_2> --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"",
"dws calendar busy search --rooms <ROOM_ID_1>,<ROOM_ID_2> --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\""
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar busy search --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.query_busy_status"
]
},
"calendar.remove_calendar_participant": {
"agent_summary": "删除日程参与人",
"use_when": [
"已知 eventId，需要从日程批量移除参会人时（订阅日历日程无参会人）"
],
"avoid_when": [
"要添加参会人时改用 attendee add",
"要查看参会人时改用 attendee list"
],
"examples": [
"dws calendar attendee delete --attendees <attendees> --event <event>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar attendee delete --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.remove_calendar_participant"
]
},
"calendar.respond": {
"agent_summary": "响应日程",
"use_when": [
"作为参会人需要设置自己的响应状态（accepted/declined/tentative）时"
],
"avoid_when": [
"是组织者要改日程内容时改用 event update",
"订阅日历日程不可响应"
],
"examples": [
"dws calendar event respond --id <EVENT_ID> --status accepted",
"dws calendar event respond --id <EVENT_ID> --status declined"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event respond --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.respond"
]
},
"calendar.search_calendar": {
"agent_summary": "搜索日历本列表",
"use_when": [
"需要按日历本名模糊搜索当前用户拥有的日历本时"
],
"avoid_when": [
"要获取全部日历时改用 dws calendar book list",
"已知 id 要详情时改用 book get"
],
"examples": [
"dws calendar book search --query \"项目\"",
"dws calendar book search --query \"团队周报\""
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar book search --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.search_calendar"
]
},
"calendar.update_calendar_event": {
"agent_summary": "修改日程",
"use_when": [
"已知 eventId 且具备组织者权限，需要修改标题、时间、地点、描述等字段时"
],
"avoid_when": [
"改参会人请用 attendee add/delete；改会议室请用 room add/delete",
"目标字段未确认时不要更新"
],
"examples": [
"dws calendar event update --id <EVENT_ID> --title \"新标题\"",
"dws calendar event update --id <EVENT_ID> --desc \"新描述\" --timezone Asia/Tokyo"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"Cobra help: dws calendar event update --help",
"skills/mono/references/products/calendar.md",
"live-dws-schema:calendar.update_calendar_event"
]
},
"calendar.shortcut_agenda": {
"agent_summary": "查询日程列表（不传时间默认查询今天）",
"use_when": [
"当你想了解某人（默认自己）在某段时间内的日程安排、看看今天/本周有哪些会时使用；可传 --start/--end 圈定时间范围、--calendar-id 指定日历，返回该区间内的日程列表（含日程 ID，可配合 +get 看详情）。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +agenda",
"dws calendar +agenda --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-31T23:59:59+08:00\" --limit 50"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_agenda",
"cobra-help:dws calendar +agenda",
"ShortcutRegistry:calendar +agenda"
]
},
"calendar.shortcut_attendee_list": {
"agent_summary": "查看日程参会人",
"use_when": [
"当你想知道某个日程都有谁参加、各人的出席响应状态时使用；输入 --event 日程 ID，返回参会人列表（userId 及其接受/拒绝等状态）。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +attendee-list --event EVENT_ID"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_attendee_list",
"cobra-help:dws calendar +attendee-list",
"ShortcutRegistry:calendar +attendee-list"
]
},
"calendar.shortcut_room_search": {
"agent_summary": "按名称模糊搜索会议室（不检查可用性）",
"use_when": [
"当你只知道会议室名字、想拿到它的 roomId 以便后续预定时使用；输入 --room-name 名称关键词（建议只填核心专名，去掉“会议室”等后缀），返回名称匹配的会议室列表。它只按名字找、不判断该时段是否空闲，查可用性请用 +room-find。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +room-search --room-name 永澄亭"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_room_search",
"cobra-help:dws calendar +room-search",
"ShortcutRegistry:calendar +room-search"
]
},
"calendar.shortcut_room_groups": {
"agent_summary": "会议室分组列表",
"use_when": [
"当你想按楼层/园区等分组浏览会议室、或需要拿到 groupId 以便在 +room-find 里按分组过滤时使用；返回会议室分组列表，支持 --limit/--page 分页。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +room-groups"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_room_groups",
"cobra-help:dws calendar +room-groups",
"ShortcutRegistry:calendar +room-groups"
]
},
"calendar.shortcut_freebusy": {
"agent_summary": "查询用户 / 会议室闲忙状态（--users 与 --rooms 至少其一）",
"use_when": [
"当你要在约会前确认某些人或会议室在指定时间段是否有空、避免冲突时使用；传入 --start/--end 时间段并至少给出 --users 或 --rooms 其一，返回各对象在该区间的忙/闲时段。只看忙闲结果、不看具体日程内容，需要系统给出建议时段可用 +suggestion。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +freebusy --users userId1,userId2 --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_freebusy",
"cobra-help:dws calendar +freebusy",
"ShortcutRegistry:calendar +freebusy"
]
},
"calendar.shortcut_book_list": {
"agent_summary": "查询用户的日历本列表",
"use_when": [
"当你想知道自己有哪些日历本（主日历、项目日历、订阅日历等）、或需要拿到某个日历的 calendarId 以便在 +agenda/+create 中指定时使用；无需参数，返回全部日历本列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +book-list"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_book_list",
"cobra-help:dws calendar +book-list",
"ShortcutRegistry:calendar +book-list"
]
},
"calendar.shortcut_book_search": {
"agent_summary": "按名称模糊搜索日历本",
"use_when": [
"当你只记得日历本名字的一部分、想据此找到对应的 calendarId 时使用；输入 --query 名称关键词，返回名称匹配的日历本列表，便于后续在其它命令里指定 --calendar-id。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +book-search --query \"项目\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_book_search",
"cobra-help:dws calendar +book-search",
"ShortcutRegistry:calendar +book-search"
]
},
"calendar.shortcut_book": {
"agent_summary": "创建日程，并可按姓名邀请参会人（自动解析 userId，失败自动回滚删除日程）",
"use_when": [
"当你想快速排一个会/日程、并顺手把几位同事按姓名拉进来时使用；内部先建日程拿到 eventId，再把每个姓名解析成唯一 userId 批量加为参会人。如果加参会人失败，会自动删除刚建好的日程回滚，避免留下一个没人的空日程。会真实创建日程并发出参会邀请。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +book --title \"周会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\"",
"dws calendar +book --title \"Q1 复盘会\" --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T15:00:00+08:00\" --with 张三,李四"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_book",
"cobra-help:dws calendar +book",
"ShortcutRegistry:calendar +book"
]
},
"calendar.shortcut_cancel_event": {
"agent_summary": "取消（删除）一个已有日程（删除前先确认它真实存在）",
"use_when": [
"当你想取消/删除一个已经存在的日程时使用；内部先用 eventId 拉一次日程详情确认它真实存在并回显标题，再执行删除，避免因 eventId 写错而误删别的日程。如果 eventId 查不到会直接报错，不会盲目删除。这是高危写操作，会真实删除该日程，框架会二次确认。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +cancel-event --event EVENT_ID"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_cancel_event",
"cobra-help:dws calendar +cancel-event",
"ShortcutRegistry:calendar +cancel-event"
]
},
"calendar.shortcut_conflicts": {
"agent_summary": "检测我某天日程的时间冲突（重叠/双重预订，默认今天）",
"use_when": [
"当你想快速知道『我今天（或某天）的日程有没有时间冲突、撞车的会议』时使用；内部自动算出目标日期的时间范围（默认今天，可用 --in-days 指定几天后），列出当天全部日程，再在本地两两比对开始/结束时间，找出所有时间段重叠的日程对并报告。只读操作，不修改任何日程；没有冲突时明确告诉你「无冲突」。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +conflicts",
"dws calendar +conflicts --in-days 1"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_conflicts",
"cobra-help:dws calendar +conflicts",
"ShortcutRegistry:calendar +conflicts"
]
},
"calendar.shortcut_free_slots": {
"agent_summary": "找我某天工作时段内的空闲时间段（默认今天 09:00-18:00）",
"use_when": [
"当你想知道『我今天（或某天）还有哪些时间是空的、可以安排会议/事情』时使用；内部列出目标日期（默认今天，--in-days 指定几天后）的全部日程，合并忙碌时段，再在工作时间范围内（默认 09:00-18:00，可用 --from/--to 指定起止小时）算出所有空闲窗口并给出每段的起止与时长。只读操作，不修改任何日程；用于快速定位可预约的空档。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +free-slots",
"dws calendar +free-slots --in-days 1 --from 9 --to 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_free_slots",
"cobra-help:dws calendar +free-slots",
"ShortcutRegistry:calendar +free-slots"
]
},
"calendar.shortcut_free": {
"agent_summary": "按姓名查询某人在指定时间段内的忙闲状态（自动解析 userId）",
"use_when": [
"当你只知道对方姓名、想知道 TA 在某段时间内是空闲还是被日程占用（比如约会前先看看有没有空）而不想先手动查 userId 时使用；内部先按姓名搜通讯录解析出唯一 userId，姓名匹配到多人时会列出候选让你区分，再按时间范围查询忙闲。只读，不产生任何日程变更。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +free --who 张三 --start \"2026-03-10T14:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_free",
"cobra-help:dws calendar +free",
"ShortcutRegistry:calendar +free"
]
},
"calendar.shortcut_invite": {
"agent_summary": "按姓名把参会人加入已有日程（自动解析 userId 后批量添加）",
"use_when": [
"当你已经有一个日程（知道 eventId），想按姓名把几位同事拉进来当参会人时使用；内部先把 --with 里每个姓名解析成唯一 userId，再一次性把他们全部加到 --event 指定的日程里。会真实修改日程并发出参会邀请。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +invite --event EVENT_ID --with 张三",
"dws calendar +invite --event EVENT_ID --with 张三,李四"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_invite",
"cobra-help:dws calendar +invite",
"ShortcutRegistry:calendar +invite"
]
},
"calendar.shortcut_my_free": {
"agent_summary": "查我自己在某时间段的忙闲（默认今天，无需输入姓名）",
"use_when": [
"当你（或 AI agent）想知道『我自己什么时候有空/忙』、用于安排会议或回复邀约时使用；不用像 +free 那样传别人的姓名——内部自动解析当前用户的 userId，再查其忙闲时段。默认查今天（本地时区 00:00 到次日 00:00），也可用 --start/--end 指定 ISO8601 时间范围。只读操作，只查忙闲、不创建或修改任何日程；返回按时间排列的忙碌时段，空则表示这段时间全空。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +my-free",
"dws calendar +my-free --start 2026-07-10T09:00:00+08:00 --end 2026-07-10T18:00:00+08:00"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_my_free",
"cobra-help:dws calendar +my-free",
"ShortcutRegistry:calendar +my-free"
]
},
"calendar.shortcut_next_event": {
"agent_summary": "查看接下来最近的一个日程（默认扫描未来 7 天）",
"use_when": [
"当你只想知道『我下一个日程是什么、什么时候开始』、而不想翻一整份日程列表时使用；内部以当前时间为起点、往后 7 天为范围，拉取主日历下的日程，按开始时间升序挑出最近的那一个并打印摘要（标题、开始/结束时间、地点）。若这 7 天内没有任何日程，会明确提示『近 7 天无日程』。只读，不做任何修改。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +next-event"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_next_event",
"cobra-help:dws calendar +next-event",
"ShortcutRegistry:calendar +next-event"
]
},
"calendar.shortcut_reschedule": {
"agent_summary": "改一个已有日程的时间（只动开始/结束时间，其他字段不变）",
"use_when": [
"当你想把一个已经存在的日程改到新的时间段、又不想动标题/描述/参会人等其他内容时使用；内部先用 eventId 拉一次日程详情确认它真实存在，再只更新开始和结束时间。如果 eventId 查不到会直接报错，不会误改别的日程。会真实修改该日程的时间。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +reschedule --event EVENT_ID --start \"2026-03-10T15:00:00+08:00\" --end \"2026-03-10T16:00:00+08:00\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_reschedule",
"cobra-help:dws calendar +reschedule",
"ShortcutRegistry:calendar +reschedule"
]
},
"calendar.shortcut_suggest_time": {
"agent_summary": "按姓名解析多位参与者，推荐大家都有空的可开会时间段（自动解析 userId）",
"use_when": [
"当你想为几个人凑一个大家都空闲的开会时间、但只知道他们的姓名而不想逐个手动查 userId 时使用；内部会把 --with 里的姓名逐个搜通讯录解析成唯一 userId（任何一个没匹配到或匹配到多人都会明确报出来，绝不瞎猜），再基于所有参与者的忙闲，在给定时间范围内推荐若干可用时段。只读，不创建任何日程。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +suggest-time --with 张三,李四 --start \"2026-03-10T09:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\"",
"dws calendar +suggest-time --with 张三,李四,王五 --start \"2026-03-10T09:00:00+08:00\" --end \"2026-03-10T18:00:00+08:00\" --duration 30"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_suggest_time",
"cobra-help:dws calendar +suggest-time",
"ShortcutRegistry:calendar +suggest-time"
]
},
"calendar.shortcut_today": {
"agent_summary": "列出我今天的日程（自动计算今天的起止时间，无需手动填时间范围）",
"use_when": [
"当你想快速看看『我今天有哪些日程/会议安排』时使用；内部用本地时区自动把时间范围算成今天 00:00 到次日 00:00，转成毫秒时间戳，查询主日历（primary）下今天的全部日程。只读，不会创建或修改任何日程。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +today"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_today",
"cobra-help:dws calendar +today",
"ShortcutRegistry:calendar +today"
]
},
"calendar.shortcut_tomorrow": {
"agent_summary": "列出我明天的日程（自动计算明天的起止时间，无需手动填时间范围）",
"use_when": [
"当你想快速看看『我明天有哪些日程/会议安排』、提前准备时使用；内部用本地时区自动把时间范围算成明天 00:00 到后天 00:00，转成毫秒时间戳，查询主日历（primary）下明天的全部日程，并投影出标题、开始时间、结束时间、地点、eventId。只读，不会创建或修改任何日程。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +tomorrow"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_tomorrow",
"cobra-help:dws calendar +tomorrow",
"ShortcutRegistry:calendar +tomorrow"
]
},
"calendar.shortcut_week": {
"agent_summary": "列出我本周的日程（自动按周一为周首计算本周起止时间，无需手动填时间范围）",
"use_when": [
"当你想快速看看『我本周有哪些日程/会议安排』时使用；内部用本地时区、以周一为一周开始，自动把时间范围算成本周一 00:00 到下周一 00:00，转成毫秒时间戳，查询主日历（primary）下本周的全部日程，并投影出标题、开始时间、结束时间、eventId。只读，不会创建或修改任何日程。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws calendar +week"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#calendar.shortcut_week",
"cobra-help:dws calendar +week",
"ShortcutRegistry:calendar +week"
]
}
},
"products": {
"calendar": {
"agent_summary": "管理日历本、日程、参与人、附件、会议室，并查询人员或会议室闲忙状态。",
"use_when": [
"需要查询或管理钉钉日历、日程、参与人、会议室和闲忙信息时。"
],
"avoid_when": [
"目标是聊天消息、待办或审批，而不是日历与日程资源时。"
],
"reviewed": true,
"review_reason": "AI 语义审阅：依据 Registry 主路径、Cobra help 与 Calendar 参考文档明确命令选择边界并校验示例。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"skills/mono/references/products/calendar.md"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink