技能版本与回滚

本页用于通过独立 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，上一版本能够恢复。回滚后同样要复测，并记录当前实际启用的版本；恢复文件不撤销新版本已经执行的外部操作。