用途:在 macOS 上用命令行管理 Apple Calendar 与提醒事项,并按 GTD 方法论区分安排。Calendar 用于有固定时间的承诺(会议、约会、截止日期);Reminders 用于无固定时间的待办(清单、任务、想法)。
主要能力:按用户意图切换模式——安排会议/创建事件走 Calendar;添加待办/记一下走 Reminders;查看日程则同时查询两者;规划下周/周回顾走综合工作流。Calendar 事件通过 osascript 查看、创建、删除;提醒事项推荐用 reminders-cli(osascript 访问 Reminders 较慢,官方资料将其列为备选)。常见工作流包括快速收集、安排会议、每日规划、GTD 周回顾,以及依赖 Schedule YAML 的跨项目周规划。
前置条件:需 macOS、内置 osascript,以及 reminders-cli;安装命令:brew install keith/formulae/reminders-cli。可选数据为 ~/code//planning/schedules/.yaml,用于跨项目周规划;不存在时退化为标准周回顾流程。
权限配置:首次运行需在系统设置 → 隐私与安全性中为终端应用勾选日历与提醒事项权限,修改权限后需重启终端应用。
常用命令:reminders show-lists 查看列表;reminders show-all --due-date today 查看今日待办;reminders add "列表" "任务" 创建;reminders complete "列表" 0 完成。
限制与常见错误:权限未授予会报 AppleEvent timed out;列表不存在会报 Can't get list,需先查看可用列表;日期格式错误会报 Invalid date,建议以 current date 为基准;未安装 reminders-cli 会报 command not found。该技能仅支持 macOS,且不应在加载时主动验证工具,命令因缺少工具失败时再逐步引导安装与配置。