repo-sync

Repo-sync 是一款專為 workspace-hub 多儲存庫架構所設計的進階協調技能。它能自動化管理超過 25 個獨立 Git 儲存庫的同步流程，處理大型開發環境中常見的 Git 狀態異常。此代理程式執行多階段作業：批次拉取、故障診斷、自動化修復、編碼健康驗證以及背景生態系統健康回報。專為管理分佈式程式碼庫的軟體工程師與系統架構師設計，提供可靠且非破壞性的方式來解決 detached HEAD、未提交變更及分支歷史分歧等問題。

• 使用最佳化指令碼跨所有子模組與儲存庫執行批次 Git 操作。

• 針對分支分歧、工作區髒亂 (未提交變更)、detached HEAD 狀態以及遺失上游追蹤分支等故障模式進行細緻診斷。

• 執行精確的自動修復，例如暫存髒亂變更、使用 --no-rebase 策略合併分歧分支，並在適當時重設子模組指標。

• 內含編碼健康檢查功能，可識別並標記 Windows 格式的 UTF-16/CRLF 檔案，確保儲存庫整潔並預防管線解析錯誤。

• 透過 ecosystem-health 技能觸發背景生態系統健康稽核，在不中斷使用者工作流程的前提下維護全域系統完整性。

• 實施嚴格的安全協定，包括針對「唯讀/已歸檔」遠端儲存庫的例外處理機制，在通知開發者前將僅存在於本機的提交保存為補丁物件。

• 一律預設採取合併而非變更基底 (rebase)，以維持 workspace-hub 生態系統中穩定的 Git 歷史記錄。

• 將子模組 (如 digitalmodel 與 worldenergydata) 的 detached HEAD 狀態視為正常行為，確保已鎖定提交指標的完整性。

• 執行完畢後會提供結構化的 Markdown 摘要表格，詳細列出儲存庫名稱、偵測到的問題、採取的修復方式以及最終結果。

• 需要本機寫入權限，並透過呼叫儲存庫工作區內標準的 Git 二進位檔案與 Shell 指令碼進行操作。

• 除非明確觸發，否則不會強制推送或強制重設 (reset --hard)，優先確保資料安全並針對如暫存衝突等破壞性情境保留人工審核流程。