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」等自然語言指令明確覆寫分組規則，以調整工作階段的建立方式。

• 請注意，工作階段合併會尊重儲存庫邊界——來自不同儲存庫的活動絕不會合併，即使它們是連續發生的。