AsiaOstrich 发布助手
语言: English | 简体中文
引导遵循语义化版本和变更日志最佳实践的发布流程。
子命令
| 子命令 | 说明 | Description |
|---|---|---|
start |
开始发布流程 | Start a release branch/process |
finish |
完成发布（标签、合并） | Finalize release (tag, merge) |
changelog |
产生或更新变更日志 | Generate or update CHANGELOG.md |
check |
执行发布前检查 | Run pre-release verification |
版本类型
| 类型 | 格式 | npm Tag | 用途 |
|---|---|---|---|
| 正式版 | X.Y.Z |
@latest |
Stable |
| 公开测试 | X.Y.Z-beta.N |
@beta |
Beta |
| 内部测试 | X.Y.Z-alpha.N |
@alpha |
Alpha |
| 候选版本 | X.Y.Z-rc.N |
@rc |
RC |
工作流程
- 决定版本 - 根据变更决定版本类型（MAJOR/MINOR/PATCH）
- 更新版本文件 - 更新 package.json 和相关版本引用
- 更新 CHANGELOG - 将 [Unreleased] 条目移至新版本区段
- 执行发布前检查 - 验证测试、lint 和标准合规
- 建立 git tag - 使用
vX.Y.Z格式标签 - 提交并推送 - 提交版本更新并推送标签
版本递增规则
| 变更类型 | 递增 | 范例 |
|---|---|---|
| 破坏性变更 | MAJOR | 1.9.5 → 2.0.0 |
| 新功能（向下兼容） | MINOR | 2.3.5 → 2.4.0 |
| 错误修复（向下兼容） | PATCH | 3.1.2 → 3.1.3 |
使用方式
/release start 1.2.0- 开始 v1.2.0 的发布流程/release changelog 1.2.0- 更新 v1.2.0 的 CHANGELOG/release finish 1.2.0- 完成并标签 v1.2.0/release check- 执行发布前验证
下一步引导
/release 完成后，AI 助手应建议：
发布流程完成。建议下一步：
- 验证 npm 发布状态
npm view <pkg> dist-tags- 建立 GitHub Release 并撰写发布说明
- 通知利益相关者新版本已发布
参考
- 变更日誌格式指南 — 要撰写或审查变更日志时读它。
- 發布流程指南 — 真的要发一版、需要逐步流程时读它。
- 語意化版本指南 — 要判断一个变更算 major、minor 还是 patch 时读它。
- 详细指南：guide.md
- 核心规范：versioning.md