gog-calendar

核心用法

gog-calendar 是一个纯文档型 Agent Skill，用于通过 gogcli 命令行工具管理 Google Calendar。其核心功能分为三大模块：日程查看（Agenda）、关键词搜索（Search）和写操作（Writes）。

日程查看：支持跨日历查询今日、本周或指定日期范围的日程，默认使用 --plain 模式以节省 Token，自动按时间排序并分组展示。命令示例：：gog calendar events --all --from 2026-02-04 --to 2026-02-05 --plain。

关键词搜索：由于 Google Calendar API 的搜索限制（需按 calendarId 分别查询），该技能采用迭代聚合策略——遍历所有日历、合并结果、去重排序。默认搜索窗口为未来 6 个月，支持 JSON 输出以便结构化处理。

写操作：创建、更新、删除事件或 RSVP 前，必须向用户确认具体意图（日历、标题、时间、时区、参与者、地点），获得明确"yes"后方可执行。

显著优点

1. Token 效率优化：默认 --plain 输出，仅在需要结构化处理时使用 --json，显著降低大模型调用成本。
2. 智能日历过滤：自动排除节假日等噪音日历（如包含 "holiday" 关键字的日历），同时保留用户自有日历，提升信息质量。
3. 跨日历聚合能力：突破单日历搜索限制，实现真正的全局事件检索。
4. 安全确认机制：所有写操作强制二次确认，防止误操作。
5. 自动化友好：提供 --no-input 选项，适合脚本化运行。

潜在缺点与局限性

1. 外部工具依赖：Skill 本身无执行能力，完全依赖用户自行安装的 gogcli，若未安装或版本不兼容则无法使用。
2. 搜索性能开销：跨日历关键词搜索需逐一日历查询，日历数量多时延迟较高。
3. 最佳努力搜索：关键词匹配依赖 gogcli 的实现，复杂查询可能需回退到日期范围列举+本地过滤。
4. T3 来源可信度：由社区/个人开发者维护，非 Google 官方方案，长期维护稳定性存疑。
5. 无可视化界面：纯命令行交互，对非技术用户不够友好。

适合的目标群体

• 习惯命令行工作流的开发者和技术用户
• 需要高效管理多个 Google Calendar 的重度日历用户
• 希望降低 AI 调用 Token 消耗的自动化场景搭建者
• 已在使用 gogcli 或愿意配置 OAuth 授权的用户

使用风险

• 依赖项风险：gogcli 需通过 Homebrew 从第三方 tap（steipete/tap）安装，用户需自行验证来源可信度
• OAuth 安全：gogcli 需要 Google Calendar API 授权，凭据管理不当可能导致数据泄露
• 网络环境限制：需能访问 Google Calendar API，部分网络环境可能无法使用
• 版本兼容性：gogcli 更新可能导致命令参数变化，需关注版本匹配