提醒我 是做什麼的?
兩個進入點:
| 意圖 | 執行這個 |
|---|---|
| 快速提醒 / 別忘了 | 提醒事項 |
| 需要時間(任務、想法、編碼工作階段、與自己開會) | 行事曆事件 |
| 重新排程現有提醒事項 | 移動提醒事項 |
權限確認(必須先執行)
在重新撰寫標題、執行任何腳本、開啟行事曆或呼叫 osascript / JXA 之前:通知使用者並等待明確確認。不要因為沉默或默示同意就繼續執行。
告訴他們大致如下:
這將會透過自動化使用您 Mac 的 提醒事項 和/或 行事曆。macOS 可能會提示您允許 終端機 和/或 Cursor(執行命令的程式)的權限:
- 提醒事項 — 讀取列表;建立和 移動/重新排程 提醒事項
- 行事曆 — 讀取事件(以找尋空檔);建立私人事件;需要 完整權限 才能附加檔案
- 自動化 — 從代理程式的 shell 控制提醒事項和行事曆(
osascript/ JXA / EventKit)此技能不會分享或邀請任何人。事件保持私人狀態,除非您自己在 Calendar.app 中分享。
回覆 是(或明確的相同意思)以繼續。
只有在使用者確認後,才能繼續執行以下步驟。如果他們拒絕或不確定,請停止。
在建立任何東西之前
-
重新撰寫標題以便在鎖定畫面上閱讀。強調清晰度、情感(當涉及真實人情壓力時)、邏輯(「完成」的樣貌)與意義。簡短標題;將額外內容放在備註/說明中。
-
時間 — 如果使用者給了確切的日期時間,請使用它。否則執行:
node scripts/next-free.mjs [--duration 30|60|90] [--calendar Personal]使用 JSON 的
day/localStart/localEnd。編碼工作階段 → 偏好使用--duration 60或90。 -
位置 — 執行位置腳本(不要自己硬編碼列表/行事曆預設值):
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"→ 詢問使用者確認或提供新行事曆的名稱,然後根據他們的回答繼續(仍然保持私人 / 絕不分享)。
- 提醒事項 JSON
-
使用下方
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)
當使用者丟入螢幕截圖/檔案或說「新增此圖片 / 附加此內容」時:
- 如果路徑是聊天暫存資產(例如
~/Pictures/Reminders/…),請儲存一份可保存的副本。 - 先建立或找到事件。
- 使用 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 片段)之外的語言,以及任何行事曆分享 / 邀請 / 與會者工作流程。