用途：在仓库中发布或准备发布 npm 包，尤其是 packages/cli 下的 Skill Zoo CLI 包；也用于排查重复版本、认证、owner、tarball、bin 等问题，或判断包是否可发布。不适用于桌面应用 GitHub Releases、Homebrew cask 或 Tauri updater。
主要能力：确认真正的可发布包（根包为 private，目标为 packages/cli）；发布前检查仓库说明与工作区状态；查询 npm registry 版本、dist-tags、whoami、owner；按用户确认的版本更新 package.json 与 bun.lock；运行 typecheck、test、build、npm publish --dry-run；校验 tarball 内容与 bin 可执行性；发布后验证版本与 dist-tag。
使用方式：先 cd packages/cli，检查 npm view skill-zoo version dist-tags --json 等；版本已存在时须让用户确认新版本，不可静默选择。验证命令为 npm run typecheck、npm test、npm run build、npm publish --dry-run。确认后执行 npm publish --auth-type=web。非 TTY 环境可用 script -q /dev/null npm publish --auth-type=web 2>&1 & 获取真实认证 URL。发布后运行 npm view skill-zoo@X.Y.Z version dist.tarball time --json、npm dist-tag ls skill-zoo、npm view skill-zoo versions --json。
限制：npm 版本不可变；不得将账号、邮箱、token、认证 URL、调试日志路径等隐私写入仓库或总结；不得提交生成的 tarball 或临时目录；工作目录不跨工具调用保留，命令需自带 cd；发布前必须获得用户明确确认。