跨日历智能日程管家

基于 gogcli 的 Google Calendar 管理技能，支持跨日历日程聚合与智能搜索，由社区开发者维护，为命令行用户提供高效日历管理体验。

基本信息

• 技能名称?gog-calendar
• 中文名称?跨日历智能日程管家
• 作者?lstpsche
• 分类?专业技能
• 版本?v1.0.0
• 标签?productivity, automation, api, office, operations

使用方法

使用说明
核心用法
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 选项，适合脚本化运行。
   潜在缺点与局限性
6. 外部工具依赖 ：Skill 本身无执行能力，完全依赖用户自行安装的 gogcli，若未安装或版本不兼容则无法使用。
7. 搜索性能开销 ：跨日历关键词搜索需逐一日历查询，日历数量多时延迟较高。
8. 最佳努力搜索 ：关键词匹配依赖 gogcli 的实现，复杂查询可能需回退到日期范围列举+本地过滤。
9. T3 来源可信度 ：由社区/个人开发者维护，非 Google 官方方案，长期维护稳定性存疑。
10. 无可视化界面 ：纯命令行交互，对非技术用户不够友好。
    适合的目标群体
    习惯命令行工作流的开发者和技术用户
    需要高效管理多个 Google Calendar 的重度日历用户
    希望降低 AI 调用 Token 消耗的自动化场景搭建者
    已在使用 gogcli 或愿意配置 OAuth 授权的用户
    使用风险
    依赖项风险 ：gogcli 需通过 Homebrew 从第三方 tap（steipete/tap）安装，用户需自行验证来源可信度
    OAuth 安全 ：gogcli 需要 Google Calendar API 授权，凭据管理不当可能导致数据泄露
    网络环境限制 ：需能访问 Google Calendar API，部分网络环境可能无法使用
    版本兼容性 ：gogcli 更新可能导致命令参数变化，需关注版本匹配