653 字
3 分鐘

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。

Terminal window
npx --yes skills@1.9.0 experimental_install --frozen-lockfile
git 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 散布,也可以用安裝前的權限檢查審查。

參考資料:

Vercel Skills 1.9.0 發行說明

Skills 1.9.0 鎖檔雜湊規格

Skills 1.9.0 指令參考

Vercel Skills 1.9 鎖檔怎麼看?確認 Git Commit 與安裝內容
https://laplusda.com/posts/vercel-skills-lockfile-git-commit/
作者
Zero
發佈於
2026-11-17
許可協議
CC BY-NC-SA 4.0