apple-productivity
访问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
- Calendar: reference/calendar.md
- Contacts: reference/contacts.md
- Mail: reference/mail.md
- Messages: reference/messages.md
- Reminders: reference/reminders.md
- Voice Memos: reference/voice-memos.md
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"
Historical message search
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 |
Related Skills
apple-photos- Photo library accessapple-shortcuts- Run macOS Shortcutsapple-health-fitness- Health data (under development)