极速极简的日历管家

基于成熟开源工具 gcalcli 的 Google Calendar 管理技能，支持快速查看、创建、删除日程，优化工具调用效率，适合个人助理场景。

基本信息

• 技能名称?gcalcli-calendar
• 中文名称?极速极简的日历管家
• 作者?lstpsche
• 分类?办公
• 版本?v3.0.0
• 标签?productivity, office, api, automation

使用方法

使用说明
核心用法
gcalcli-calendar 是一个专为个人助理场景设计的 Google Calendar 管理技能，通过封装 gcalcli CLI 工具实现低摩擦的日历操作。核心功能包括：
议程查看 ：默认显示今日日程，支持按需扩展至 14 天或 30 天窗口
事件搜索 ：语义优先的确定性扫描，优先使用 agenda 而非 search 以节省 token
快速创建 ：支持一次性事件（add）和重复事件（import via stdin），自动跨日历检测时间冲突
安全删除 ：单事件明确匹配时自动执行，多匹配时询问确认，删除后强制验证
显著优点

1. 工具效率优化 ：默认使用 --nocolor 减少格式噪声，避免不必要的 token 消耗；优先使用 agenda 扫描而非 search，降低 API 调用成本
2. UX 设计合理 ：单事件匹配时跳过确认对话框，实现对话式快速操作；多匹配时主动列出候选项供用户选择
3. 安全机制完善 ：创建事件前强制跨日历冲突检查；删除后通过 agenda 验证确保操作生效，失败时支持 --refresh 重试
4. 无文件系统依赖 ：ICS 内容通过 stdin 管道传输，避免临时文件写入，适应沙盒执行环境
   潜在缺点与局限性
5. 编辑功能受限 ：gcalcli 的 edit 子命令为交互式，无法在非交互环境中使用；修改事件需采用"删除+重建"模式，可能丢失部分元数据
6. 依赖外部工具 ：功能完整性和安全性部分取决于 gcalcli 的实现，需用户预先完成 OAuth 配置
7. 自动删除风险 ：单事件明确匹配时自动执行删除，虽为设计意图，但在敏感日历上可能存在误操作风险
8. 时间窗口限制 ：默认搜索限制在 180 天内，超长期事件需显式扩展范围
   适合的目标群体
   需要快速管理个人日程的终端用户
   追求低交互、高效率日历操作的 AI 助理场景
   已使用 gcalcli 并熟悉其配置流程的技术用户
   对 Google Calendar 有重度依赖但希望减少手动操作的知识工作者
   使用风险
   性能依赖 ：gcalcli 的响应速度直接影响用户体验，网络波动或 Google API 限流可能导致延迟
   版本兼容性 ：gcalcli 的 flag 行为可能随版本变化，需保持 skill 与 CLI 工具版本同步
   OAuth 配置门槛 ：首次使用需完成 Google OAuth 流程，对非技术用户存在学习成本
   沙盒环境限制 ：依赖外部二进制文件，部分执行环境可能无法直接调用 gcalcli