Menu
执行版本发布流程。 当准备切出并发布新版本时使用。参数：版本号（X.Y.Z）。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | release |
| description | 执行版本发布流程。 当准备切出并发布新版本时使用。参数：版本号（X.Y.Z）。 |
执行指定版本的版本发布流程。
从参数中提取版本。必须匹配 X.Y.Z 格式。
解析组件：
X.Y.Z如果格式无效，报错："Version format incorrect, expected X.Y.Z (e.g. 1.2.3)"
git status --short
如果有未提交的变更，报错："Workspace has uncommitted changes. Please commit or stash first."
先执行 entropy-check 技能，记录报告路径，并检查是否存在 release-blocking 发现：
Claude Code / OpenCode：/entropy-check
Gemini CLI：/agent-infra:entropy-check
Codex CLI：$entropy-check
如果 entropy-check 执行失败，或报告中存在未处理的 release-blocking 发现，停止发布流程并先处理或由维护者裁定。
git branch --show-current
npm test
验证要求：
entropy-check 并记录报告路径main处理规则：
entropy-check 失败或发现 release-blocking 问题，报错退出并要求先处理main，输出警告但继续执行（某些维护场景可能需要从其他分支发布）更新以下文件中的版本号：
package.json 中的 "version": "X.Y.Z".agents/.airc.json 中的 "templateVersion": "vX.Y.Z"SECURITY.md 中的支持版本表格（v{MAJOR}.{MINOR}.x | Supported，< v{MAJOR}.{MINOR}.0 | Not Supported）SECURITY.zh-CN.md 中的支持版本表格（v{MAJOR}.{MINOR}.x | 支持中，< v{MAJOR}.{MINOR}.0 | 不再支持）npm install --package-lock-only，同步 package-lock.json 中的版本号如果当前工作区处于开发期 prerelease 版本（例如 0.1.0-alpha.1），也需要将其替换为目标正式版本 X.Y.Z。
使用搜索确认旧版本号（包含可能的 prerelease 后缀）无遗漏，使用编辑工具更新。
更新 package.json 后执行 npm install --package-lock-only，确保锁文件版本与 package.json 保持同步。
排除以下目录的版本替换：
.agents/、.agents/workspace/、.claude/、.codex/、.gemini/、.opencode/（AI 工具配置）node scripts/build-inline.js
执行要求：
sync-templates.js 内嵌的版本号与默认配置保持最新cp templates/.agents/skills/update-agent-infra/scripts/sync-templates.js \
.agents/skills/update-agent-infra/scripts/sync-templates.js
git add -A
git commit -m "chore: release v{version}"
git tag v{version}
为已发布版本关闭对应版本里程碑，并为下一轮创建缺失的规划里程碑。
执行：
bash .agents/skills/release/scripts/manage-milestones.sh "$MAJOR" "$MINOR" "$PATCH"
脚本负责：
.agents/rules/label-milestone-setup.md{MAJOR}.{MINOR}.{PATCH} 存在且仍为开启状态时将其关闭{MAJOR}.{MINOR}.{PATCH+1} 与 {MAJOR}.{MINOR}.x 存在PATCH=0 时，同时确保 {MAJOR}.{MINOR+1}.0 与 {MAJOR}.{MINOR+1}.x重要：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果
.agents/.airc.json中配置了自定义 TUI（customTUIs），读取每个工具的name和invoke，按同样格式补充对应命令行（${skillName}替换为技能名，${projectName}替换为项目名）。
版本 v{version} 已准备好发布。
发布信息：
- 版本：{version}
- 发布提交：{commit-hash}
- 标签：v{version}
已更新文件数：{数量}
下一步（手动执行）：
1. 推送分支：
git push origin {current-branch}
2. 推送标签：
git push origin v{version}
推送后将自动触发 release 创建和 npm 发布
3.（可选）生成发布说明：
- Claude Code / OpenCode：/create-release-note {version}
- Gemini CLI：/agent-infra:create-release-note {version}
- Codex CLI：$create-release-note {version}
4.（可选）执行发布后处理：
- Claude Code / OpenCode：/post-release
- Gemini CLI：/agent-infra:post-release
- Codex CLI：$post-release
如果出了问题：
# 删除标签
git tag -d v{version}
# 重置提交
git reset --soft HEAD~1
# 恢复文件
git checkout -- .
npm testnode scripts/build-inline.js，否则嵌入的版本号和默认配置会过期npm publish；发布凭证由 CI OIDC + npm Trusted Publishing 自动提供（一次性维护者配置见 RELEASING.md 的 Trusted Publisher 章节），无需配置长期 NPM_TOKENinit-milestones标记任务为阻塞状态并记录原因。 当任务因外部阻塞无法推进、需要挂起并记录原因时使用。
取消不再需要的任务并转移。 当某个任务不再需要、应从 active 工作中撤下时使用。
关闭 Code Scanning 告警并记录理由。 当某条 Code Scanning 告警已处理或需按理由关闭时使用。
关闭 Dependabot 安全告警并记录理由。 当某条 Dependabot 安全告警已处理或需按理由关闭时使用。
标记任务完成并归档。 当任务工作已完成并验证、需要收尾归档时使用。
从平台 Issue 评论还原本地任务文件。 当本地任务文件缺失、需要从平台 Issue 评论还原时使用。