用途:该技能用于从 v2 分支发布 context-mode v2,流程遵循 ADR-0013。启动该技能即视为对本次发布的批准;第 6 步的预览仅用于信息展示,不构成第二次批准。
主要流程与能力:
- 检查起始状态:运行 git branch --show-current 与 git status --porcelain,分支必须为 v2 且工作树干净,否则停止并报告哪些内容处于脏状态;再运行 gh auth status 与 git pull --ff-only。
- 运行 E2E 用例:node e2e/cases/run.mjs。若有行显示 FAIL,停止并报告失败的用例 id。
- 运行 v1 KEEP-PASS 单元测试(GS4):npm ci 仅安装开发工具链(依据 ADR-0013“信任边界”),用户从不运行 npm;随后运行 npx vitest run。若 131 项跟踪测试中有失败,停止并显示其名称。
- 运行实时测试: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)或以上,拒绝继续,并报告哪些用例被跳过及每行的说明。
- v1 迁移检查点(GS10):用例 e2e/live/cases/v1-migration-*.json 已在第 4 步运行(其 covers 路径包含 v1-transition,因此 --all 会选中它们),不要再次运行;确认每个用例在第 4 步表格中为 PASS,否则停止。
- 预览:运行 node scripts/release/plan.mjs --dry-run,向负责人展示下一版本号与发布说明;若提示无内容可发布,则停止。
- 启动发布:gh workflow run release.yml --ref v2 -f sha=$(git rev-parse HEAD)。
- 用 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;每一项都需单独询问负责人。