用途：该技能用于与 Google Calendar 交互，支持事件管理、日程安排和空闲时间查询，适合需要自动安排会议或查看日历可用性的场景。
主要能力：列出和获取日历；列出、获取、创建、更新、删除事件；通过 freebusy 查询指定时间段内的空闲/忙碌情况。所有命令支持 --calendar 参数（默认 primary）。时间使用 RFC3339 格式（如 2026-01-24T10:00:00Z）或 YYYY-MM-DD 表示全天事件。事件列表会自动分页，指定时间段时返回全部匹配事件。默认排除已拒绝的邀请，输出会提示被过滤数量，可用 --include-declined 包含。
使用方式：先安装依赖 pip install --user google-auth google-auth-oauthlib google-api-python-client keyring pyyaml。运行 $SKILL_DIR/scripts/google-calendar.py check 检查依赖、认证配置和 API 连通性。认证采用 OAuth 2.0，需创建 ~/.config/agent-skills/google.yaml 并填写 oauth_client 的 client_id 与 client_secret。可用 auth setup、auth reset、auth status 管理认证。常用命令包括 calendars list/get、events list/get/create/update/delete 以及 freebusy。
限制：认证、权限不足或作用域错误不可重试，遇到退出码 1 应停止并提示用户处理，需通过浏览器完成 OAuth 授权。限流（HTTP 429）和临时服务器错误（HTTP 5xx）可稍后重试，其他错误应报告用户。需使用标准能力模型处理结构化输入输出。时区问题应始终使用带偏移的 RFC3339 或 UTC（Z 后缀）格式，全天事件使用 YYYY-MM-DD 并可指定 --timezone。