用途：该技能为 AI 智能体提供与 Cal.diy API v2 交互的指引，实现排期自动化、预订管理和日历集成。所有请求发送至基础地址 https://api.cal.com/v2。
主要能力：涵盖事件类型（可预订会议配置，含时长、地点、可用规则，每个有唯一 slug）、预订（确认的预约，含唯一 UID）、日程（用户可预订时段）、时段（可预订的可用时间窗口），以及日历连接、忙碌时间和 Webhook 实时通知。
认证：所有请求需 Bearer token，格式为 Authorization: Bearer cal_<your_api_key>。必需环境变量 CAL_API_KEY（以 cal_live_ 或 cal_test_ 开头，在 Settings > Developer > API Keys 生成）。可选变量：CAL_CLIENT_ID（OAuth 客户端 ID，作为 x-cal-client-id 头）、CAL_SECRET_KEY（OAuth 客户端密钥，作为 x-cal-secret-key 头）、CAL_WEBHOOK_SECRET（用于通过 X-Cal-Signature-256 头验证 Webhook 签名）。
用法示例：查询可用时段 GET /v2/slots?startTime=2024-01-15T00:00:00Z&endTime=2024-01-22T00:00:00Z&eventTypeId=123；创建预订 POST /v2/bookings，JSON 体含 start、eventTypeId 和 attendee（name、email、timeZone）；设置 Webhook POST /v2/webhooks，含 subscriberUrl 和 triggers（如 BOOKING_CREATED、BOOKING_CANCELLED）。常见流程：预订会议（查时段→创建预订→保存 UID）、改期（获取新时段→POST /v2/bookings/{uid}/reschedule）、取消（POST /v2/bookings/{uid}/cancel，可带原因）。
适用场景：构建需要自动化排期、预订管理或日历集成的应用与平台集成。
限制与最佳实践：创建预订前先检查时段可用性；保存预订 UID 以便后续取消或改期；所有时间戳使用 ISO 8601 格式；实现 Webhook 处理器获取实时更新；用指数退避处理速率限制。详细参考文档包括 authentication.md、bookings.md、event-types.md、schedules.md、slots-availability.md、calendars.md、webhooks.md，另有完整 API 参考与 OpenAPI 规范。