Calendar Manager

核心用法

Calendar Manager 是面向 AI 助手的日历管理技能，通过封装主流日历服务的 CLI 工具（gog/icalBuddy），实现自然语言驱动的日程操作。核心能力包括：

1. 智能查询：支持模糊时间表达（"今天/明天/本周"）快速检索事件
2. 事件管理：创建、修改、删除日程，自动解析时间描述（如 "tomorrow 3pm"）
3. 提醒体系：四级提醒机制（15分钟/1小时/1天/1周），适配不同场景
4. 空闲查找：基于现有日程智能推荐可用时间段

显著优点

• 跨平台兼容：覆盖 Google Calendar、Apple Calendar、Outlook 三大主流生态
• 零配置接入：依赖成熟 CLI 工具，无需复杂 OAuth 二次开发
• 工作流整合：可与 email-reader 联动，实现邮件邀请→自动建单→发送提醒的闭环

潜在局限

• 依赖外部 CLI：需预装 gog/icalBuddy 等工具，首次配置存在门槛
• 权限边界模糊：文档未明确说明日历数据的读写权限范围
• 隐私风险：AI 代理直接访问用户完整日程，敏感信息暴露面大
• 同步延迟：CLI 方案可能存在分钟级同步延迟，不适合实时协作场景

适合人群

• 重度依赖日历进行时间管理的个人用户
• 需要 AI 辅助处理日常行政事务的职场人士
• 已建立邮件+日历工作流的效率工具使用者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据隐私 | 日程内容可能包含敏感商业/个人信息 |

| 误操作 | AI 解析时间描述错误导致事件创建错误 |

| 权限滥用 | 若未限定范围，可能读取非必要历史数据 |

| 第三方依赖 | CLI 工具更新中断或 API 变更影响功能 |

核心用法

Calendar Manager 是一个纯文档型技能，本身不含可执行代码，而是通过调用本地安装的第三方 CLI 工具（如 gog、icalBuddy、gcalcli）来实现日历管理功能。主要能力包括：

• 日程查询：查看今天/明天/本周的日历事件
• 事件管理：创建、修改、删除日历条目
• 提醒设置：支持 15 分钟到 1 周前多级提醒
• 空闲查找：识别可用时间段

显著优点

| 优势 | 说明 |

|------|------|

| **零代码风险** | 纯 Markdown 文档，无 eval/exec/system 等危险函数 |

| **工具解耦** | 不绑定特定日历服务，支持 Google/Apple/Outlook 多种生态 |

| **隐私友好** | 数据在本地 CLI 工具处理，AI 不直接访问云端 API |

| **触发场景清晰** | 明确覆盖 5 类高频日历查询需求 |

潜在缺点与局限性

1. 依赖外部工具：需用户自行安装 gog/icalBuddy/gcalcli，零配置开箱即用不可行
2. 功能受限：仅能执行工具支持的命令，复杂日历操作（如循环事件精细编辑）可能受限
3. 平台差异：不同 CLI 工具语法不统一，跨平台迁移成本存在
4. 无实时同步：依赖本地工具缓存状态，非即时云同步体验

适合人群

• 技术型用户：习惯命令行操作，愿意配置 CLI 工具
• 隐私敏感者：偏好数据本地处理，不愿授权云端 API
• 多平台用户：需要同时管理 Google/Apple/Outlook 日历
• 效率工具整合者：希望将日历查询融入 AI 工作流

常规风险

| 风险点 | 等级 | 说明 |

|--------|------|------|

| 外部工具安全性 | 低 | 依赖 gog/icalBuddy 等社区工具，需用户自行评估 |

| 输入注入 | 极低 | 日期时间参数若直接拼接需警惕，但 Skill 本身无执行逻辑 |

| 凭证管理 | 低 | OAuth 配置由外部 CLI 工具处理，本 Skill 不接触密钥 |

| 功能失效 | 中 | 外部 CLI 工具更新可能导致命令语法过时 |

使用建议

建议搭配邮件技能（email-reader）实现"邮件邀请→自动建日程→会议提醒"的完整工作流，但需确认本地 CLI 工具已正确配置并授权。