| name | 507-release |
| description | 对外发布：在用户明确要求发布、推送或发版时，定版本号、打 tag、推送远端，并按项目实际探测的发布渠道（npm、GitHub Release）发布。每个不可逆对外动作执行前都向用户显式确认。Use when user says release, publish, push, 发版, 发布, 推送, 发包, 打 tag, 升版本, 升级版本号, 发新版本, 上线, 发到 npm, 发 GitHub Release。默认只做用户明确点名的对外动作，不自动扩到全部渠道。 |
对外发布（release）
把已完成的本地提交推向外部：定版本号、打 tag、推送远端，并按项目实际探测到的发布渠道发布。它和 507-commit 的分界是可逆性——commit 停在可逆的本地提交，release 才触碰基本不可逆的对外动作（远端、公开包、公开 Release）。
安全边界
- 本 skill 只在用户明确要求发布、推送或发版时使用；
- 版本号决定权归用户：用户明确指定时直接用；未指定时显性询问用户选
patch / minor / major 或给具体号；用户给出"升一个版本号"这类半模糊指令时，按 semver（语义化版本）原则据 CHANGELOG 变更类型补全具体位；
- 每个不可逆对外动作执行前都向用户显式确认：push、npm publish、GitHub Release 各是一道确认门，未经确认不执行；
- 不自动扩到用户没有点名的渠道；探测到的渠道逐个向用户确认后再发布；
- 不执行
git push --force（强制推送）到主干；
- 发布渠道的凭据、令牌和密钥不写入仓库或日志。
与 commit 的边界
507-commit 产出本地提交；本 skill 从"版本号已定、本地提交已就绪"开始。工作区仍有未提交改动时，先回到 507-commit（或相应实现）完成提交，不带着脏工作区发布。
前置门禁
发布前逐项确认，任一不满足则停止并向用户报告：
- 工作区干净（所有相关改动已 commit）；
CHANGELOG.md 的 Unreleased（未发布）段有内容；- 待发布提交与分支符合用户预期；
- 版本号、
CHANGELOG 定版段与 tag 三者一致；
- 必要验证已通过或用户已明确知情放行。
工作流程
1. 定版本号
- 读取当前最新 tag 与
CHANGELOG 顶部版本段，确认起点版本；
- 按安全边界确认目标版本号：用户明确指定则用；未指定则显性询问；半模糊指令按 semver 据
Unreleased 内容补全（仅缺陷修复/文档 → patch，向后兼容的新功能 → minor，有 Breaking（破坏性变更）→ major）；
- 把
CHANGELOG 的 Unreleased 段迁移为 ## [x.y.z] - YYYY-MM-DD，保留段内分类与条目；
- 项目存在版本号 manifest（如
package.json 的 version）时，同步更新到同一版本号。
2. 创建定版提交
将版本定版改动（CHANGELOG 迁移、manifest 版本号等）精确暂存，创建一个定版提交，遵循项目既有提交规范。
3. 打 tag
按项目惯例打 tag，默认 v<x.y.z>（如 v0.2.2），指向定版提交。
4. 推送远端（确认门）
向用户显式确认后，把定版提交与 tag 一并推送到远端：
git push origin <branch>
git push origin <x.y.z>
push 被 reject（远端有新提交）时停止，报告冲突，不自动 --force 或 --rebase，交用户处理。
5. 发布渠道（探测 + 确认门，按需）
逐个探测项目实际的发布渠道；每个渠道执行前都向用户显式确认。用户没有点名或不同意时跳过该渠道，不静默发布。
npm
- 探测条件：仓库根存在
package.json；
- 确认后执行
npm publish（预发布版本按项目惯例用 npm publish --tag 打 dist-tag）；
- 未登录或凭据缺失时停止并报告，不把凭据写入任何文件。
GitHub Release
- 探测条件：git remote 指向 GitHub 且
gh（GitHub CLI）可用；
- release notes 默认从
CHANGELOG 对应版本段提取，不另行编造；
- 确认后用
gh release create <tag> --notes "..." 创建，预发布版本加 --prerelease。
其它发布渠道（容器镜像、二进制产物等）由用户点名时按对应工具执行；本 skill 不预置全部渠道清单。
失败处理
- 任何步骤失败即停，不自动回滚已完成的动作；
- 报告失败发生点、已成功完成的动作（如"tag 已推上、npm 未发"）和未完成项；
- 由用户决定是否补发、撤销或修复后重试。
完成与接力
- 完成信号：用户点名的全部对外动作已执行并确认成功（如 tag 已推、npm 已发、Release 已建），各渠道状态已报告。
- 产物：版本定版提交、tag、推送结果、各渠道发布链接或结果；失败时为失败点和已完成动作清单。
- 候选出口：发布内容本身有问题时进入
507-fix；发布前需要交付审查时进入 507-review；发布完成后通常直接结束。
- 回退条件：前置门禁不满足、push 被远端 reject、凭据缺失或用户在任一确认门拒绝时停止，不强行发布。
