用途:在推送、强制推送、标记分支可评审前,以及任何历史重写之后,运行一次与本次变更相关的本地证据,选择能覆盖该回归的最小检查;完整覆盖与平台矩阵由 CI 负责。
主要能力:先用 git status --short --branch 与 git rev-parse --show-toplevel 确认检出与分支,核对实际基线或栈父级,再检查完整变更范围;优先使用仓库自带的 change-scope 工具(如 pnpm --silent run change-scope --base <verified-base-ref>),否则回退到 git diff --stat。按变更类型选择证据:包或脚本行为跑所属测试文件或聚焦测试名;模型、编辑器、CLI 或终端输出跑聚焦快照或可运行示例;清单、公共导出、构建配置或构建产物路径跑构建、相关卫生检查与产物冒烟;真实提供方或智能体行为在凭据可用时跑相关端到端目标,且不得打印密钥;技能变更跑技能校验器并确认清单列出全部技能;文档或决策记录跑文档检查;双语配对需同步对侧并重录配对;空白与布局用 git diff --check。单元覆盖需同时指定所属测试与需证明覆盖的源文件或包,例如 pnpm exec vitest run ... --coverage --coverage.include='...';依赖图发现看不到仅经配置、动态加载、子进程、worker、构建产物或外部提供方到达的行为,需显式选择。
使用方式:普通推送与独立 rebase 推送先运行所选检查一次,正常提交并检查预提交修复器改动的文件,再推送;重写分支用 --force-with-lease=<branch>:<observed-oid>,禁止裸 --force。推送后核对 git rev-parse HEAD origin/$(git branch --show-current),GitHub PR 用 gh pr checks 查看 CI。栈同步工具(如 gh stack sync)无法在重写与发布间插入本地验证,需先要求干净工作树并记录官方栈顺序与远端头,返回后重新查询各分支头与栈顺序、检查每层变更范围并运行所选证据,全部通过前保持 PR 未合并。
适用场景:推送前、历史重写后、栈同步后、诊断 CI 失败时。
限制:没有通用本地基线;仅当用户明确要求、诊断 CI 失败或变更横跨整个仓库时才跑完整本地预演;不得用 --passWithNoTests、降低覆盖率阈值或收窄 --coverage.include 来掩盖未覆盖文件;环境相关失败需记录确切命令、失败测试与平台差异,绕过本地检查须用户明确同意。资料未提供具体仓库配置、凭据要求或价格信息。