post-releaselisted
Install: claude install-skill fitlab-ai/agent-infra
# 发布后处理
在版本标签推送完成后,执行标准化的发布后收尾流程。
## 执行流程
### 1. 检测最新发布版本
```bash
git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -n 1
```
- 提取最新 `vX.Y.Z` 标签作为刚刚发布的版本,并在后续步骤中去除 `v` 前缀得到版本号
- 如果没有找到标签,报错:"No released version tag found. Please create and push a release tag first."
### 2. 验证工作区干净
```bash
git status --short
```
- 如果存在未提交变更,报错:"Workspace has uncommitted changes. Please commit or stash first."
### 3. 重建项目
```bash
npm run build
```
- demo 录制依赖 `dist/bin/cli.js`,必须先用当前 HEAD 重新编译
- 如果构建失败,停止并先修复编译错误
### 4. 录制执行动图(可选)
```bash
command -v vhs >/dev/null 2>&1
```
- 如果 `vhs` 可用,执行 `npm run demo:regen`
- 此时 `package.json.version` 仍是刚发布的 `vX.Y.Z`,GIF 中 `ai version` 显示的是 released 版本号
- `scripts/demo-regen.sh` 已通过 shim 把 tape 中的 `ai` 命令锁定到本地构建产物,不依赖全局 `ai`
- 如果 `vhs` 不可用,跳过录制并提示用户稍后手动生成演示动图
### 5. 准备下一个开发版本
```bash
npm version prerelease --preid=alpha --no-git-tag-version
npm install --package-lock-only
```
- 读取新的 prerelease 版本号
- 确保 `package.json` 与 `package-lock.json` 的版本保持一致
### 6. 重新生成内联产物
```bash
node scripts/build-inline.js
cp templates/.agents/skills/update-agent-infra/scripts/sync-templates.js \
.agents/skills/update-agent-infra/scripts/sync-templates.js
```
- 版本更新后必须重建内联产物,避免嵌入的默认模板版本号过期
- 如果命令失败,停止并先修复构建问题
### 7. 创建后处理提交
```bash
git add -A
git commit -m "chore: prepare next dev iteration after v{released-version}"
```
### 8. 输出摘要
> **重要**:以下「下一步」中列出的所有 TUI 命令格式必须完整输出,不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI(`customTUIs`)