Communitygithub.com

提醒与日历事件管理

创建和重新安排macOS提醒(快速备忘)和私人日历事件(时间块)。可将用户提供的文件附加到日历事件上,如同Calendar.app所做。默认计划:明天开始的第一个空闲日,除非用户指定确切时间。永不共享日历或邀请他人。

提醒与日历事件管理 是什么?

该技能使AI代理能够管理macOS的“提醒”和“日历”应用。它提供两个主要入口:快速备忘(提醒)和需要时间分配的任务(日历事件)。技能自动解析用户意图(如“提醒我”、“安排这个”、“阻止时间”),并根据用户提供的时间或通过扫描日历找到下一个空闲时段来创建事件。它使用Node.js脚本与系统API交互,进行权限检查,并严格遵守“永不共享”规则——禁止添加参与者或发送邀请。支持将文件附加到日历事件,确保事件保持私有。平台支持:macOS上的Claude Code、Cursor或Codex。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/remind-me

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

提醒我

两个入口点:

意图操作
快速备忘 / 别忘了提醒
需要时间(任务、想法、编程会话、与自己的会议)日历事件
重新安排现有提醒移动提醒

权限确认(必需第一步)

在改写标题、运行任何脚本、打开日历或调用 osascript / JXA 之前:通知用户并等待明确的确认。不要在静默或默示同意下继续。

大致告知以下内容:

这将通过自动化使用您的 Mac 的 提醒 和/或 日历。macOS 可能会提示为 终端 和/或 Cursor(运行命令的任意一个)授予权限:

  • 提醒 — 读取列表;创建并 移动/重新安排 提醒
  • 日历 — 读取事件(以查找空闲时段);创建私人事件;完全访问 需要附加文件
  • 自动化 — 从代理的 shell 控制提醒和日历(osascript / JXA / EventKit)

此技能不会共享或邀请任何人。除非您在 Calendar.app 中自行分享,否则事件保持私有。

回复 yes(或明确的等效词)以继续。

只有在用户确认后,才继续执行以下步骤。如果用户拒绝或不确定,则停止。

创建任何内容之前

  1. 改写标题以适合锁屏阅读。强调清晰度、情感(当涉及人类真实利益时)、逻辑(“完成”的样子)和意义。简短标题;额外上下文放在备注/描述中。

  2. 时间 — 如果用户提供了确切日期时间,则使用它。否则运行:

    node scripts/next-free.mjs [--duration 30|60|90] [--calendar Personal]
    

    使用 JSON day / localStart / localEnd。编程会话 → 偏好 --duration 60 或 90。

  3. 位置 — 运行位置脚本(不要自行硬编码列表/日历默认值):

    node scripts/where.mjs reminder --text "USER_UTTERANCE"
    node scripts/where.mjs calendar --text "USER_UTTERANCE" [--suggested Name]
    
    • 提醒 JSON list — 包括默认的 Reminders(当没有匹配时) — 来自脚本。
    • 日历 JSON action: "use" → 使用 calendar。
    • 日历 JSON action: "ask_confirm_or_new" → 要求用户确认或提供新日历的名称,然后根据他们的回答继续(仍然私有 / 永不共享)。
  4. 使用 osascript 创建(如下)。如果用户提供了图像或文件,接下来附加它(不要停在 URL 或备注路径上)。确认:目标、最终标题、时间、附件。提醒他们事件是 私有的 / 不共享。

移动提醒

当用户要求移动/重新安排/将提醒推迟到新的时间(确切时间优先;否则使用 next-free.mjs 获取到期时刻):

node scripts/move-reminder.mjs --match "TITLE_SUBSTRING" --due tomorrow-10:30 [--list Reminders]
# 或
node scripts/move-reminder.mjs --match "TITLE_SUBSTRING" --due 2026-08-12T10:30
# 或(较慢)
node scripts/move-reminder.mjs --id "x-apple-reminder://…" --due tomorrow-10:30

优先使用 --match + --list 而非 --id。向用户确认新的到期时间。不要创建重复项——更新现有提醒的到期日期。

脚本位于 scripts/*.mjs(where.mjs、next-free.mjs、move-reminder.mjs、attach.mjs)。attach.mjs 可能会为 EventKit 启动 swift——日历 AppleScript 无法添加附件。

<<<

硬规则——永不共享(1/4)

永远不要通过此技能共享日历。 不要邀请参与者,不要发送邀请,不要切换日历共享,不要向事件添加人员。如果用户希望其他人看到,他们自己在 Calendar.app 中共享。你在此拒绝共享请求。

硬规则——永不共享(2/4)

永远不要通过此技能共享日历。 创建事件不得通知、邀请或将事件暴露给其他人。没有 attendee 属性。没有邮件。没有“共享日历”流程。用户如果需要,在 Calendar.app 中共享——而不是你。

提醒(快速)

仅使用 组件 构建日期(无区域设置日期字符串)。

osascript <<'APPLESCRIPT'
tell application "Reminders"
  tell list "LIST_FROM_WHERE_SCRIPT"
    set d to current date
    set time of d to 0
    set day of d to 1
    set year of d to YYYY
    set month of d to M
    set day of d to D
    set hours of d to H
    set minutes of d to MIN
    set seconds of d to 0
    make new reminder with properties {name:"TITLE", body:"NOTES", due date:d}
  end tell
end tell
APPLESCRIPT

用 where 脚本 + next-free(或用户精确时间)的结果替换 LIST_FROM_WHERE_SCRIPT、YYYY / M / D / H / MIN、TITLE、NOTES。

硬规则——永不共享(3/4)

永远不要通过此技能共享日历。 如果用户说“邀请 X”、“添加 Nico”、“使其公开”、“共享此日历”或“发送给团队”:拒绝,解释共享在 Calendar.app 中是手动的,并且仅提供 私有 事件在其个人日历上(或改为提醒)。

日历事件(需要时间)——始终私有

此技能创建的每个事件都是 私有的,不可从此处共享。用户必须自行在 Calendar 中完成任何共享。

在 action: "use" 或用户回答了 ask_confirm_or_new 之后,才使用 where.mjs 中的日历名称。

open -a Calendar
osascript <<'APPLESCRIPT'
tell application "Calendar"
  tell calendar "CALENDAR_FROM_WHERE_OR_USER"
    set startDate to current date
    set time of startDate to 0
    set day of startDate to 1
    set year of startDate to YYYY
    set month of startDate to M
    set day of startDate to D
    set hours of startDate to H
    set minutes of startDate to MIN
    set seconds of startDate to 0
    set endDate to startDate + (30 * minutes)
    -- 仅私有:摘要/描述/日期。无参与者。无邀请。无共享。
    make new event with properties {summary:"TITLE", start date:startDate, end date:endDate, description:"CONTENT"}
  end tell
end tell
APPLESCRIPT

允许的属性:summary、start/end、description(以及仅当用户为自己请求位置时的 location)。 禁止:attendees、invitees、共享日历目标、邮件、“添加人员”、超出正常私人个人事件的公共/忙碌发布。

如果有用,在描述文本中放入优先级——不要使用共享功能来指示优先级。

来自用户的精确时间 → 用于开始/结束;仍然私有(无参与者)。仍需要运行 where.mjs 获取日历名称。

附件(Calendar.app,非 URL)

当用户拖放截图/文件或说“添加此图像 / 附加此文件”时:

  1. 如果路径是聊天临时资产(例如 ~/Pictures/Reminders/…),保存一个持久副本。
  2. 先创建或找到事件。
  3. 使用 EventKit 附加(这是日历在事件的回形针下显示的内容):
node scripts/attach.mjs --match "TITLE_SUBSTRING" --file /absolute/path.png [--start YYYY-MM-DD]

不要 替换事件的 url 或描述中的路径。日历脚本无法添加附件;attach.mjs 是必需的。如果 JSON skipped: true,则同一文件名已存在于事件上。

硬规则——永不共享(4/4)

永远不要通过此技能共享日历。 已陈述四次,这样你就不会“好心”地邀请、发布或翻转共享。私有事件 → 完成。共享 = 用户在 Calendar.app 中的工作,始终如此。

权限

在 任何 自动化之前需要确认(见上面的 权限确认)。如果之后 osascript / where.mjs / next-free.mjs / move-reminder.mjs / attach.mjs 仍然失败:告诉用户在 系统设置 → 隐私与安全性 → 自动化 以及 日历(完全访问) / 提醒中允许 Terminal/Cursor。

范围外

Google/Outlook API、重复引擎、npm CLI、scripts/*.mjs 助手(加上 attach.mjs 运行的 Swift EventKit 片段)之外的语言,以及 任何日历共享 / 邀请 / 参与者工作流程。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Monitor one GitHub PR for new review feedback, implement only meaningful fixes, and answer reviewers with evidence, friendly wit, and pushback on unrealistic or overly defensive comments. Use when the user asks to babysit, watch, or monitor Codex/reviewer comments on a PR.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices in Penpot.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

相关技能