同步供應商技能與上游 是做什麼的?
先決條件:已認證的 gh CLI。請從儲存庫根目錄執行所有指令。
工作流程
-
執行
node scripts/skills-sync.mjs status。各狀態及其處理方式如下:up-to-date— 無需任何動作。local— 自有技能,無上游;無需同步。upstream-updated— 可安全快轉:node scripts/skills-sync.mjs pull <plugin>/<skill>。locally-modified— 我們在上次基準線之後進行了編輯。如果這些編輯是有意為之,請執行node scripts/skills-sync.mjs accept <plugin>/<skill>。diverged— 雙方都發生了變更:請手動合併(詳見下方章節)。fetch-error (...)— 上游無法連線或已移動;請檢查外掛程式中skills-lock.json的source/skillPath是否與上游儲存庫相符。
-
在所有變更完成後:執行
node scripts/skills-sync.mjs verify,然後提交訊息,並在訊息中列出哪些技能已拉取或合併,以及來自哪個上游提交。
發散技能的手動合併
切勿盲目覆寫發散的技能 — pull --force 會捨棄我們的自訂內容。
node scripts/skills-sync.mjs diff <plugin>/<skill>— 完整的差異比較,從供應商版本到上游版本。- 識別哪些差異是我們有意的自訂修改
(
git log -p -- <plugin>/skills/<skill>會顯示供應商複製版本的演化過程), 以及哪些是真正的上游改進。 - 編輯供應商檔案,以納入上游改進,同時保留每一項本地自訂內容。請在編輯前完整閱讀兩個版本。
- 為雙方重新建立基準線:
node scripts/skills-sync.mjs seed <plugin>/<skill>(accept只會重新建立供應商版本的雜湊值,並會使該技能永久標記為上游已更新狀態)。