浏览 AI 知识库
Skill 怎么分享：版本化、打包并说明兼容性
分享 Skill 不能只发一个压缩包。版本、依赖、适用客户端、安装位置、升级与回滚方式都要写清，并在一台干净环境实际安装验证。
按实际操作顺序推进
每完成一段就检查当前输出，确认结果符合预期后再继续。
一句“解压后直接使用”，会把兼容和覆盖风险都留给接收者
团队收到一个 Skill 压缩包，只写“直接使用”。有人缺 Node 依赖，有人客户端版本不兼容，还有人覆盖了自己的旧配置。
- 版本、哈希和变更说明完整
- 依赖与权限可见
- 新装、升级和回滚均验证
动手前，把材料和不能改的部分定下来
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 准备发布 v1.2.0，含 SKILL.md、脚本和模板；支持的客户端版本、Node 版本与平台已实测。 |
| 不能越过的边界 | 版本化包与变更日志；列兼容性、依赖、权限、安装、验证、升级和回滚；不打包秘密和缓存。 |
| 要交付的结果 | 发布包、版本说明与安装验证 |
Skill 怎么分享，从“确定版本边界”开始做
确定版本边界
说明本版新增、修复、破坏性变化和与旧输出的差异，使用一致版本号。
清理发布包
移除密钥、个人路径、缓存、真实敏感数据和未引用文件，检查许可证。
写安装与配置
目标目录、作用域、依赖、变量和验证步骤来自实测，区分平台。
列兼容性
客户端版本、系统、运行时、外部工具和已知限制明确，未测试环境不宣称支持。
干净环境验证
从包安装，测试发现、触发、正常输出、缺材料、越界和卸载。
1.3.0 发布前，先证明别人能从干净目录安装
| 字段 | 示例 | 通过标准 |
|---|---|---|
| 版本 | [email protected] | 变更记录和包内版本一致 |
| 依赖 | Node 22；无全局依赖 | 干净环境可按说明运行 |
| 权限 | 只读 images/，写 reports/ | 脚本不会覆盖输入或联网 |
| 用例 | 20 张图生成逐文件报告 | 正例、缺字段和越界都可观察 |
| 回滚 | 恢复 1.2.2，清理 1.3.0 缓存 | 另一位成员可独立完成 |
版本和目录为演示输入；真实发布必须运行当前客户端、平台和依赖的干净环境验证。
完成后的发布包、版本说明与安装验证
发布包清单含 SHA-256、版本说明、支持矩阵和最小验证任务。新环境按说明安装后正例触发、反例不触发；从 v1.1.0 升级和回滚都完成记录。
为什么“包能安装，团队结果仍不同”还不能交付
包能安装，团队结果仍不同
- 原因
- 外部工具、模型或系统差异未纳入兼容说明
- 怎么改
- 记录实际测试组合和已知限制，不能验证的环境不标支持