Communitygithub.com

提醒我

建立並調整 macOS 提醒事項(快速提醒)與私人行事曆事件(時間區塊)。可附加使用者提供的檔案至行事曆事件,如同 Calendar.app 的運作方式。預設排程為明天起第一個空閒日,除非使用者指定確切時間。絕不分享行事曆或邀請他人。

提醒我 是什麼?

這項技能讓 AI 代理(例如 Claude Code、Cursor 或 Codex)能透過命令列腳本,在使用者的 Mac 上建立、重新排程 macOS 提醒事項(Reminders)與私人行事曆事件(Calendar events)。它特別適合用於自然語言提示,例如「提醒我」、「排程這個」或「封鎖時間」。技能會先要求使用者授予權限,然後使用 osascript 與 JXA 透過 AppleScript 或 EventKit 與 macOS 的原生應用程式互動。 該技能包含嚴格規則,確保永不分行事曆:不會建立與會者、邀請或分享。此技能支援的主要平台是 macOS(Apple 生態系),因為它依賴 Reminders.app 與 Calendar.app。多個硬編碼規則(重複四次)強調了隱私層面,防止任何不當的分享行為。內部代理使用 Node.js 輔助腳本(scripts/*.mjs)來決定下一次空閒時間、尋找正確的清單或行事曆、移動提醒事項以及附加檔案。`attach.mjs` 腳本甚至會產生一個 Swift 片段來透過 EventKit 附加檔案,因為 AppleScript 直接無法處理附件。這項技能對於需要將任務、想法或編碼工作階段轉化為可操作提醒事項或行事曆事件,同時保持日期與時間動態計算的開發者助手來說至關重要。

相容平台~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 中分享。

回覆 是(或明確的相同意思)以繼續。

只有在使用者確認後,才能繼續執行以下步驟。如果他們拒絕或不確定,請停止。

在建立任何東西之前

  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 可能會產生 swift 來使用 EventKit — Calendar 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

將 LIST_FROM_WHERE_SCRIPT、YYYY / M / D / H / MIN、TITLE、NOTES 替換為來自位置腳本 + 下一個空閒時間(或使用者提供的確切時間)。

硬性規則 — 絕不分享 (3/4)

絕不透過此技能分享行事曆。 如果使用者說「邀請 X」、「加入 Nico」、「設為公開」、「分享此行事曆」或「發送給團隊」:拒絕,解釋分享必須在 Calendar.app 中手動進行,並且僅提供私人事件放在他們的個人行事曆上(或改為提醒事項)。

行事曆事件(需要時間)— 永遠私人

此技能建立的每個事件都是私人且無法從此處分享。使用者必須自行在 Calendar.app 中進行任何分享。

僅在 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、共享行事曆目標、郵件、「新增人員」,以及超出一般私人個人事件的公開/忙碌發佈。

如果實用,可將優先順序放在 description 文字中 — 請勿使用分享功能來標示優先順序。

使用者提供的確切時間 → 用於 start/end;仍然保持私人(不加入與會者)。仍然執行 where.mjs 以取得行事曆名稱。

附件(Calendar.app,非 URL)

當使用者丟入螢幕截圖/檔案或說「新增此圖片 / 附加此內容」時:

  1. 如果路徑是聊天暫存資產(例如 ~/Pictures/Reminders/…),請儲存一份可保存的副本。
  2. 先建立或找到事件。
  3. 使用 EventKit 附加(這就是 Calendar 在事件圖釘下顯示的內容):
node scripts/attach.mjs --match "TITLE_SUBSTRING" --file /absolute/path.png [--start YYYY-MM-DD]

請不要將 url 屬性或說明中的路徑作為替代。Calendar scripting 無法附加附件;必須使用 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.

相關技能