核心用法
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仍可能因同名事件选错 - 时区歧义：跨时区会议需显式指定时区，否则可能落入默认本地时区