用途:在快速 TDD 开发中,只针对一个测试文件运行测试,并以 fail-fast 模式在首次失败时立刻停止,尽量缩短等待反馈的时间。适用于反复修改某个已知失败的 spec、需要进入 headed/debug 可视化调试、或 WebGL/共享状态测试需强制串行执行的场景;不适用于跑全量测试套件、多文件 watch 模式或批量分析测试结果目录。
主要能力:运行单个测试文件或模式(如 login.spec.ts、tests/e2e/auth.spec.ts);自动检测测试框架并构造命令;支持 --serial 强制单 worker 串行执行,支持 --debug 进入调试/有头模式。检测依据项目根目录的 pyproject.toml、package.json、Cargo.toml、go.mod,以及 playwright.config.、vitest.config./vite.config.、jest.config. 等配置文件。
使用方式:提供必填参数 $1 作为测试文件路径或模式,可选 --serial 与 --debug。各框架命令如下:Playwright 使用 bunx playwright test "$FILE" --max-failures=1 --reporter=line,加 --serial 时追加 --workers=1,加 --debug 时使用 --headed --debug;Vitest 使用 bunx vitest run "$FILE" --bail=1 --reporter=dot,串行时追加 --pool=forks --poolOptions.threads.singleThread,调试时用 --inspect-brk;Jest 使用 bunx jest "$FILE" --bail --silent,串行追加 --runInBand,调试用 --bail --runInBand;pytest 使用 python -m pytest "$FILE" -x -v --tb=short,调试用 --tb=long -s;cargo 使用 cargo test --test "$FILE" -- --test-threads=1,调试追加 --nocapture;go 使用 go test -v -failfast "$FILE",调试追加 -count=1。
输出与处理:测试通过输出 PASSED 与耗时;失败则显示首个失败测试名、简要错误和 file:line,并给出重跑命令 /test:focus $FILE。文件不存在时用 glob 列出相似测试文件,未检测到框架时列出包含 test 的 package.json 脚本,超时时建议 --serial 或增大超时。
限制:资料未提供安装方式、收费、平台支持与具体性能数据;资料也明确不覆盖全量测试、多文件 watch、结果目录分诊和测试层级选择,这些应使用其他对应技能。