Skill 怎样版本化、打包、分享并写兼容性说明

Skill 分享的是可安装版本，不是一个临时目录

发布前固定版本、文件清单、依赖、支持的客户端与平台、权限、变量和升级方式。在干净环境安装并跑最小用例。

确定版本边界

说明本版新增、修复、破坏性变化和与旧输出的差异，使用一致版本号。

记录客户端版本、Skill 版本、触发输入、实际步骤、工具调用和输出，正例与反例都要保留。

清理发布包

移除密钥、个人路径、缓存、真实敏感数据和未引用文件，检查许可证。

确认“清理发布包”已经有可回查结果，再进入“写安装与配置”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

写安装与配置

目标目录、作用域、依赖、变量和验证步骤来自实测，区分平台。

确认“写安装与配置”已经有可回查结果，再进入“列兼容性”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

列兼容性

客户端版本、系统、运行时、外部工具和已知限制明确，未测试环境不宣称支持。

确认“列兼容性”已经有可回查结果，再进入“干净环境验证”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

干净环境验证

从包安装，测试发现、触发、正常输出、缺材料、越界和卸载。

脚本、网络、凭证和写操作必须在说明中可见；触发边界不清或结果不可验收时不要扩大使用范围。 完成后把证据归入“发布包、版本说明与安装验证”。

发布包要能被回滚

保留上一稳定版和迁移说明。团队升级前先在一个项目试点，出现冲突能恢复旧版而不丢输入与产物。