nav-release 是 Supernavigator 项目中的发布技能,用于在将 Navigator 插件发布到市场前进行完整性校验并执行发布流程。其存在背景是 v5.1.0 事故:plugin.json 引用了 nav-profile 但该技能从未提交,导致安装失败。
用途:在用户说出“release plugin”“publish navigator”“create release”“deploy new version”或“release vX.Y.Z”时自动触发,完成带安全检查的发布。仅提交改动、只更新文档或本地测试时不应触发。
主要能力:发布前校验 plugin.json 中所有技能是否存在、技能文件是否已提交(非未跟踪)、各文件版本是否一致、skills/ 下是否有未提交改动;展示校验结果;确认版本后执行提交、推送、打标签、创建 GitHub Release;发布后验证标签内容并清理本地缓存。
使用方式:先运行 python3 functions/release_validator.py --check-all 校验;确认版本后依次执行 git add .、git commit、git push origin main、git tag -a vX.Y.Z、git push origin vX.Y.Z、gh release create vX.Y.Z --title "Navigator vX.Y.Z" --notes-file RELEASE-NOTES-vX.Y.Z.md;随后运行 python3 functions/release_validator.py --verify-tag vX.Y.Z 验证,并可用 rm -rf ~/.claude/plugins/cache/navigator-marketplace/ 清理缓存。校验失败时需先修复缺失技能、未提交技能或版本不一致问题。
适用场景:Navigator 插件正式发布、版本升级与发布后验证。限制:资料未提供该技能支持的平台范围、依赖版本要求及失败重试的完整细节。