核心用法
wip-release 是一款面向 Node.js 生态的自动化发布工具,通过单一命令完成完整的软件发布生命周期:语义化版本升级(patch/minor/major)、CHANGELOG 与 SKILL.md 同步更新、npm 注册表发布及 GitHub Release 创建。支持 CLI、程序化模块调用及 MCP 协议三种交互模式,适配本地开发与 AI 代理集成场景。
显著优点
1. 一站式自动化:将分散的版本管理、文档维护、多平台发布整合为原子化操作,显著降低人为遗漏风险
2. 智能文档门控:内置产品文档 freshness 检查,强制要求 minor/major 版本伴随产品文档更新,patch 版本仅警告不阻塞
3. 灵活执行模式:--dry-run 支持变更预览,--no-publish 支持本地测试标签,--skip-product-check 提供紧急绕过能力
4. 生态无缝集成:原生对接 1Password CLI(op)实现密钥安全托管,自动将 SKILL.md 发布至配套网站供 AI 检索
潜在局限
- 环境依赖较重:需预装 git、npm、gh (GitHub CLI)、op (1Password CLI) 及自定义 clawhub 工具链
- Node.js 版本约束:强制要求 Node.js 18+,遗留项目可能受限
- 预发布版本不支持:alpha/beta/rc 等先行版本尚未纳入支持路线图
- 无 package.json 项目排除:纯库或非 npm 项目无法使用
适合人群
- 维护
@wipcomputer命名空间下多个包的开发者团队 - 追求 GitOps 流程、需频繁迭代发布的开源项目维护者
- 已采用 1Password 作为密钥基础设施的安全意识组织
常规风险
- 密钥泄露面:依赖
~/.openclaw/secrets/op-sa-token及 1Password vault 中的 npm token,需确保目录权限严格限制(建议 0600) - 分支保护冲突:若仓库启用强制 PR review 或 status check,直接 push 至 main 可能失败
- 网站部署失败传递:SKILL.md 自动发布失败不会阻塞主发布流程,但可能导致文档与代码版本不一致