calendar-sync

calendar-sync 是一个专为开发者与专案经理设计的专业自动化工具，旨在将技术活动日志可视化至 Google Calendar 中。通过将来自 GitHub 与 Linear 等平台的结构化数据转换为可执行的 gcalcli 指令，该工具免除了手动建立每日代码提交、PR 审查与问题管理的繁琐过程。此工具旨在作为生产力的客观记录者，确保日历反映您的真实技术产出，而不仅仅是预定的会议。

• 自动撷取并处理活动数据，包括 Commit、PR 建立/合并与议题评论。

• 实作智慧型回溯算法，将时间戳记视为完成事件，并根据历史工作时长模式推算开始时间。

• 支援 15 分钟时间对齐，确保日历保持清晰与易读性。

• 将相关工作整合为每个储存库的连贯工作阶段，防止排程混乱并保持逻辑分组。

• 提供自动重复检查功能，在建立新条目之前使用 gcalcli 检查现有事件。

• 支援使用者定义配置，包括时区调整、自订日历选择以及对工作阶段合并或重复检查的控制。

• 本技能接受通过 Markdown 表格、原始 JSON 物件 (GitHub/Linear API 输出) 或其他代理程式提供的结构化数据作为输入。

• 依赖 gcalcli 作为底层引擎，需配置本地环境以存取日历。

• 建议与 github-activity 或 linear-activity 技能配合使用，以实现无缝的数据流。

• 使用者可使用如「without grouping」或「separate events」等自然语言指令明确覆写分组规则，以调整工作阶段的建立方式。

• 请注意，工作阶段合并会尊重储存库边界——来自不同储存库的活动绝不会合并，即使它们是连续发生的。