核心用法
wip-release 是专为 @wipcomputer 生态设计的本地发布流水线工具，通过单一命令完成从版本升级到多平台发布的完整流程。CLI 主命令格式为 wip-release [patch|minor|major]，支持 --dry-run 预览、--no-publish 仅打标签、--skip-product-check 绕过产品文档检查等选项。
工具内置三大核心能力：版本管理（自动遵循 SemVer 规范）、文档同步（自动更新 SKILL.md 版本号）、产品文档门禁（检查 ai/dev-updates/、roadmap.md、readme-first-product.md 的更新状态，patch 级别警告，minor/major 级别阻断）。发布完成后，可自动将 SKILL.md 同步到配置的 website 仓库，生成公开可访问的安装指引。
显著优点
- 全自动化：单命令替代手动版本升级、日志编写、npm publish、GitHub release 四步操作
- 智能门禁：强制产品文档与代码变更同步，避免"代码更新了但用户不知道改了什么"
- 多接口支持：CLI、Node.js 模块、MCP 三种调用方式，适配不同集成场景
- 安全集成：原生支持 1Password CLI 密钥管理，避免明文存储 npm token
潜在缺点与局限
- 生态锁定：设计上优先服务 @wipcomputer 命名空间包，通用性受限
- 预发布缺失：明确不支持 alpha/beta 预发布版本
- 依赖较重：需同时安装 git、npm、gh、op、clawhub 五个二进制工具及 Node.js 18+
- 门禁硬编码：产品文档路径和检查逻辑固化，难以自定义企业文档规范
适合人群
- 使用 @wipcomputer 命名空间包的开发者
- 需要强制产品-研发流程对齐的技术团队
- 已采用 1Password 作为密钥管理的组织
常规风险
- 分支保护冲突：若仓库启用分支保护，工具可能因无法直接 push 而失败
- 1Password 依赖：密钥获取失败将阻断整个发布流程
- 非阻塞部署：网站同步失败不会阻止发布成功，可能导致文档与版本不一致
安全与可信度
工具要求本地存储 1Password 服务账户令牌 (~/.openclaw/secrets/op-sa-token)，具备本地文件系统读取权限。由于报告为系统占位生成，未执行实际安全扫描，建议用户自行审计 npm 包内容及 MCP 服务器代码。