用途:以最小但有意义的检查证明被改动的契约,完成必需检查后停止;仅在出现新改动、失败或未解决风险时扩大或重复验证。编写或审查测试时使用 test-audit,不要为可逆的文档或样式改动创建测试。
用法:先阅读受影响范围的 AGENTS.md 与所选测试指南,从仓库根目录运行命令,使用 Node.js 24 或更新版本及仓库锁定的 pnpm 与已安装依赖;不要为验证副作用安装或调整依赖,缺少前置条件就报告。不要运行 npm run precommit。
选择证明:领域或 Driver 行为用 node --test tests/conformance/<name>.test.mjs,必要时扩展到 pnpm test:conformance;API 或控制器行为用 node --test tests/integration/<name>.test.mjs,必要时扩展到 pnpm test:integration;PostgreSQL 持久化用 pnpm test:postgres(需数据库前置条件);Docker 运行时用 pnpm docker:test;Kubernetes 按指定 fixture 或运行时文件;控制台 UI 用 pnpm test:console-browser;类型、包边界、生成的 API 用 pnpm typecheck 与 pnpm openapi:check;文档或技能用 pnpm docs:check、相关链接与 git diff --check;CI 或测试选择用 node scripts/ci/run-tests.mjs audit,并用 actionlint 检查工作流改动。
诊断 CI:使用 gh pr view <pr> --json headRefOid,statusCheckRollup、gh run view <run-id> --json status,conclusion,headSha,url,jobs、gh run view <run-id> --job <job-id> --log,把证据绑定到 PR head、实际运行 SHA、run ID 和 job ID。区分产品、harness、基础设施和凭据四类失败,不要仅凭检查名称推断类别,日志不可得时说明不确定性。
限制:仅使用自有可丢弃资源与授权凭据,不绕过缺失凭据、不关闭隔离、不用假实现替代所需运行时证明;夹具或内存成功不能证明真实网关、Codex WebSocket、模型执行或生产部署。绿 PR 聚合不代表手动带凭据通道已执行。资料未提供收费、价格与平台细节。