gm-complete 是 gm-skill 体系中的 VERIFY / COMPLETE 阶段,目标是把“完成”作为可验证的状态而非声明。它有三项前置条件:git 工作区干净、已推送到远端、CI 绿灯;缺少任一项即视为该阶段未结束。
主要能力包括:
- CI 即构建。对 Rust crates(rs-exec、rs-codeinsight、rs-search、rs-learn、rs-plugkit)及 gm 发布链,git push 会触发覆盖六个目标平台的构建矩阵;本地 cargo build 与 cargo test 不运行,因为本地只覆盖单一平台,无法证明其余平台。推送、观察 CI、在红灯时修复,工具链不匹配与 rustc 偏差不阻塞推送。
- 观察协议:推送后轮询 gh run list --branch <branch> --limit 3 --json status,conclusion,name,直到运行结束,最长 GM_CI_WATCH_SECS(默认 180 秒)。红灯时按失败形态分流(导入错误查 manifest;类型错误回退 PLAN;测试失败查根因;lint 就地修复;构建超时重试一次,否则标记 PRD blockedBy: external)。修复根因后推送并重新观察。CI 绿灯是 VERIFY 进入 UPDATE-DOCS 的前提。
- 单一集成测试:项目根目录一个 test.js,硬上限 200 行,不用 fixtures、mock,不分散测试文件;由 gm-complete 运行,失败即回归 EXECUTE。编辑时优先压缩而非扩张。
- 残余扫描门:允许转入 update-docs 前触发 residual-scan。PRD 为空是必要但不充分条件,该门追问“本应决策但未做”的事项,或重新进入规划并追加执行,或明确声明“residual scan: none reachable in-spirit”。.gm/residual-check-fired 标记使其在每个停止窗口一次性生效。
- Git 门:git status 干净、git log 显示提交已推送、gh run list 显示该分支最近一次运行绿灯,三者齐备才转场。
使用方式:通过 phase-status、transition、residual-scan 调度;CI 观察经 in/bash/ 缓冲以遵循时间预算。转场规则:残余扫描通过且 git 干净且 CI 绿灯,则 Skill(skill="gm:update-docs");否则按缺口 Skill(skill="gm:planning") 或 Skill(skill="gm:gm-execute")。
限制:资料未提供该技能的安装方式、收费、平台支持范围之外的细节或具体配置选项。