連接 GitLab 至 Notion
GitLab 可協助團隊管理程式碼、協作軟體開發並追蹤發布版本。您可以將 GitLab 專案、問題、合併請求、管線與發布版本同步至 Notion，讓開發工作與團隊的計畫及文件保持同步。
我們正在以 Notion Workers 驅動的自訂同步作業，取代現有的託管式 GitLab 同步作業。您可以自訂要同步的資料以及這些資料在 Notion 中的組織方式。您現有的同步資料會保留在 Notion 中；請依照本指南設定替換項目。深入了解 Notion Workers →
現有的 GitLab 同步將於 2026 年 10 月 30 日 停止運作。在此之前它們會維持正常運作，但不會自動遷移。我們建議您在該日期之前設定好替換同步。
Worker 會在 Notion 的基礎架構上執行您的同步。若要設定您的替代方案，請在與 Notion AI 的對話中 @-提及您現有的同步資料庫，並包含 GitLab 同步技能。
請準備好以下項目：
您在 Notion 中現有的 GitLab 同步資料庫。請確保 Notion AI 可以存取它。
要包含的完整 GitLab 專案清單。您可以提供專案網址、數字 ID 或路徑，例如 my-team/my-project。了解如何 在 GitLab 中檢視專案 →
一個具備 read_api 權限且可存取每個選取專案的 GitLab 個人或專案存取權杖。
存取 Workers 的權限，以及 Notion AI 在您的工作空間中建立並部署 Worker 所需的工具。
此技能頁面，您將會複製到您的 Notion 帳戶中：GitLab 指南：Worker 同步。此技能適用於 GitLab.com。如果您使用自架的 GitLab 執行個體，請在設定前告知 Notion AI。該指南的 API 位址與憑證設定需要針對您的執行個體進行調整與驗證。
提示：本指南會建立替換資料庫。您現有的資料庫在您檢查時仍可使用。其頁面連結、瀏覽模式、關聯以及僅限 Notion 的資訊不會自動轉移。
在包含您現有同步資料庫的工作空間中，開啟與 Notion AI 的對話。
複製下方的（文字）指令。輸入 @ 並從提及選單中選取實際的資料庫，以取代 @現有的 GitLab 同步資料庫。如果問題與合併請求位於不同的同步資料庫中，請同時提及兩者。
使用 GitLab 指南：Worker 同步，將我目前的 GitLab 同步 @現有的 GitLab 同步資料庫 取代為 Notion Worker。
檢查現有的資料庫，並與我確認完整的 GitLab 專案清單。依照此技能建立每小時同步、五個相關資料庫、瀏覽模式，以及位於私人「GitLab 同步」頁面下的儀表板。如果已存在替代的 Worker，請在適當的情況下檢查並重複使用它。
保持我現有的資料庫完整。識別需要個別處理的自訂屬性、僅限 Notion 的值、瀏覽模式、關聯與連結。透過安全的憑證輸入欄位要求我的 GitLab 權杖，不要在對話中提供。
預覽每個選取的專案與資料類型，完成首次同步，並檢查記錄與專案關聯。在變更舊的同步之前，向我展示替代的資料庫、任何差異，以及切換的步驟。
請在（文字）指令中選取實際的資料庫提及。僅輸入資料庫名稱無法讓 Notion AI 取得檢查用的連結。
確認完整的專案清單，包含目前 Notion 檢視篩選器所隱藏的專案。若同步需要存取其他專案，僅限單一專案的權杖將不足以使用。
依照 Notion AI 的指示，透過安全的憑證輸入欄位提供您的 GitLab 權杖。該權杖需要 read_api 權限，並能存取選取的專案。
請勿將權杖貼到聊天室、Notion 頁面或資料庫屬性中。Worker 使用代理憑證，因此其程式碼不需要讀取原始權杖。
此設定使用新的 Worker 憑證。您現有的 GitLab 連接不會自動提供它。
如果 Notion AI 無法存取該技能或 Worker 工具，請先解決存取問題。連結的指南也包含供您團隊中可以使用 Notion CLI 的人員參考的設定說明。
此技能會建立一個私人的 GitLab Sync 頁面，其中包含五個同步資料庫和一個儀表板：
資料庫 | 包含內容 |
|---|---|
GitLab 專案 | 專案名稱、路徑、描述、封存狀態、可見度、預設分支、連結和活動日期。 |
GitLab 問題 | 包含各種狀態的問題，以及指派對象、標記、里程碑、嚴重性、到期日和專案關聯。 |
GitLab 合併請求 | 包含各種狀態的合併請求，以及草稿狀態、作者、指派對象、分支、合併狀態和專案關聯。 |
GitLab 管線 | 包含管線狀態、參考、來源、日期、連結和專案關聯。 |
GitLab 發行版本 | 包含發行版本名稱、標記、描述、發行日期、連結和專案關聯。 |
GitLab 儀表板 將這些記錄匯總在圖表和工作佇列中。它包含未解決的問題、未解決的合併請求、失敗的管線、最近的發行版本以及專案活動。
這五個同步資料庫包含這些記錄。儀表板會顯示這些記錄的瀏覽模式。您舊有的問題或合併請求資料庫所涵蓋的資料類型，可能比此技能的預設設定還要少。
切換前請先檢查這些差異：
人員與標記： 作者、指派對象和標記在本指南中儲存為文字。它們並非 Notion 的人員或多選屬性。
專案關聯： 問題、合併請求、管線與發行版本應連結至其選取的專案記錄。
記錄識別： 即使使用相同的專案本地問題或合併請求編號，來自不同專案的記錄也必須保持區隔。
額外內容： 本指南不會同步問題留言、合併請求討論、儲存庫檔案或工作記錄。請詢問 Notion AI 以評估您現有工作流程所需的任何額外欄位。
請等待 Notion AI 確認所有五個同步皆正常運作，且初始匯入已完成。
比較每個選取的專案與 GitLab。檢查未解決與已關閉的問題、合併請求、管線與發行版本的樣本。
確認專案關聯與儀表板瀏覽模式顯示預期的記錄。
檢查最近的 GitLab 變更在成功重新整理後是否已傳送至替代資料庫。
請評論舊資料庫的自訂屬性與僅限 Notion 的值。使用穩定的 GitLab 記錄 ID 轉移您所需的內容。
更新應使用該替代資料庫的連結、連結資料庫瀏覽模式、關聯與自動化。請評論新頁面的分享權限。
一旦您的團隊開始使用該替代資料庫，請詢問 Notion AI 協助停用舊的同步，同時保留舊資料庫以供參考。
您不需要刪除舊資料庫即可使用 Worker。請保留它，直到您確認團隊的資訊與工作流程皆已妥善處理。
此技能會設定五個每小時一次的同步，每個資料類型各一個。專案會在設定期間優先同步，以便其他資料庫能將其記錄關聯至正確的專案。
每次成功的重新整理都會讀取已設定專案的所有結果頁面，並更新對應的 Notion 資料庫。即使關閉 Notion，Worker 仍會持續執行。
更新會從 GitLab 流向 Notion。請在 GitLab 中變更已同步的值；在 Notion 中所做的變更不會寫回。
每小時一次是排程，並不保證每次重新整理都能在固定時間內完成。龐大的專案歷史記錄與 GitLab 請求限制可能會延遲完成時間。
提示：請保留完整的專案列表。這些同步作業使用取代模式：在完成重新整理後遺失的記錄會從已同步的資料庫中移除。從設定中移除專案可能會移除其已同步的記錄，包含這些頁面上僅限 Notion 的資訊。在套用變更前，請要求 Notion AI 預覽每個選取專案與資料類型。
此技能會從一個私人的 GitLab Sync 頁面開始。請僅與應該查看匯入記錄的人員分享該頁面。
Notion 的權限會控制對已同步資料的存取。GitLab 專案的 Visibility 屬性或問題的 Confidential 屬性不會在 Notion 中強制執行該來源權限。在分享頁面之前，請先評論權杖所包含的資料。
專案遺失
確認完整的專案列表與權杖存取權。如果專案路徑已變更，請提供 Notion AI 該專案的 URL 或數字 ID。請勿為了規避存取錯誤而使用縮減後的列表執行重新整理。
問題或合併請求遺失
請 Notion AI 檢查專案選取項目，確認其是否正在檢查每個狀態下的問題與合併請求，以及結果的每一頁。同時也請檢查 Notion 瀏覽模式的篩選器。
儀表板是空的
在重建儀表板之前，請 Notion AI 檢查來源資料庫、其最新的同步結果以及專案關聯。當初始匯入仍在執行時，儀表板可能會是空的。
我看到重複的資料庫
在建立任何其他項目之前，請 Notion AI 檢查現有的 Worker、資料庫網址以及頁面結構。此技能需要 GitLab Sync 下有五個實際同步資料庫和一個儀表板。請讓 Notion AI 在移除重複項目之前先識別它們。
更新已停止
請 Notion AI 檢查 Worker 的最新執行情況、權杖過期時間、權杖權限，以及對每個所選專案的存取權限。若是自行管理的執行個體，也請檢查已設定的 GitLab 主機。請求限制可能會延遲更新。
