add-event

此技能作為 SydJS 網路平台的自動化內容架構工具。它旨在透過直接從 meetup.com URL 提取活動中繼資料，協助管理員建立新的聚會活動頁面。透過標準化建立流程，確保所有活動都遵循正確的檔案命名約定（YYYY-MM-DD-kebab-event-title.mdoc），並遵守 src/content/events/ 目錄內專案的結構要求。

該工具主要適用於管理 SydJS 網站內容的開發人員或組織者。它處理原始活動詳細資料（如標題、日期、地點和描述）並將其對應到 Keystatic CMS 實作所需的特定 Markdoc 前置格式（frontmatter）結構。它在減少手動輸入錯誤的同時，確保整個網站活動歷史記錄的一致性。

• 自動從 meetup.com 活動連結獲取中繼資料，包括活動名稱、日期、場地和描述。

• 產生預設好 boilerplate 欄位（如 featuredMedia、startTime 和 endTime）的格式化 .mdoc 檔案。

• 強制執行嚴格的檔案命名模式，確保 Next.js 路由和集合排序保持一致。

• 當特定地點資料缺失時，提供場地名稱和地址的預設值（例如：Atlassian Headquarters）。

• 直接與儲存庫的集合結構整合，確保產出的內容立即與 Keystatic 資料架構相容。

• 輸入：有效的 meetup.com 活動連結；若預設值不適用，可提供時間、場地或地址的覆蓋值。

• 輸出：儲存在 src/content/events/ 中並配置好所有前置參數的完整 Markdoc 檔案。

• 若無法抓取 URL 或未提供連結，技能將提示使用者手動提供活動標題、日期、地點和描述。

• featuredMedia 欄位預設初始化為 { discriminant: none }，預計在建立後手動配置。

• 講座和演講者列表初始化為空陣列，因為內容更新通常是分開進行的步驟。

• 在執行前，請確保位於正確的分支，並擁有 src/content/events/ 目錄的寫入權限。