Release Skills — Release 技能s

发布技能 通用发布工作流，支持任何项目类型，具有多语言变更日志生成。 支持的项目类型 版本文件 自动检测 Node.js package.json Python pyproject.toml Rust Cargo.toml Claude Plugin marketplace.json 通用 VERSION / version.txt 选项 标志 描述 --dry-run 预览更改而不执行 --major 强制主版本升级 --minor 强制次版本升级 --patch 强制补丁版本升级 工作流 步骤 1：检测配置 检查 .releaserc.yml（可选配置） 自动检测版本文件（优先级：package.json → pyproject.toml → Cargo.toml → marketplace.json → VERSION） 扫描变更日志文件：CHANGELOG.md, HISTORY.md, CHANGES.md 通过后缀识别每个变更日志的语言 语言检测： 模式 语言 CHANGELOG.md（无后缀） en CHANGELOG.zh.md / CHANGELOG_CN.md zh CHANGELOG.ja.md / CHANGELOG_JP.md ja CHANGELOG.{lang}.md 对应语言 输出： 检测到的项目： 版本文件：package.json（1.2.3） 变更日志：CHANGELOG.md（en），CHANGELOG.zh.md（zh） 步骤 2：分析更改 LAST_TAG=$(git tag --sort=-v:refname | head -1) git log ${LAST_TAG}..HEAD --oneline 按约定式提交分类： feat：→ 功能 fix：→ 修复 docs：→ 文档 refactor：→ 重构 perf：→ 性能 chore：→ 跳过变更日志 破坏性变更检测： BREAKING CHANGE 在消息或正文中 删除公共 API，重命名导出 警告破坏性变更： "考虑主版本升级（--major）" 步骤 3：确定版本 优先级：用户标志（--major/--minor/--patch） BREAKING CHANGE → 主版本（1.x.x → 2.0.0） feat：存在 → 次版本（1.2.x → 1.3.0） 否则 → 补丁版本（1.2.3 → 1.2.4） 显示：1.2.3 → 1.3.0 步骤 4：生成变更日志 对于每个变更日志文件： 从文件名识别语言 通过合并的 PR 检测第三方贡献者 以该语言生成内容： 部分标题在目标语言中 日期格式：YYYY-MM-DD 归属：（由 @username）用于非所有者贡献者 插入文件头，保留现有内容 部分标题： 类型 en zh ja feat 功能 新功能 新機能 fix 修复 修复 修正 docs 文档 文档 ドキュメント breaking 破坏性变更 破坏性变更 破壊的変更 格式：## 1.3.0 - 2026-01-22

功能

• 添加用户身份验证（由 @contributor1）
• 支持 OAuth2 登录

修复

• 修复连接池中的内存泄漏

步骤 5：按模块分组（可选） 对于 monorepos，按受影响的技能/模块分组提交： baoyu-cover-image：

• feat：添加新样式选项 → README 更新：选项表

baoyu-comic：

• refactor：改进面板布局 → 无 README 更新

步骤 6：用户确认 显示： 变更日志预览 提议的版本升级 更改摘要 询问：确认版本升级（显示推荐） 推送到远程？（是/否） 步骤 7：创建发布 # 阶段文件 git add CHANGELOG.md # 提交 git commit -m "chore: release v{VERSION}" # 标签 git tag v{VERSION} # 推送（如果确认） git push origin main git push origin v{VERSION} 输出： 发布 v1.3.0 创建。 标签：v1.3.0 状态：推送到 origin 脚本 脚本目的 scripts/prepare_release.py 准备发布，带有版本升级 scripts/release_notes.py 从提交生成发布说明 scripts/roadmap_changelog.py 从路线图生成变更日志 配置（.releaserc.yml） 可选覆盖： 版本： 文件：package.json 路径：$.version 变更日志： 文件：

• 路径：CHANGELOG.md

语言：en

• 路径：CHANGELOG.zh.md

语言：zh 提交： 消息： "chore: release v{version}" 标签： 前缀：v 试运行模式 使用 --dry-run： 显示所有拟议的更改 预览变更日志条目 列出创建的提交 没有实际更改 版本路径 文件路径 package.json $.version pyproject.toml project.version Cargo.toml package.version marketplace.json $.metadata.version VERSION 直接内容 质量标准 良好的发布： 清晰的变更日志条目，描述用户可见的更改 适当的贡献者归属 一致的多语言内容 没有孤立的标签（始终带有提交） 版本升级与更改重要性匹配 永远不要强制推送到 main/master 在推送之前跳过用户确认 创建没有提交的标签 在用户可见的变更日志中包含内部/杂项更改 在没有明确用户同意的情况下推送 将 Co-Authored-By 添加到发布提交（它们是自动的）