核心功能概述
wip-release 是一款面向 Node.js 开发者的本地发布自动化工具，旨在将繁琐的版本发布流程简化为单一命令执行。该工具深度整合 git、npm、GitHub 及 1Password 等基础设施，实现从版本号管理到多平台分发的全链路自动化。
核心用法与工作流程
工具采用语义化版本控制（SemVer）机制，支持 patch、minor、major 三种升级级别。基础命令格式为 wip-release <level> [options]，典型执行场景包括：
- 完整发布流程：
wip-release patch --notes="fix X" - 预览模式：
wip-release minor --dry-run - 仅版本标记：
wip-release major --no-publish
执行后自动完成以下操作序列：版本号递增 → 变更日志更新 → SKILL.md 版本字段同步 → git 标签创建 → npm 注册表发布 → GitHub Release 生成。整个过程无需人工干预。
显著优势
高度集成化设计：将分散在多个工具中的操作（npm version、git tag、gh release 等）统一封装，显著降低认知负荷与操作失误风险。
智能文档门控：内置产品文档 freshness 检查机制，强制要求在 minor/major 发布前更新开发日志、产品路线图及核心说明文档，有助于维持项目文档与代码状态的同步性。
Skill 自动发布：创新性地支持将 SKILL.md 自动同步至独立网站，使 AI Agent 可通过标准 URL 获取结构化安装指令，增强工具的可发现性与可集成性。
多接口兼容：同时提供 CLI、JavaScript 模块及 MCP（Model Context Protocol）三种调用方式，满足不同场景下的集成需求。
潜在局限与风险
生态锁定：深度依赖 @wipcomputer 内部工具链（如 clawhub、op CLI）及特定目录结构（ai/ 产品文档目录），跨团队或开源社区通用性受限。
预发布版本缺失：明确不支持 alpha/beta 等预发布版本号管理，限制早期测试阶段的灵活性。
外部服务依赖：核心功能依赖 1Password 服务账户令牌及 npm 发布令牌，需预先配置密钥管理体系，增加初始部署复杂度。
分支保护冲突：直接 push 至 main 分支的设计可能与启用分支保护规则的仓库产生冲突，要求特定 GitHub 工作流配合。
适用人群
主要面向维护 @wipcomputer 命名空间下 Node.js 包的内部开发者，以及追求发布流程自动化、已建立标准化产品文档体系的中小型技术团队。
安全考量
工具需访问高敏感凭证（npm 发布令牌、GitHub CLI 认证），建议严格遵循最小权限原则配置 1Password Vault，并定期轮换服务账户令牌。--skip-product-check 选项虽提供灵活性，但滥用可能导致文档与版本脱节。