Apple Reminders

Harness-agent 工具

概念	工具
Shell / brew / remindctl	execute
记忆（仅代理笔记，无手机同步）	memory_store, memory_recall

内置技能路径：/_builtin_skills/apple-reminders/。

使用 remindctl 从终端管理 Apple Reminders。任务通过 iCloud 在所有 Apple 设备间同步。

引导（首次使用前运行）

在调用 remindctl 之前，不要调用，直到此检查清单通过。使用 execute 自行安装缺少的依赖——除非安装失败或缺少 Homebrew，否则不要要求用户运行 brew。

1. 确认 macOS

uname -s

期望 Darwin。在 Linux/Windows 上，停止并告诉用户此技能仅限 macOS。

2. 检查/安装 remindctl

command -v remindctl && remindctl --version

如果缺少：

command -v brew
brew install steipete/tap/remindctl
remindctl --version

如果未安装 brew，说明需要 Homebrew 并指向 https://brew.sh——不要猜测其他安装路径。

3. 检查/请求 Reminders 权限

remindctl status

如果输出指示缺少授权：

remindctl authorize

然后告诉用户在系统提示或系统设置 → 隐私与安全 → Reminders 中批准 Reminders 访问。不要在紧密循环中重试——等待用户确认他们已批准。

4. 冒烟测试

remindctl list

如果成功，继续用户的任务。

何时使用

• 用户提到"提醒"或"Reminders app"
• 创建同步到 iOS 的带截止日期的个人待办事项
• 管理 Apple Reminders 列表
• 用户希望任务出现在他们的 iPhone/iPad 上

何时不使用

• 仅代理的"稍后提醒我" 无手机同步 → memory_store 或要求用户设置 OS cron/外部调度器
• 日历事件 → Apple Calendar 或 Google Calendar
• 项目任务管理 → GitHub Issues、Notion 等
• 如果用户说"提醒我"但意思是聊天内提示 → 先澄清

快速参考

查看提醒

remindctl                    # 今天的提醒
remindctl today              # 今天
remindctl tomorrow           # 明天
remindctl week               # 本周
remindctl overdue            # 过期
remindctl all                # 所有
remindctl 2026-01-04         # 特定日期

管理列表

remindctl list               # 列出所有列表
remindctl list Work          # 显示特定列表
remindctl list Projects --create    # 创建列表
remindctl list Work --delete        # 删除列表

创建提醒

在 add 之前始终与用户确认标题和截止日期。

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

截止时间 vs 闹钟/提前提示

--due 和 --alarm 是不同的字段：

• --due 设置提醒的截止日期/时间。
• --alarm 设置 EventKit 闹钟/通知触发器。当用户要求更早的提示时，显式传递 --alarm。

示例——截止下午 2:00，提前 30 分钟通知：

remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

编辑现有提醒：

remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

使用 JSON 验证（UI 可能按闹钟时间分组）：

remindctl today --json

预期字段：dueDate（截止时间）、alarmDate（通知时间）。

完成/删除

remindctl complete 1 2 3          # 按 ID 完成
remindctl delete 4A83 --force     # 按 ID 删除

输出格式

remindctl today --json       # 用于脚本的 JSON
remindctl today --plain      # TSV 格式
remindctl today --quiet      # 仅计数

编程解析输出时优先使用 --json。

日期格式

被 --due 和日期过滤器接受：

• today, tomorrow, yesterday
• YYYY-MM-DD
• YYYY-MM-DD HH:mm
• ISO 8601 (2026-01-04T12:34:56Z)

规则

1. "提醒我"——澄清：Apple Reminders（同步到手机）vs memory_store/外部调度
2. 在创建之前始终确认提醒内容和截止日期
3. 当 remindctl 失败或会话中首次使用时，运行引导部分
4. 编程解析时使用 --json