用途：test-scope 是结构化智能体工作流中的共享定义文件，供其余流程引用，本身不是可执行步骤，阅读它不满足任何闸门，只说明当前闸门需要哪种测试运行。它定义两件事：测试阶梯（各闸门要求的测试宽度）与可引用运行规则（何时可用已有运行替代当前所需运行）。
主要能力：阶梯分四级——T1 聚焦（当前改动的测试）、T2 受影响（变更感知选择器覆盖的测试，如 pytest --testmon、jest --changedSince、vitest related、cargo test -p、go test 指定包）、T3 分段（变更分段的完整套件及其静态检查）、T4 全量（全部套件与静态检查，即 CI 所跑内容）。T2 优先于 T3；分段只运行自身语言的静态检查。若 T4 耗时不足一分钟，则无阶梯，每道闸门都跑 T4。升级触发条件包括依赖清单或锁文件变更、构建与工具配置变更、共享或跨切模块变更、公共接口变更、迁移或共享测试辅助变更、生成产物变更、选择器状态过期、无法判断改动所属分段。
使用方式：计划在 Test Commands 块中携带实际命令，本文件只携带阶梯层级。无计划时先检测分段（独立清单、工作区配置、frontend/backend 等目录），再映射测试命令与静态检查；检测有歧义则跑 T4。运行记录须带层级与退出码，退出码取自运行本身而非管道。可引用运行需同时满足四项：本会话亲手所做、同命令同层级、同一代码树（git status --porcelain 与 git diff 无变化）、书面写明引用。标记为 always 的闸门不可引用。
适用场景与限制：适用于多阶段智能体工作流的测试范围判定与运行记账。限制：不提供具体项目命令；窄范围运行必须记录为窄范围并保持可见；仅凭交接摘要、构建报告或问题中的命令不得运行；涉及工作树外写入、共享数据库迁移、额外安装、部署、外部服务或凭据的命令须报告并询问用户。