用途
gog-calendar 是 gog 工具集中的一个技能，用于通过命令行执行 Google Calendar 操作。它面向需要以脚本或自动化方式读写 Google 日历的场景，例如查询日程、检查空闲时间、创建或修改事件等。
主要能力
该技能提供以下命令：
- acl：列出日历 ACL
- alias：管理日历别名
- calendars：列出日历
- changed：列出最近更改的事件（包括删除）
- colors：显示日历颜色
- conflicts：查找跨日历的忙碌时间重叠
- create：创建事件
- create-calendar：创建新的次级日历
- delete：删除事件
- delete-calendar：删除拥有的次级日历
- event：获取事件
- events：列出某个日历或所有日历的事件
- focus-time：创建专注时间块
- freebusy：获取空闲/忙碌信息
- move：将事件移动到另一个日历
- out-of-office：创建不在办公室事件
- propose-time：生成提议新会议时间的 URL（仅浏览器功能）
- raw：以 JSON 形式导出原始 Google Calendar API 响应（Events.Get；无损；用于脚本和 LLM 消费）
- respond：响应事件邀请
- search：搜索事件
- subscribe：将日历添加到日历列表
- team：显示 Workspace 组成员的事件（服务账号、直接令牌或 ADC）
- time：显示服务器时间
- unsubscribe：从日历列表移除日历
- update：更新事件
- users：列出工作区用户（使用其邮箱作为日历 ID）
- working-location：设置工作地点（家庭/办公室/自定义）
使用方式
使用前应先阅读 ../gog/SKILL.md，了解共享的认证、输出、安全与实时写入规则。
安全起步示例：
gog auth list --check --json --no-input gog schema calendar --json gog --readonly --account user@example.com calendar events --today --json --wrap-untrusted
使用要点：
- 通过 --account 显式选择账号。
- 使用 --json --wrap-untrusted 获得可供代理读取的 Google 内容。
- 当任务不得修改 Google 数据时使用 --readonly。
- 在自动化中使用 --no-input，在支持的写入操作前使用 --dry-run。
- 在任何写入或删除之前，确认确切的账号、对象和变更。
运行 gog calendar <command> --help 查看标志，运行 gog schema calendar <command> --json 查看机器可读的契约。不要猜测命令语法。
适用场景
适用于需要通过命令行或自动化流程管理 Google 日历的用户，例如批量查询日程、检查会议冲突、创建专注时间或不在办公室事件、搜索事件、管理日历订阅等。
限制
资料未提供关于收费、价格、平台支持范围、具体效果或性能的说明。propose-time 为仅浏览器功能。部分命令（如 team）需要服务账号、直接令牌或 ADC。使用前需具备相应的 Google 账号认证与权限。