release

name	release
description	Use when preparing, validating, or executing xfyun-coding-proxy releases. Trigger whenever the user wants to cut a version, bump semver, run pnpm release:prepare, align CHANGELOG/package.json/git tags, publish to npm, or create a GitHub Release.
argument-hint	目标版本、发布类型或发布任务，例如 0.0.2、patch、beta 发布
user-invocable	true

xfyun-coding-proxy Release

这个 skill 做什么

把本项目的发布流程收敛成一条可重复执行的工作流：维护 CHANGELOG.md 的 Unreleased 内容、本地准备 release commit 与 tag、触发 npm publish，并让 GitHub Release 正文与 changelog 对齐。

如需查看当前仓库的发布入口与相关文件，请先读 project release files。

如果用户只想做只读检查、不希望任何命令改动仓库状态，请改用 /release-audit。

何时使用

当用户提到以下任一需求时使用：

• “准备发版” / “发一个 npm 版本”
• “帮我 cut release / 发布 prerelease / beta / alpha”
• “帮我跑 pnpm release:prepare”
• “检查 changelog、版本号、tag 是否对齐，然后继续发布”
• “触发 GitHub Release / npm publish 自动化”

核心约束

• 不要依赖本地手动 npm publish 来生成 GitHub Release；本项目的自动 release 依赖推送 tag 后的 GitHub Actions。
• CHANGELOG.md 是 GitHub Release 正文的唯一来源。
• /release 在执行任何会改动仓库状态的发布动作前，应先运行 pnpm release:dry-run <version-or-bump> 并向用户展示预演摘要。
• 如果希望把 dry-run、测试、构建、release:prepare、changelog 校验与可选 push 串成一条命令，可使用 pnpm release:auto <version-or-bump> [--dry-run] [--push] [--yes]。
• pnpm release:prepare <version> 会在目标标题不存在时，把 ## [Unreleased] 内容提升为新版本章节，并把 ## [Unreleased] 重建为固定模板。
• 只有模板、没有真实条目的 Unreleased 视为“空”，必须阻止发版。

标准流程

1. 确认发布目标

   • 判断是显式版本（如 0.0.2、0.0.2-beta.1）还是 npm 语义升级参数（如 patch、minor、prerelease）。
   • 如果需要 GitHub prerelease，最终版本必须包含 -（如 -beta.1、-alpha、-rc.0）。

2. 维护 changelog

   • 优先把发布说明写在 CHANGELOG.md 的 ## [Unreleased] 下。
   • 确保存在真实条目，而不是只有 Added / Changed / Fixed 模板标题。
   • 如果 Unreleased 只有模板标题、没有真实条目，先执行 /changelog-generator 从 git 历史自动生成 changelog 条目，然后再继续发布流程。
   • 如果用户已经手工写好了目标版本标题，也允许直接复用。

3. 先做 dry-run 预演

   • 运行 pnpm release:dry-run <version-or-bump>，或使用 pnpm release:auto <version-or-bump> --dry-run 预演完整本地自动化流程。
   • 向用户汇总：
     • 当前版本 / 目标版本 / 预计 tag；
     • changelog 来源（复用已有版本标题 / 从 Unreleased 提升 / 被阻塞）；
     • release notes 预览；
     • blockers 与下一步建议。
   • 如果 dry-run 已经暴露 blocker，必须先停下，不要继续执行 release:prepare。

4. README 版本号自动同步

   • release:prepare 和 release:auto 脚本会自动将 README.md 中的 当前版本 和 docs/README.en.md 中的 Current version 更新为目标版本号，并将 README 变更包含在 release commit 中。
   • 无需手动更新 README 或 git add。

5. 执行本地准备

   • 可选两条路径：
     • 手动分步：运行 pnpm release:prepare <version-or-bump>；
     • 一条命令自动化：运行 pnpm release:auto <version-or-bump> [--push] [--yes]。
   • 预期行为：
     • 更新 package.json 版本号；
     • 同步 README.md 和 docs/README.en.md 中的版本号；
     • 必要时把 Unreleased 提升为 ## [version] - YYYY-MM-DD；
     • 重建 ## [Unreleased] 模板；
     • 创建本地 commit：；

分支判断

• 目标版本标题已存在：直接复用现有章节，不必再次从 Unreleased 搬运。
• Unreleased 只有模板：必须停止并让用户先补真实发布说明。
• 目标 tag 已存在：必须停止，避免覆盖既有 release。
• 仓库中有无关改动：提醒用户 review；当前脚本只提交 package.json 和 CHANGELOG.md，不会顺手把别的改动打进 release commit。

完成标准

只有满足以下条件，才算这次发布准备或发布工作完成：

• package.json.version、git tag、GitHub Release tag 三者一致；
• CHANGELOG.md 中存在对应版本章节；
• pnpm release:check、pnpm test、pnpm build、git diff --check 全部通过；
• GitHub Actions 发布工作流成功；
• npm 包与 GitHub Release 都已生成且内容正确。

可直接触发这个 skill 的示例

• /release 准备发布 0.0.2
• /release 帮我发布一个 0.0.2-beta.1
• /release 用 patch 规则准备一次本地 release
• /release 看看 changelog、tag 和 npm 发布链路是否对齐后直接继续
• /release 用 pnpm release:auto patch --dry-run 先帮我预演一遍