SuperAPI AI 工具集

macos-calendar

办公与效率

查看项目

更新于 10-15 17:26

技能介绍

用途:该技能用于通过脚本管理 macOS Apple 日历事件,适合用户要求添加提醒、安排日程、创建日历条目或设置重复事件时使用。

主要能力:通过 $SKILL_DIR/scripts/calendar.sh 操作日历,支持 list-calendars 列出日历,create-event 创建事件。创建事件时以 JSON 通过 stdin 传入字段:summary(标题,必填)、calendar(日历名)、description(备注)、offset_days(相对今天的天数)、iso_date(绝对日期 YYYY-MM-DD,优先于 offset_days)、hour、minute、duration_minutes、alarm_minutes、all_day、recurrence(iCal RRULE 字符串)。日期处理使用相对运算(当前日期 + N 天),避免法语、英语、德语等地区格式问题。

使用方式:先运行 "$SKILL_DIR/scripts/calendar.sh" list-calendars 确认日历名,再以 echo '<json>' | "$SKILL_DIR/scripts/calendar.sh" create-event 创建事件。自然语言映射示例:明天下午 2 点对应 offset_days:1, hour:14;每周工作日 9 点对应 recurrence:"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"。计算“下周一”等可用日期命令求偏移。

限制:必须先列出日历;标记为只读的日历不能创建事件,脚本会报错拒绝;多个个人日历时需与用户确认日历名;JSON 只能通过 stdin 传入,不能作为命令行参数;重复事件需参考 references/recurrence.md;所有字段由脚本校验,非法输入会被拒绝;所有操作记录在 logs/calendar.log。