SuperAPI AI 工具集

release

部署与运维

查看项目

更新于 11-04 18:48

技能介绍

用途:该技能用于从 v2 分支发布 context-mode v2,流程遵循 ADR-0013。启动该技能即视为对本次发布的批准;第 6 步的预览仅用于信息展示,不构成第二次批准。

主要流程与能力:

  1. 检查起始状态:运行 git branch --show-current 与 git status --porcelain,分支必须为 v2 且工作树干净,否则停止并报告哪些内容处于脏状态;再运行 gh auth status 与 git pull --ff-only。
  2. 运行 E2E 用例:node e2e/cases/run.mjs。若有行显示 FAIL,停止并报告失败的用例 id。
  3. 运行 v1 KEEP-PASS 单元测试(GS4):npm ci 仅安装开发工具链(依据 ADR-0013“信任边界”),用户从不运行 npm;随后运行 npx vitest run。若 131 项跟踪测试中有失败,停止并显示其名称。
  4. 运行实时测试:node e2e/live/run.mjs --all(Sonnet 5,effort low,ADR-0017)并显示其表格;若有行显示 FAIL 则停止。随后更新 e2e/live/skip-streak.json 中的 live-skip 连续计数(格式 { "streak": <n> }):若表格中有一行或多行 SKIPPED,则 streak 加 1;若没有,则重置为 0。若文件发生变化,在 v2 上提交并推送。若 streak 达到 LIVE_SKIP_LIMIT(3)或以上,拒绝继续,并报告哪些用例被跳过及每行的说明。
  5. v1 迁移检查点(GS10):用例 e2e/live/cases/v1-migration-*.json 已在第 4 步运行(其 covers 路径包含 v1-transition,因此 --all 会选中它们),不要再次运行;确认每个用例在第 4 步表格中为 PASS,否则停止。
  6. 预览:运行 node scripts/release/plan.mjs --dry-run,向负责人展示下一版本号与发布说明;若提示无内容可发布,则停止。
  7. 启动发布:gh workflow run release.yml --ref v2 -f sha=$(git rev-parse HEAD)。
  8. 用 gh run watch 跟踪新运行,并在任务状态变化时报告;结束时以一张简表报告:版本、release 上的发布提交、GitHub Release 链接、实时测试(通过或跳过)、各 agent 的冒烟安装结果。

失败处理:在第一个失败的步骤停止并报告,不得改用其他方法重试失败步骤。

skip-live 选项:若负责人输入 /release skip-live,则跳过第 4 步和第 5 步(streak 文件不变),并在第 6 步运行 node scripts/release/plan.mjs --dry-run --skip-live,使发布说明包含“Live E2E skipped for this release.”一行;最终报告中说明实时测试已跳过。

限制:该技能从不执行以下一次性步骤:将 marketplace 切换到 ref: "release"、向 main 添加工作流、npm deprecate;每一项都需单独询问负责人。