Google Calendar (via gcalcli)

核心用法

gcalcli-calendar 是基于开源工具 gcalcli 的 Google Calendar 命令行封装技能，主打最少调用、最少输出、精准响应。

查询场景：支持今日/明日/未来 N 天议程（agenda）、周/月视图（calw/calm）、关键字搜索（search）。搜索默认限定未来 6 个月，无结果时提示扩展窗口而非盲目全量扫描。

管理场景：快速创建（quick 自然语言或结构化参数）、编辑、删除事件。所有写操作强制确认：先摘要变更内容（日历、标题、时间、地点、参会人），待用户显式回复 "yes" 后执行。

配置驱动：读取用户预设的 default-calendars 与 ignore-calendars，避免跨日历噪音；仅在用户明确要求或结果异常时才扩大范围。

显著优点

• Token 极省：默认 --nocolor，纯文本输出；仅在需要解析时才用 --tsv
• 零猜测：无结果时不臆断原因，仅陈述搜索范围并提供最小下一步（扩窗/指定日期）
• 防御性设计：写操作二次确认，防止误删误改
• 时间边界清晰：所有搜索默认 180 天窗口，防止无限扫描导致延迟

潜在局限

• 依赖本地配置：若用户未配置 gcalcli 或未授权 OAuth，技能无法自修复
• OAuth 令牌敏感：需本地存储 Google API 凭据，多设备同步时需手动处理
• 自然语言解析力有限：quick 模式依赖 gcalcli 内置 NLP，复杂循环日程可能解析偏差
• 无冲突检测：快速创建不自动提示时间冲突，需用户自行判断

适合人群

• 习惯终端/键盘流的开发者、运维、PM
• 需要快速批量查询或脚本化日历操作的用户
• 对界面冗余信息敏感、追求极速响应效率的场景

常规风险

• OAuth 泄露风险：配置文件含 refresh token，需确保 ~/.gcalcli_oauth 权限 600
• 误操作风险：尽管有确认环节，批量 delete 仍可能因同名事件选错
• 时区歧义：跨时区会议需显式指定时区，否则可能落入默认本地时区

核心用法

gcalcli-calendar 是一个纯 Markdown 文档型 Skill，本身不执行任何代码，仅作为 gcalcli（Google Calendar 官方命令行工具）的交互式使用指南。用户通过自然语言指令，Skill 生成对应的 gcalcli 命令并交由本地终端执行。

典型工作流：

• 快速查看日程：agenda today、agenda today +7d
• 关键词搜索：search "会议" today +180d（默认限定未来 6 个月）
• 创建/修改事件：先生成命令摘要，经用户确认 "yes" 后执行 quick 或 add
• 周/月视图：calw、calm

显著优点

1. 零代码执行风险：T-MD 分类，无 eval/exec/system 调用，无硬编码密钥或混淆代码
2. 令牌效率优先：强制 --nocolor 减少输出噪音；默认范围智能裁剪（6 个月搜索窗、5 天议程窗）
3. 确认机制：所有写入操作（add/edit/delete）需显式确认，防止误操作
4. 配置驱动：尊重用户的 config.toml（default-calendars / ignore-calendars），不越权扫全量
5. 最小权限原则：数据仅流经本地 gcalcli，Skill 本身不接触 OAuth 令牌

潜在局限

• 依赖外部工具：需用户自行安装 gcalcli（pip install gcalcli），并完成 Google OAuth 授权流程
• 无可视化交互：纯文本输出，不支持拖拽、弹窗提醒等 GUI 特性
• 网络行为不可控：实际 API 调用由 gcalcli 完成，Skill 无法干预其重试、缓存策略
• 许可证未声明：当前版本未标注开源协议，长期可审计性略降

适合人群

• 常驻终端的开发者、运维、研究员
• 追求键盘驱动工作流（Vim/Emacs/Tmux 生态）的效率用户
• 对 Google Calendar API 有基础了解、希望批量处理日程的高级用户

常规风险

• gcalcli 供应链风险：若从非官方渠道安装二进制，可能遭遇篡改；建议通过 pip 或 GitHub 官方仓库获取
• OAuth 范围过宽：gcalcli 默认请求完整日历读写权限，用户需在 Google 控制台审查授权范围
• 误操作数据丢失：尽管 Skill 要求确认，但 gcalcli 本身支持 delete 等不可逆操作，终端历史记录可能被恶意脚本复用