Vercel Skills 1.9 鎖檔怎麼看?確認 Git Commit 與安裝內容
本文目錄
如果前後兩次安裝同一個 Skill 得到不同指令,光比 skills-lock.json 中的來源網址和分支很難確認發生了什麼。Vercel Skills 1.9.0 會記錄 Git 來源的安裝 commit。看到 lockfile 變更時,可以先看來源版本有沒有移動,再用 computedHash 確認還原後的檔案內容。Skills 1.9.0 發行說明
鎖檔變更從哪幾項看起?
| 變更 | 審查方法 |
|---|---|
commit 變了 | 開 Git 來源的兩個 commit,比對 Skill 目錄,特別是指令和隨附腳本。 |
commit 相同、computedHash 變了 | 先看有沒有用 --rename。重新命名會改寫安裝版 SKILL.md 的 name,雜湊也會跟著變。版本沒移動時,再查本地內容與鎖檔遷移。 |
舊項目缺少 commit | 先安排一次明確的更新,審查補入的來源版本與檔案差異。無法從現有鎖檔確認 SHA 時,先別把它當成已鎖定的 Git 還原基準。 |
commit 決定 CLI 去哪個 Git 版本取資料,computedHash 的檢查對象則是安裝目錄裡的檔案。推進來源版本用 skills update,還原鎖定內容時,1.9.0 的文件列出已記錄 commit 的 Git 來源會按該 SHA 抓取。Git 主機也要允許依 SHA 取得該 commit。固定版鎖檔規格
在乾淨目錄還原一次
在包含有效專案鎖檔的隔離 checkout 中,用團隊採用的 CLI 版本執行 frozen 還原。以下命令以 1.9.0 為例。鎖檔若太舊或缺少可用雜湊,先在更新分支重建並審查,再把新鎖檔交回 CI。
npx --yes skills@1.9.0 experimental_install --frozen-lockfilegit diff --exit-code -- skills-lock.json本機驗證使用 Node.js v24.13.0 與 Skills 1.9.0,在暫存儲存庫安裝並重新命名一個公開 Skill。移開安裝目錄後執行 frozen 還原,鎖檔沒有差異,還原的 Skill 檔案也與原安裝版本一致。
還原成功後,檢查專案預期的 Skill 名稱,尤其是曾經因為名稱衝突而用 --rename 的那一個。被改名的項目以安裝名稱作為鎖檔 key,原始名稱另外用 skillName 記錄。這讓你能從目前的名稱回查上游來源,並在升級時保留團隊使用的呼叫名稱。Skills 1.9.0 指令參考
還原檢查能回答「裝到哪個版本、內容是否符合鎖檔」。Skill 允許代理做哪些事,還要讀指令、工具與權限。若透過 Codex Plugin 散布,也可以用安裝前的權限檢查審查。
參考資料: