用途
gws-calendar-agenda 是 gws-claude-plugin 提供的日历日程查看技能，用于跨所有日历展示即将到来的事件。
主要能力
- 查询所有日历中即将到来的事件（默认行为）
- 按时间范围筛选：今天（--today）、明天（--tomorrow）、本周（--week）、未来指定天数（--days）
- 按日历筛选：--calendar，可填日历名称或 ID
- 按 IANA 时区覆盖：--timezone（例：America/Denver），默认使用 Google 账号时区
- 支持输出格式切换，例如 --format table
使用方式
前置条件：阅读 ../gws-shared/SKILL.md 了解认证、全局参数与安全规则。若缺失，运行 gws generate-skills 生成。
基本命令：
gws calendar +agenda
示例：
gws calendar +agenda gws calendar +agenda --today gws calendar +agenda --week --format table gws calendar +agenda --days 3 --calendar 'Work' gws calendar +agenda --today --timezone America/New_York
参数说明
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
| --today | 否 | — | 显示今天的事件 |
| --tomorrow | 否 | — | 显示明天的事件 |
| --week | 否 | — | 显示本周的事件 |
| --days | 否 | — | 向前显示的天数 |
| --calendar | 否 | — | 筛选到特定日历名称或 ID |
| --timezone | 否 | — | IANA 时区覆盖（例：America/Denver），默认使用 Google 账号时区 |
适用场景与限制
适用于快速查看跨多个日历的近期日程安排，以及需要按天、周或指定日历过滤日程的场合。
限制与注意事项：
- 只读操作，绝不修改事件
- 默认查询所有日历；如需限定范围请使用 --calendar
- 默认使用 Google 账号时区；可用 --timezone 覆盖
- 使用前需具备 gws-shared 中的认证与安全配置
相关
- gws-shared — 全局参数与认证
- gws-calendar — 管理日历与事件的全部命令