前言¶
在 macOS 上，Apple 备忘录是很多人随手记待办、会议要点和链接的默认入口，数据会经 iCloud 同步到其他 Apple 设备。Agent 对话里一旦涉及「帮我记一条」「查一下备忘录里的某某」，若缺少与系统备忘录应用的桥接，模型只能给出文字建议，无法真正读写 Notes 里的条目。
下面介绍 SkillHub 上的社区 Skill「苹果备忘录」（坐标 @user_c71f1c98/applenotes，当前版本 1.0.0）。它通过 osascript 调用系统能力，覆盖创建、查看、编辑、删除、搜索、移动等操作，且标注 requires_api_key=false，无需额外 API Key。
这是什么¶
「苹果备忘录」是 SkillHub 分类 life-service 下的社区来源（community）Skill，发布者为 user_c71f1c98。官方说明中的定位是：当用户提及「备忘录」「笔记」「notes」，或需要与 Apple Notes 应用交互时使用；数据随 iCloud 在 Apple 设备间同步。仅限 macOS。
官方页面：
- API：
https://api.skillhub.cn/user_c71f1c98/applenotes - SkillHub：
https://www.skillhub.cn/skills/user_c71f1c98/applenotes
核心功能¶
依据 SkillHub 页面与抓取资料，已核实的能力如下：
- 创建备忘录条目。
- 查看已有内容。
- 编辑正文或相关字段（具体字段由 Skill 内
SKILL.md与 osascript 脚本约定）。 - 删除指定笔记。
- 搜索匹配关键词或条件的笔记。
- 移动笔记（例如在不同文件夹/账户结构间调整，以实现为准）。
触发场景写在简介中：用户提到备忘录、笔记、notes，或明确要与 Apple Notes 交互时，Agent 应选用本 Skill。
安装与启用¶
SkillHub 提供两种常见安装方式：用 CLI 装到当前 Agent 的 skills 目录，或把安装提示词交给 AI 按官方文档执行。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（文档地址：https://skillhub.cn/install/skillhub.md）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到 Agent 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则可能装到默认 ./skills/ 而不会被加载。SkillHub 文档中给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
以 Cursor 为例，安装坐标 @user_c71f1c98/applenotes：
skillhub install user_c71f1c98/applenotes --dir ~/.cursor/skills/
（具体子命令格式以本机 skillhub install 帮助为准；SkillHub 页面亦建议通过安装文档安装 @user_c71f1c98/applenotes。）
3、通过对话让 AI 安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c71f1c98/applenotes`。
将上述内容发给已接入 Skill 机制的客户端，由 Agent 按文档完成安装与目录校验。
4、配置说明¶
抓取标签标明 requires_api_key=false，无需在环境变量或配置文件中填写第三方 API Key。macOS 上首次通过脚本控制「备忘录」时，系统可能弹出自动化/隐私权限确认，需在「系统设置」中允许对应终端或 Agent 控制「备忘录」。
典型用法¶
官方资料未附带逐条复制的 shell 示例，用法以自然语言任务 + Skill 内指引为主。下列表述与简介中的触发条件一致，便于在对话中复现：
- 「在备忘录里新建一条，标题是……，内容是……」
- 「搜索备忘录里包含某某关键词的笔记」
- 「把某条笔记移到某某文件夹」
- 「删除标题为……的那条备忘录」
- 「打开/列出最近修改的笔记」（具体能力以 Skill 执行结果为准）
Agent 选中本 Skill 后，会通过 osascript 与「备忘录」应用通信；变更会按 Apple 账户设置经 iCloud 同步。
适用场景与注意¶
适合谁
- 在 macOS 上日常用 Apple 备忘录，并希望 Coding Agent 直接改本地笔记而非另建 Markdown 文件的人。
- 需要在同一 Apple 生态内保持笔记同步（iPhone、iPad 等设备）的场景。
限制与注意
- 仅 macOS：Linux 或 Windows 环境无法使用本 Skill 描述的能力。
- 系统权限：
osascript依赖 macOS 自动化与「备忘录」访问权限；拒绝授权会导致操作失败。 - 社区 Skill：来源为
community，升级与行为变更以 SkillHub 上@user_c71f1c98/applenotes的v1.0.0及后续版本为准。 - SkillHub 页面统计（抓取时）：评分 100000，下载 1001，安装 20；与第三方转载数据可能不一致，以官方页面为准。
结尾¶
「苹果备忘录」把 Apple Notes 的增删改查与搜索、移动收口到一条 life-service Skill 里，适合在对话里用中文或英文触发词直接操作本地备忘录。安装时记住坐标 @user_c71f1c98/applenotes，并按 https://skillhub.cn/install/skillhub.md 把文件落到当前 Agent 的 skills 目录。
官方入口：https://www.skillhub.cn/skills/user_c71f1c98/applenotes
