苹果提醒事项CLI技能：把 macOS 提醒事项搬进终端，一条命令管好所有待办
- 核心定位：把 Apple 提醒事项的全部日常操作（查看、新增、编辑、完成、删除）变成终端里的
remindctl命令，人和 AI 都能直接调用。 - 安装方式：macOS 环境下通过 Homebrew 安装
brew install steipete/tap/remindctl，首次使用需授权提醒事项访问权限。 - 关键能力：内置今天、明天、本周、过期、即将到来、已完成、全部以及指定日期等多种视图，支持按列表过滤。
- 脚本友好：提供
--json、--plain（TSV）、--quiet三种输出模式，可直接被脚本、流水线或 AI Agent 消费。 - 使用边界：仅限 macOS（darwin），依赖
remindctl二进制文件，权限未授予时会在读取数据阶段失败。
1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？
这个技能的中文名是苹果提醒事项CLI技能，英文名是 apple-reminders，技能 ID 为 13605。
它解决的问题非常具体：Apple 提醒事项是 macOS 用户最常用的待办工具，但它只提供图形界面和 Siri 两种入口。当你想在终端里快速看一眼「今天还有什么没做」，或者想让 AI Agent 帮你批量整理待办、按日期汇总进度时，图形界面就成了障碍——你必须切换窗口、点开应用、手动翻阅列表。这个技能通过 remindctl 这个命令行工具，把提醒事项的数据和操作开放给了终端与脚本。
「一键安装」的思路是：先用包管理器把 CLI 装好，再让 AI 技能调用它。具体步骤如下：
安装前提
- 操作系统必须是 macOS（技能元数据中声明
os: ["darwin"]）； - 需要具备 Homebrew 包管理环境；
- 技能依赖的可执行文件为
remindctl，未安装时技能无法工作。
安装步骤
-
通过 Homebrew 安装（技能内置的标准安装方式）：
brew install steipete/tap/remindctl -
如果你希望从源码构建，技能文档给出的方式是执行
pnpm install && pnpm build，构建产物位于./bin/remindctl。 -
首次使用需授予权限。先检查当前授权状态：
remindctl status若尚未授权，执行：
remindctl authorize按提示允许访问。如果系统层面被拒绝，需要前往「系统设置 → 隐私与安全 → 提醒事项」中为 Terminal 或 remindctl 打开开关。
验证是否生效
安装并授权后，直接执行不带参数的 remindctl，它会默认返回「今天」的提醒事项。如果能正常列出内容，说明技能链路已经打通；如果提示权限错误，回到上一步检查系统设置。至于技能的具体安装入口、版本号与更新方式，不同客户端可能存在差异，以官方说明为准。
2. 该技能的主要功能和特点
- 时间视图开箱即用：
remindctl（默认今天）、today、tomorrow、week、overdue、upcoming、completed、all覆盖了绝大多数「我接下来要做什么」的查询诉求，还支持直接传日期（如remindctl 2026-01-04）查看某一天的安排。 - 列表级管理：
remindctl list列出全部列表，remindctl list Work查看指定列表内容，--create、--rename、--delete分别用于新建、重命名和删除列表，相当于把提醒事项的「文件夹」也纳入了命令行。 - 增删改查完整闭环：
add "购买牛奶"快速添加，add --title "给妈妈打电话" --list Personal --due tomorrow指定列表与到期日；edit 1 --title "新标题" --due 2026-01-04修改；complete 1 2 3批量完成；delete 4A83 --force按 ID 强制删除。 - 三种输出模式适配不同消费方：
--json输出结构化数据供脚本或 AI 解析，--plain输出 TSV 纯文本便于awk、cut等工具处理，--quiet只返回计数，适合做看板或状态栏提示。 - 日期表达灵活：
--due与日期过滤器同时接受today、tomorrow、yesterday这类自然语言，也接受YYYY-MM-DD、YYYY-MM-DD HH:mm以及 ISO 8601（如2026-01-04T12:34:56Z）。 - 和普通工具比强在哪：图形界面应用只能「人看」，而
remindctl让提醒事项成为可组合的数据源——一条命令的输出可以直接进入管道、进入脚本、进入 AI 的上下文，这是鼠标点击无法做到的。
3. 如何使用该技能？
下面按典型使用顺序给出操作指南，命令均来自技能文档。
第 1 步：确认权限状态
remindctl status
若提示未授权，执行 remindctl authorize 并在弹窗中同意；仍失败则去系统设置里手动开启提醒事项权限。
第 2 步：先看看有哪些列表
remindctl list
输出会列出你现有的列表名称（例如 Work、Personal）。想专注某个列表时，执行 remindctl list Work。
第 3 步：查看待办
- 看今天：
remindctl today或不带参数的remindctl - 看本周：
remindctl week - 看已逾期的：
remindctl overdue - 看某个具体日期：
remindctl 2026-01-04
第 4 步：新增提醒事项
快速添加：
remindctl add "购买牛奶"
带列表与到期日：
remindctl add --title "给妈妈打电话" --list Personal --due tomorrow
第 5 步：编辑、完成与删除
- 修改标题和到期日：
remindctl edit 1 --title "新标题" --due 2026-01-04 - 批量完成：
remindctl complete 1 2 3（按 ID 操作，ID 可通过列表查询获得） - 删除：
remindctl delete 4A83 --force
第 6 步：接入脚本或 AI
需要结构化数据时使用 --json：
remindctl today --json
需要喂给纯文本处理工具时使用 --plain，只想拿数量（例如在状态栏显示「今日待办 5 条」）时使用 --quiet。这些输出可以直接作为 AI Agent 的输入上下文，让模型基于真实待办做归纳、排序或提醒。至于具体在哪个客户端里触发该技能，以官方说明为准。
输入输出示例说明：以 remindctl add --title "给妈妈打电话" --list Personal --due tomorrow 为例，输入是有明确标题、归属列表和相对日期的一条意图，工具会在 Personal 列表下创建一条明天到期的提醒事项，并在终端返回执行结果；随后用 remindctl tomorrow 即可看到这条新记录。
4. 同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 苹果提醒事项CLI技能（remindctl） | macOS 提醒事项的命令行接口 | 多视图查询、列表增删改、提醒增删改、JSON/TSV/计数输出 | 需 macOS + Homebrew 安装 remindctl，首次需授权提醒事项权限 |
终端重度用户、自动化脚本、AI Agent 读取待办 | 优势：与系统提醒事项数据同源、输出可被脚本消费、支持批量完成；不足：仅限 macOS，需处理权限问题 |
| Apple 提醒事项官方 App / Siri | 系统原生图形界面与语音入口 | 手动创建、分类列表、到期提醒、iCloud 同步 | 系统自带，零安装 | 普通用户日常记录待办 | 优势：门槛最低、体验完整；不足：无法脚本化，批量操作与结构化导出能力弱 |
| AppleScript + osascript 自写脚本 | 用系统脚本桥接操作提醒事项 | 理论上可读写提醒数据 | 需自行编写与维护脚本，调试成本高 | 有脚本经验的 macOS 高级用户 | 优势：可高度定制；不足：需要自行处理数据结构与错误，维护成本随需求增长 |
| 跨平台终端待办工具（如 todo.txt 类、Taskwarrior 类） | 纯文本/本地数据库的终端任务管理 | 任务增删改查、标签、优先级、报表 | 需额外安装并学习其命令语法 | 跨平台开发者、喜欢纯文本工作流的人 | 优势：跨平台、可版本管理；不足：与系统提醒事项数据不互通，无法复用 iCloud 与 Siri 生态 |
5. 该技能的典型应用场景与实际体验情况
场景一：开发者的每日开工检查
角色是每天要在终端里待八小时的工程师，痛点是「打开提醒事项 App 看一眼今天要做什么」这件事本身就要切换上下文。使用方式是打开终端先跑一句 remindctl today，或者用 remindctl week 规划整周；关注逾期任务时执行 remindctl overdue。实际体验上，这属于几乎零学习成本的操作——命令语义和自然语言高度一致，看一眼帮助就能上手。
场景二：AI Agent 读取真实待办并给出建议
痛点是让 AI 帮忙规划日程时，模型不知道你真实有哪些任务，只能靠你口述。使用方式是让 Agent 先调用 remindctl today --json 拿到结构化待办，再据此做优先级排序、拆解子任务，甚至用 remindctl add --title "..." --list Work --due 2026-01-04 把拆解结果写回提醒事项。实际体验的关键在于 --json 这一步：结构化输出让模型不必猜测格式，也减少了幻觉。注意事项是任务标题等文本仍需人工复核，避免误建。
场景三：批量清理与周度回顾
痛点是历史遗留的已完成/过期条目全靠手点清理，几十条就要点很久。使用方式是先用 remindctl list Work 定位列表，再用 remindctl complete 1 2 3 批量标记完成，或用 remindctl delete 4A83 --force 批量删除。实际体验上，批量能力是这个技能相对图形界面最直观的效率提升点，但 --force 属于不可逆操作，建议先看清楚 ID 再执行。
场景四：状态栏/日报中的待办计数
痛点是想在脚本输出的日报里带一句「今日待办 5 条」，手动统计很麻烦。使用方式是 remindctl today --quiet 只取计数，再嵌入自己的脚本或提示信息。实际体验是这类「小数据」需求恰恰是 CLI 的强项。
整体上手难度与注意事项：技能本身命令体系直观，上手难度低；主要摩擦点集中在环境层面——仅支持 macOS，首次使用必须完成提醒事项授权；如果通过 SSH 远程运行，需要在真正执行命令的那台 Mac 上授予访问权限，否则会出现「命令存在但读不到数据」的情况。
6. 该技能能为用户带来的价值
第一层是操作效率的收敛。原本需要在图形界面中「打开应用 → 找到列表 → 滚动查找」的流程，被压缩成一条命令。以查询今天待办为例，从多次点击变成一次回车，每日高频重复的动作收益会被放大。
第二层是自动化的可能性被打开。--json、--plain、--quiet 三种输出模式，意味着提醒事项不再只是一个消费级 App，而是一个可以被脚本、被流水线、被 AI 调用的数据源。用户可以把「读待办」这一步嵌入自己的日报脚本、状态栏插件或 Agent 工作流中，这是图形界面无法提供的长期价值。
第三层是降低了 AI 与个人任务系统的对接门槛。AI 助手要真正帮上忙，前提是能拿到你的真实上下文。通过这个技能，模型可以用极低的成本获取结构化待办、写入新任务、批量完成事项，从而把「AI 帮我规划日程」从口头描述变成数据驱动。
第四层是心智负担的下降。不必再为「我是不是漏了什么」而反复打开 App 检查，一句 remindctl upcoming 或 remindctl overdue 就能给出确定答案。对于同时维护多个列表的用户，remindctl list 加列表过滤的组合能显著减少翻阅成本。
需要提醒的是，该技能的能力边界由 remindctl 决定，它管理的是系统提醒事项中的数据，不涉及跨平台同步逻辑，也不替代 App 的提醒推送能力。
7. 常见问题 FAQ
Q1：这个技能怎么安装？一定要用 Homebrew 吗？
技能文档给出的标准方式是通过 Homebrew 安装：brew install steipete/tap/remindctl。如果你更希望从源码构建，文档也提供了 pnpm install && pnpm build 的方式，产物在 ./bin/remindctl。安装完成后务必执行 remindctl status 检查授权状态，未授权时先运行 remindctl authorize。在其他客户端中的技能安装入口与具体步骤，以官方说明为准。
Q2：这个技能收费吗？
技能本身描述的是一个开源命令行工具的使用方式，技能详情中未包含任何价格或付费信息。工具的使用成本主要取决于你是否已具备 macOS 与 Homebrew 环境。与商业待办应用相关的费用问题，以官方说明为准。
Q3：为什么我装好了却读不到提醒事项？
最常见的原因是权限未授予。请依次尝试：执行 remindctl status 查看状态；执行 remindctl authorize 发起授权；若仍失败，前往「系统设置 → 隐私与安全 → 提醒事项」为 Terminal 或 remindctl 开启权限。如果你是通过 SSH 在远程 Mac 上运行命令，需要在执行命令的那台 Mac 上完成授权，而不是在你本地终端上授权。
Q4：这个技能适合谁用？
适合三类人：一是长期在终端里工作的 macOS 开发者与运维人员；二是希望把待办接入脚本、状态栏或自动化流程的效率工具爱好者；三是想让 AI Agent 读取并操作真实待办数据的用户。如果你完全不使用 macOS，或者几乎不碰命令行，那么系统自带的提醒事项 App 就足够了。
Q5：和自写 AppleScript 或跨平台待办工具相比怎么选？
如果你要的是「和系统提醒事项数据同源、开箱即用、输出可脚本消费」，选这个技能最省事，不必自己维护脚本逻辑。如果你有强烈的跨平台需求、希望待办数据能被版本管理，跨平台终端待办工具更合适，代价是与 iCloud/提醒事项生态割裂。如果你只需要高度定制的特殊操作，自写 AppleScript 灵活性最高，但维护成本也最高。