Skill 更新差异检查
把“版本号变了”拆成用户真正关心的变化：代码和文件变了什么、能力边界是否扩大、是否新增联网对象或危险行为。
运行条件：Python 3.10+，仅使用标准库，支持目录或 ZIP；默认不联网、不执行被检文件、不修改新旧版本。
适用边界
- 输入必须是同一个 Skill 的两个版本，可分别为目录或 ZIP。
- 只做静态比较和风险增量分析；不运行任一版本，不自动下载更新，不替用户执行升级。
- 若只有一个版本，先请用户提供另一个版本或明确授权获取；不要把单包扫描伪装成版本比较。
- 不把“文件很多”直接判为危险，重点看新增能力、权限、域名、脚本和高风险证据。
运行前完整性检查
先确认当前 Skill 目录内存在且可读取 scripts/skill_guard.py。若文件不存在，立即停止并明确报告“Skill 包不完整，请重新安装完整版本”。不得临时编写、下载或使用所谓“等价实现”替代，因为那会改变本 Skill 的比较规则和结果口径。
操作流程
- 明确旧版和新版，确认没有把顺序放反。
- 选择新旧版本之外的报告目录，运行：
text
python scripts/skill_guard.py compare --old <旧版目录或ZIP> --new <新版目录或ZIP> --output <报告目录>
- 读取
skill-update-diff.md和skill-update-diff.json。退出码0表示比较完成且未出现需暂停升级的新增高风险；2表示比较完成但建议暂停升级并复核；1表示运行失败。 - 先说明建议，再列新增能力和证据，最后列普通文件变化。不要只输出文件清单。
升级建议规则
- 暂停升级：新增严重/高风险能力、疑似敏感信息、远程执行链路，或 Skill 标识异常变化。
- 复核后升级：新增外部域名、命令执行、文件写入、依赖安装或权限声明，但暂未形成高风险组合。
- 可在备份后升级：仅有说明、规则、模板等低敏变化，且没有新增敏感能力。
详细解释见 references/diff-interpretation.md。
输出要求
最终说明至少包含：旧版/新版标识与版本、升级建议、新增能力、新增域名、新增高风险证据、增加/删除/修改文件数量、报告位置。结论是风险建议，不是对作者动机的判断。
