技能介绍

要解决什么问题

自己维护的 Skill 往往只有工作区里的一份目录，没有版本号、也没有可分享的发布物。协作或回滚时只能靠拷贝文件夹或 git 标签，CHANGELOG 和「当前最新版」也缺少统一约定。这个技能把发布流程固定成：确认信息 → 跑脚本 → 核对产物，让每次迭代都在 releases/ 下留下可追溯的文件夹与 ZIP。

核心工作流

发布前会先对齐三项信息（你已说明的可以跳过）：skill 路径、语义化版本号 vX.Y.Z、发布说明。版本号默认在已有版本上递增 patch；你也可以按变更性质手动选 patch（修 bug/文案）、minor（新功能/模块）或 major（破坏性重构）。

确认后运行 scripts/release.py，传入 skill 路径、版本号与输出目录。脚本会：

校验 SKILL.md 结构是否完整
生成 文件夹发布物：releases/<skill>-vX.Y.Z/（完整目录，便于直接查看或改）
生成 ZIP：releases/<skill>-vX.Y.Z.zip（便于传输）
更新或创建 releases/CHANGELOG.md
更新 releases/LATEST 指向当前最新版本

完成后应核对文件夹与 ZIP 路径、releases/ 下版本列表，以及 CHANGELOG 新增段落。

适用边界

首次发布一般从 v1.0.0 起，releases/ 会自动创建；历史版本文件不会被覆盖，只是新增目录与压缩包。回滚不是自动操作：需要从 releases/ 或 CHANGELOG 找到目标版本的文件夹/ZIP，再手动安装。更细的版本号与 CHANGELOG 格式见技能内 references/versioning.md。