apple-productivity

g-shudy 的头像作者 g-shudy

访问macOS Apple生产力应用(日历、联系人、邮件、消息、提醒、语音备忘录)以读取事件、联系人、消息和任务。当用户询问日历、联系人、消息/电子邮件、提醒或语音备忘录转录时使用。

📖 中文导读:访问macOS Apple生产力应用(日历、联系人、邮件、消息、提醒、语音备忘录)以读取事件、联系人、消息和任务。当用户询问日历、联系人、消息/电子邮件、提醒或语音备忘录转录时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: apple-productivity description: Access macOS productivity apps (Calendar, Contacts, Mail, Messages, Reminders, Voice Memos). Use when user asks about calendar events, contacts, emails, iMessages, reminders, or voice transcription. allowed-tools: - Bash - Read - Write - AskUserQuestion

Apple Productivity Apps

Access macOS native productivity apps via helper scripts in ~/bin/.

Quick Start

You want to... Run...
Today's calendar calendar-events
Find a contact contacts-search "name"
Recent messages imessage-recent
Unread mail mail-unread
Overdue reminders reminders-list -o
Transcribe voice memo voice-memos process

All scripts support -j for JSON output.

Detailed References

Security

Read-only (no confirmation needed):

  • Viewing events, contacts, mail, messages, reminders

Write operations (ALWAYS confirm first):

  • calendar-add - creating events
  • Sending messages/emails
  • Modifying reminders

Rule: Use AskUserQuestion before ANY write operation.

Common Patterns

Morning context check

calendar-events && reminders-list -o && imessage-recent -n

Contact lookup with birthday

contacts-search -v "Marie"
imessage-search --pattern "resume"

Error Handling

Error Cause Solution
Mail.app not running mail-unread requires app Tell user to open Mail.app
Query timeout Date range too large Use smaller range
No results Empty dataset Handle gracefully
  • apple-photos - Photo library access
  • apple-shortcuts - Run macOS Shortcuts
  • apple-health-fitness - Health data (under development)