技能版本與回滾

本頁用於通過獨立 Evolver 獲取技能文件，並維護可回退的安裝版本。操作前確認目標目錄和使用該技能的任務。

Skill 的可控版本由來源資產 ID、實際 SKILL.md 內容和安裝位置共同確定。更新前先預覽，不要把同名文件覆蓋當作自動升級。

技能版本由內容與使用位置共同確定

技能名稱用於識別用途，不能單獨標識一個可重現版本。管理記錄需要關聯來源資產 ID、實際安裝內容和目標目錄。兩個同名 SKILL.md 位於不同目錄，或者來自不同資產，都應分別核對；只更新其中一個文件不能證明所有使用方都已經切換。

審核差異時關注行為變化：技能是否增加工具調用、擴大訪問路徑、改變產物位置、引入外部依賴，或修改驗證與停止條件。下載成功只説明獲取完成，採用決定還需要解釋這些變化是否符合目標任務的權限和預期。

更新前保留舊文件、來源資產 ID、驗證命令和依賴它的任務清單。將新版本寫入目標位置後，先用一個邊界明確的任務驗證，並確認運行環境加載的是新文件，而不是另一個同名副本。

若驗證失敗，先停止新任務繼續使用該版本，再恢復舊文件並重新驗證。對新版本已經執行過的任務，另外核對文件修改和外部結果。技能文件恢復到舊版，只改變後續使用的內容；已經發生的操作要按任務記錄單獨處理。回滾記錄因此應同時包含當前文件版本和受影響任務的處置結果。

bash

evolver skill fetch --asset <asset_id>

預覽時記錄資產 ID、來源、摘要和內容差異。寫入前 Evolver 會重新校驗內容尋址，已有文件默認拒絕覆蓋。

首次安裝到已確認的目標目錄：

bash

evolver skill fetch --asset <asset_id> --write --out <dir>

已有文件時先停止依賴該技能的新任務，比較候選內容並保存當前版本。只有決定覆蓋時才改用：

bash

evolver skill fetch --asset <asset_id> --write --out <dir> --force

兩條命令按安裝場景選擇，不依次執行。將技能目錄納入 Git 或獨立版本化備份，並記錄資產 ID。寫入後檢查實際文件內容、所在目錄和加載該技能的環境，再運行預定驗證。內容校驗失敗時停止安裝，不用覆蓋參數繞過校驗。

text

skill name
installed asset_id
source and fetched time
target directory
reviewer and validation result
previous asset_id or backup revision

停止使用新版本，恢復上一個已驗證的 SKILL.md，再用原任務和驗證命令複測。skill fetch 不提供通用“回收站恢復”流程，因此回滾依賴預先保存的文件或版本庫，而不是事後尋找隱藏副本。

刪除技能文件前先檢查項目、自動化和説明文檔中的引用。刪除本地文件不會撤銷網絡資產；如果資產本身不再可信，還需要單獨執行撤銷決定。

安裝文件與已審核候選一致，驗證記錄關聯當前資產 ID，上一版本能夠恢復。回滾後同樣要複測，並記錄當前實際啓用的版本；恢復文件不撤銷新版本已經執行的外部操作。