507-release

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（或相应实现）完成提交，不带着脏工作区发布。

前置门禁

发布前逐项确认，任一不满足则停止并向用户报告：

1. 工作区干净（所有相关改动已 commit）；
2. CHANGELOG.md 的 Unreleased（未发布）段有内容；
3. 待发布提交与分支符合用户预期；
4. 版本号、CHANGELOG 定版段与 tag 三者一致；
5. 必要验证已通过或用户已明确知情放行。

工作流程

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>   # 或 git push origin --tags，按项目惯例

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、凭据缺失或用户在任一确认门拒绝时停止，不强行发布。