核心用法
wip-release 是一个面向 Node.js 项目的本地发布自动化工具，通过单一命令完成从版本号提升到多平台发布的完整流程。支持通过 CLI、JavaScript 模块或 MCP 协议三种方式调用。
CLI 工作流：
wip-release patch --notes="fix X" # 完整发布流程 wip-release minor --dry-run # 仅预览，不执行 wip-release major --no-publish # 仅版本提升和打标签
主要功能闭环：
1. 语义化版本提升 - 自动计算 patch/minor/major
2. 文档同步更新 - 自动同步 SKILL.md 中的 version 字段
3. 产品文档门控 - 检查 AI 产品文档（roadmap、dev-updates 等）是否及时更新，minor/major 版本会阻断发布直至文档同步
4. 双平台发布 - 同时推送到 npm 和 GitHub Releases
5. 网站自动部署 - 可选将 SKILL.md 发布到官网，供 AI 代理获取
显著优点
- 高度自动化：单次命令替代手动 5-7 个步骤，显著降低发布负担
- 内置质量门控：强制要求产品文档与代码版本同步，适合 AI 原生开发流程
- 安全集成：原生支持 1Password 服务账号，避免明文存储 npm token
- 灵活配置：支持 --dry-run 预览、--no-publish 本地测试、--skip-product-check 绕过检查
- MCP 就绪：提供标准 MCP server，可被 Claude Desktop 等 AI 客户端直接调用
潜在局限
- Node.js 限定：依赖 package.json，无法用于 Python/Rust 等其他生态
- 预发布不支持：alpha/beta/rc 版本尚未实现
- 硬编码依赖：强制要求 git、npm、gh、op、clawhub 五个二进制工具，环境准备成本较高
- 单作者生态：由 Parker Todd Brooks 个人维护，尚未形成社区贡献规模
适合人群
- 频繁发布 npm 包的独立开发者或小团队
- 采用 "AI 原生" 工作流、需要维护 SKILL.md 和结构化产品文档的开发者
- 已使用 1Password 进行密钥管理的团队
常规风险
| 风险点 | 说明 | 缓解方式 |
|--------|------|----------|
| 密钥泄露 | npm token 通过 1Password 动态获取，但仍存在本地临时缓存 | 确保 `~/.openclaw/secrets/` 目录权限严格 |
| 分支保护冲突 | 若启用 GitHub branch protection，本地 push 可能失败 | 确保在 PR 合并后执行，或使用个人访问令牌 |
| 文档门控误阻 | 修改了代码但未更新 AI 文档时，minor/major 发布被阻断 | 使用 `--skip-product-check` 或建立文档更新 checklist |
| 网站部署失败 | 可选的网站发布步骤失败不会阻塞主流程 | 需独立监控 `deploy.sh` 执行状态 |