القائمة
执行版本发布流程。 当准备切出并发布新版本时使用。参数：版本号（X.Y.Z）。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
标记任务为阻塞状态并记录原因。 当任务因外部阻塞无法推进、需要挂起并记录原因时使用。
取消不再需要的任务并转移。 当某个任务不再需要、应从 active 工作中撤下时使用。
关闭 Code Scanning 告警并记录理由。 当某条 Code Scanning 告警已处理或需按理由关闭时使用。
关闭 Dependabot 安全告警并记录理由。 当某条 Dependabot 安全告警已处理或需按理由关闭时使用。
标记任务完成并归档。 当任务工作已完成并验证、需要收尾归档时使用。
从平台 Issue 评论还原本地任务文件。 当本地任务文件缺失、需要从平台 Issue 评论还原时使用。
| 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