| name | release-post-verify |
| description | 在临时目录中用 uvx 或 uv tool run 安装 specify-cn 的 main 分支最新提交,对源码声明支持的 agent 执行 init,并校验版本、中文化、模板完整性、agent 文件落点与 ai-skills 安装结果。用于本地发布后验收。 |
| disable-model-invocation | true |
发布后本地验收
这个 skill 只用于手动触发,不应自动执行。
目标
验证 specify-cn 的 main 分支最新提交是否满足以下条件:
- 安装到的是目标最新版
- CLI 输出仍然是中文
- 对全部支持的 agent 都能成功执行
init
.specify/templates、.specify/memory、脚本目录完整
- agent 命令/工作流/提示文件落在正确位置
--ai-skills 模式下,skills 安装在正确位置且内容基本正确
使用方式
默认全量执行:
python3 .claude/skills/release-post-verify/validate_release_post.py
常用变体:
python3 .claude/skills/release-post-verify/validate_release_post.py --agents claude copilot q
python3 .claude/skills/release-post-verify/validate_release_post.py --keep-temp
python3 .claude/skills/release-post-verify/validate_release_post.py --skip-ai-skills --skip-ps-sample
执行要求
- 先读取脚本输出,不要手工猜测 agent 列表;脚本会从仓库源码中的
AGENT_CONFIG 动态取值。
- 必须通过远端
main 分支最新提交运行,禁止回退到本地源码、本地 wheel 或当前工作区环境:
- 首选
uvx --isolated --from git+https://github.com/linfee/spec-kit-cn@main specify-cn
- 失败时再尝试
uv tool run --isolated --from git+https://github.com/linfee/spec-kit-cn@main specify-cn
- 任何情况下都不能使用
uv run specify-cn、本地 editable 安装、仓库内 wheel 文件或本地路径依赖代替发布包
- 脚本会优先复用现有
GH_TOKEN / GITHUB_TOKEN,否则尝试读取 gh auth token,并自动传给需要访问 GitHub API 的命令。
- 所有初始化必须在临时目录进行,不要把验证产物写回仓库。
- 默认应跑完整轮,即使某个 agent 失败,也继续其余 agent,最后统一汇总。
- 若脚本返回非零退出码,不要宣称验证通过;先根据报告定位失败项。
输出解读
脚本会输出:
- 使用的 runner
- 目标版本
- 临时目录位置
- JSON 报告路径
- 每个 agent 的
normal-init / ai-skills-init / powershell-sample 状态
如果失败,临时目录会自动保留,便于继续排查。
完成时的回复要求
完成后只给用户简短结论,至少包含:
- 是否通过
- 失败的 agent 或失败类别
- 临时目录或报告路径(若失败)