Community寫作與編輯github.com

同步供應商技能與上游

一套工具,用於管理 Laravel 與 React 應用程式中代理開發技能的同步與合併流程。

同步供應商技能與上游 是什麼?

此技能提供了一個結構化的工作流程,用於管理從上游儲存庫複製(vendor)的技能檔案同步。它透過 `scripts/skills-sync.mjs` 腳本自動化狀態檢查,並根據技能狀態(如 up-to-date、local、upstream-updated、locally-modified 或 diverged)提供明確的動作指引。這對維護同時引用上游更新和本地自訂技能的長期專案至關重要。當發生發散(diverged)時,使用者必須手動合併,先檢視差異(diff),仔細辨別本地自訂與上游改進,再編輯檔案以保留兩者。合併後需重新建立基準線(run seed),確保後續同步能正常運作。此流程支援任何 git 管理的事業,可避免強制覆蓋(pull --force)造成本地自訂永久流失。進階使用者可在修改檔案前使用 `git log -p` 檢視完整的演化歷史,做出更明智的合併決策。

相容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add noppu-labs/ai-toolkit

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

同步供應商技能與上游 是做什麼的?

先決條件:已認證的 gh CLI。請從儲存庫根目錄執行所有指令。

工作流程

  1. 執行 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 是否與上游儲存庫相符。
  2. 在所有變更完成後:執行 node scripts/skills-sync.mjs verify,然後提交訊息,並在訊息中列出哪些技能已拉取或合併,以及來自哪個上游提交。

發散技能的手動合併

切勿盲目覆寫發散的技能 — pull --force 會捨棄我們的自訂內容。

  1. node scripts/skills-sync.mjs diff <plugin>/<skill> — 完整的差異比較,從供應商版本到上游版本。
  2. 識別哪些差異是我們有意的自訂修改 (git log -p -- <plugin>/skills/<skill> 會顯示供應商複製版本的演化過程), 以及哪些是真正的上游改進。
  3. 編輯供應商檔案,以納入上游改進,同時保留每一項本地自訂內容。請在編輯前完整閱讀兩個版本。
  4. 為雙方重新建立基準線:node scripts/skills-sync.mjs seed <plugin>/<skill> (accept 只會重新建立供應商版本的雜湊值,並會使該技能永久標記為上游已更新狀態)。

相關技能