calendar-sync: Apple日历同步技能

目的

将doc-structurer中结构化文档数据中包含日期信息的项目自动注册到Apple日历中。将截止日期、合同期限、会议日程、活动日期等各种类型的日期转换为适当的日历事件。

日历事件类型

根据文档类型和日期性质区分事件：

事件映射规则

日期字段	事件类型	通知设置
deadline（截止日期）	全天事件	3天前 + 1天前 + 当天上午9点
event_dates（活动）

时间事件（默认10:00~12:00） | 1天前 + 2小时前 | | startdate ~ enddate（期间） | 多日事件 | 开始3天前 + 开始当天 | | document_date（撰写日期） | 不注册 | - |

按优先级强化通知

优先级	附加通知
高	增加7天前通知
中

保持默认通知 | | 低 | 仅当天通知 |

事件构成

事件字段映射

标题：[文档类型] 文档标题
例：[合同] 劳务合同截止
例：[公文] 事业计划书提交期限

位置：（如有地点信息）

备注：
文档类型：合同
发件：OO机构
负责人：洪吉童
摘要：3行摘要内容
金额：50,000,000韩元

---

Notion链接：https://notion.so/...
原始文件：文件路径

日历：文档日程（自动创建）

URL：Notion页面链接（如有）

日历颜色代码

按文档类型分离日历，或在单一日历内用颜色区分：

文档类型	颜色
公文/政府机关	红色（紧急/正式）
合同

橙色 |
| 提案书 | 蓝色 |
| 报告书 | 绿色 |
| 会议记录 | 紫色 |
| 企划书 | 黄色 |
| 报价单/账单 | 粉色 |
| 其他 | 灰色 |

执行方式

Claude Cowork环境

通过Apple Notes MCP或AppleScript直接访问日历：

AppleScript方式：
applescript
tell application Calendar
-- 如果没有文档日程日历则创建
if not (exists calendar 文档日程) then
make new calendar with properties {name:文档日程}
end if

tell calendar 文档日程
make new event with properties {
summary: [合同] 劳务合同截止,
start date: date 2024-04-15 00:00:00,
end date: date 2024-04-15 23:59:59,
allday event: true,
description: 文档类型：合同\n发件：OO机构\n负责人：洪吉童,
url: https://notion.so/...
}
end tell
end tell

添加通知：
applescript
tell application Calendar
tell calendar 文档日程
tell event 事件名
-- 3天前通知（分钟：3 24 60 = 4320）
make new display alarm with properties {trigger interval: -4320}
-- 1天前通知
make new display alarm with properties {trigger interval: -1440}
-- 当天上午9点
make new display alarm with properties {trigger interval: 0}
end tell
end tell
end tell

ChatGPT环境

ChatGPT无法直接访问日历，因此提供以下方式：

方法1：生成ICS文件

生成标准iCalendar(.ics)文件，用户可通过双击添加到日历：

python
from icalendar import Calendar, Event, Alarm
from datetime import datetime, timedelta

def createics(eventsdata):
cal = Calendar()
cal.add(prodid, -//Doc Calendar Sync//KO)
cal.add(version, 2.0)
cal.add(calscale, GREGORIAN)

for item in events_data:
event = Event()
event.add(summary, f[{item[doc_type]}] {item[title]})
event.add(dtstart, item[date])
event.add(description, item[notes])

if item.get(url):
event.add(url, item[url])

# 添加通知
for minutes in item.get(alarms, [-4320, -1440, 0]):
alarm = Alarm()
alarm.add(action, DISPLAY)
alarm.add(trigger, timedelta(minutes=minutes))
alarm.add(description, f[{item[doc_type]}] {item[title]})
event.add_component(alarm)

cal.add_component(event)

return cal.to_ical()

方法2：提供AppleScript代码

生成用户可在macOS终端执行的osascript命令。

方法3：快捷指令(Shortcuts)联动指南

提供利用Apple快捷指令应用设置自动化工作流的指南。

重复防止

确认同一事件是否已存在于日历中：

1. 1. 相同标题 + 相同日期的事件存在时 → 跳过
2. 标题相同但日期不同时 → 建议更新现有事件
3. 在备注字段中包含doc_id以便追踪

重复日程处理

当文档中检测到每周、每月、每季度等重复模式时：

模式	重复规则
每周	FREQ=WEEKLY
每月

FREQ=MONTHLY |
| 每季度 | FREQ=MONTHLY;INTERVAL=3 |
| 每年 | FREQ=YEARLY |

重复结束日期设置为文档的end_date或合同结束日期。

处理报告

注册完成后报告：

• - 总注册事件数
• 按类型分布（截止日期N件，活动N件，期间N件）
• 跳过的项目（重复、无日期）
• 日历名称及确认方法
• 通知设置摘要

完整流程连接

此技能是整个工作流的最后阶段：

doc-parser → doc-structurer → notion-sync → calendar-sync
（读取） （结构化） （DB存储） （日程注册）

按顺序执行4个技能，即可完成读取文件夹内文档→分类/结构化→保存到Notion→将日程注册到日历的完整自动化。