{
  "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"
      ]
    }
  }
}