Google Calendar (via gogcli)

核心用法

gog-calendar 是基于 gogcli 的 Google Calendar 技能，提供跨日历的日程查询与事件搜索能力。

主要功能

| 场景 | 命令模式 | 输出格式 |

|------|---------|---------|

| 日程查看（今天/本周/自定义范围） | `gog calendar events --all --from X --to Y` | `--plain` 默认，节省 Token |

| 跨日历关键词搜索 | 遍历所有日历 + 聚合结果 | `--json` 用于结构化处理 |

| 日历列表 | `gog calendar calendars` | `--json` 获取元数据用于过滤 |

显著优点

• 跨日历聚合：自动查询所有日历并合并结果，避免遗漏多账户/多日历场景
• Token 效率：默认 --plain 纯文本输出，仅在需要结构化数据时用 --json
• 智能过滤：自动排除节假日等噪音日历（支持用户自定义排除列表）
• 写入安全：任何创建/更新/删除操作前必须显式确认
• 自动化友好：--no-input 标志支持无人值守场景

潜在局限

• 关键词搜索需逐日历迭代查询，非原生全量搜索，性能取决于日历数量
• 默认搜索窗口为未来 6 个月，超期事件需显式扩展范围
• 依赖 gogcli 二进制，需单独安装（Homebrew: steipete/tap/gogcli）
• 对 Google Calendar API 限频敏感，大量日历时可能触发速率限制

适合人群

• 多日历管理者（工作/个人/共享日历）
• 需要程序化日历查询的开发者/自动化用户
• 注重 Token 成本的大模型 Agent 场景

常规风险

| 风险 | 缓解措施 |

|-----|---------|

| 误删/误改事件 | 写入前强制二次确认 |

| 搜索遗漏（节假日过滤过度） | 显式报告过滤的日历名称 |

| 时区歧义 | 使用 ISO 8601 格式或明确时区 |

| API 限频 | 减少并发查询，必要时降速 |

核心用法

gog-calendar 是基于 gogcli 命令行工具的 Google Calendar 集成 Skill，提供跨日历议程查询和关键词搜索能力。

议程查询：使用 gog calendar events --all --from <date> --to <date> --plain 获取多日历事件，自动按时间排序并按天分组展示。默认使用 --plain 模式以节省 Token，仅在需要结构化数据时使用 --json。

关键词搜索：因 Google Calendar API 按日历隔离查询，Skill 采用迭代策略：先列出所有日历，再对每个日历执行搜索，最后聚合、去重、排序结果。默认搜索未来 6 个月，未找到时会主动建议扩大范围。

日历过滤：智能排除节假日等系统日历（支持用户自定义排除列表），过滤结果会明确标注。

写入操作：创建/更新/删除/RSVP 前必须总结完整信息并获得用户明确确认。

显著优点

1. Token 效率优化：默认 --plain 输出，仅在需要结构聚合时用 --json，显著降低大模型上下文消耗
2. 跨日历聚合：自动迭代多日历搜索，解决 Google Calendar API 的单日历查询限制
3. 智能过滤：自动识别并排除节假日日历，避免结果噪音
4. 安全设计：纯 Markdown 文档型 Skill（T-MD），无可执行代码；所有写入操作需用户显式确认
5. 最佳努力策略：搜索无结果时提供优雅的降级方案（建议扩大范围或按日期浏览）

潜在局限

1. 外部工具依赖：必须预先安装 gogcli，且需配置 Google OAuth 认证
2. 搜索性能：跨日历关键词搜索需串行迭代调用，日历数量多时延迟较高
3. API 限制：受 Google Calendar API 配额限制，高频使用可能触发限流
4. 离线不可用：完全依赖 Google Calendar 在线服务

适合人群

• 需要快速查看多日历日程的开发者/效率用户
• 使用 gogcli 已建立工作流的 Google Calendar 重度用户
• 希望减少 Token 消耗、获得结构化日历摘要的 AI 辅助场景

常规风险

• OAuth 权限：gogcli 需要 Google 账号授权，建议定期审查权限范围
• 数据隐私：日历事件数据通过 gogcli 传输，需信任该工具及 Homebrew 分发渠道
• 误操作风险：虽然写入需确认，但用户快速确认时仍可能产生意外修改