项目已经是 Git 仓库，并配置了可访问的远端。
项目已有版本文件或发布约定；没有时可以让 Agent 先给出版本建议。
创建或合并 PR/MR、创建 Forge Release 时，准备好 GitHub、GitLab、Gitea 或 Forgejo 对应的已认证 CLI。只发布 Git tag 时不要求 Forge CLI，但 Git remote 必须可读写。
请求里写清目标版本、基线分支，以及允许执行到哪一步。没有明确授权的远端写操作不会执行。

常见用法

确定下一个版本号

使用 manage-release 检查当前版本和这次改动，建议下一个版本号。只分析，不修改文件。

适合还没决定该发 patch、minor 还是 major 时使用。Agent 会读取项目版本规则、现有 tag 和实际改动，给出建议及依据。

开始开发新版本

使用 manage-release，从 main 为 1.6.0 创建独立 worktree 和分支。先不要 push，也不要创建 PR。

Agent 会检查已有 worktree、分支和 tag，确认没有冲突后准备开发目录。这个请求只授权本地操作。

把开发分支提交为 PR

使用 manage-release 检查当前分支，更新版本号和 CHANGELOG，运行项目测试，然后 push 并创建指向 main 的 PR。不要合并。

适合开发已经完成，只需要整理版本信息并送审。Agent 会停在 PR 创建成功的位置，返回 PR 地址、测试结果和待处理项。

合并通过检查的 PR

使用 manage-release 检查当前 PR。如果 CI、review 和冲突检查都通过，就按项目规则合并；不要打 tag。

Agent 只会在仓库要求全部满足后合并，不会使用管理员权限绕过保护规则。合并完成后会返回准确的 merged commit。

为已合并版本发布 tag

使用 manage-release，为已经合并到 main 的 1.6.0 发布 v1.6.0 tag。确认 tag 指向包含该版本号的 merged commit，不要创建 Forge Release。

适合依靠 Git tag 触发后续 CI 发布的项目。Agent 会分别验证版本文件、目标 commit 和远端 tag，不会给未合并分支打正式 tag。

完成端到端发布

使用 manage-release 完成 1.6.0 发布：从 main 创建 worktree 和分支，完成版本更新和验证，创建 PR，检查通过后合并，推送 v1.6.0 tag，并创建 Forge Release。

这条请求授权完整流程。遇到 review 未通过、CI 失败、版本冲突或已有同名 tag 时， Agent 会停止并说明卡在哪一步，不会绕过检查继续发布。

发布紧急修复版本

使用 manage-release 从 main 准备 1.6.1 hotfix。创建独立 worktree，完成修复后开 PR；检查通过就合并并发布 v1.6.1。

适合线上问题修复。Skill 仍走正常 PR 和保护分支流程，不会因为是 hotfix 就直接推送 main 或覆盖已有 tag。

从中断位置继续

使用 manage-release 检查 v1.6.0 当前发布状态，从尚未完成的步骤继续。不要重复创建分支、PR、tag 或 release。

适合合并后打 tag 失败、tag 已推送但 release 未创建，或者 Agent 会话中断的情况。 Skill 会从 Git 和代码托管平台重新判断状态，再继续缺失的步骤。

Agent 会做什么

Agent 会先发现项目自己的版本、分支和发布规则，再检查本地 Git 与远端状态。它只执行请求中明确授权的阶段，并在合并、tag 或 release 条件不满足时停止。完整流程结束后，结果中会分别列出 worktree、分支、版本、PR/MR、merged commit、tag 和 Forge Release 状态。

如何判断完成

只分析版本时，结果包含建议版本及依据。
创建开发环境时，结果包含 worktree 路径、分支和基线 commit。
创建或合并 PR/MR 时，结果包含 URL、检查状态和 merged commit。
发布 tag 时，远端 tag 解引用后的 commit 与 merged commit 一致。
创建 Forge Release 时，结果包含可访问的 release URL。
中途停止时，结果说明停在哪一步、为什么停止，以及下次如何继续。

不适用的场景

普通功能开发、普通 worktree 或 PR/MR 操作、代码审查、构建 Docker 镜像或上传 DEB 包不需要触发 manage-release。只有任务明确涉及版本发布、发布分支、版本号、发布 PR/MR 或 release tag 时，才交给这个 Skill。