用途：scenarios 用于在真实依赖下做端到端验证，核心原则是“绝不使用 mock”。它适合功能端到端验证、跨服务集成测试、行为证明程序、真实工作流测试、API 契约验证和认证流程验证；不适用于单元测试、mock 测试、性能基准和负载测试。
主要能力：通过真实数据库、真实 API 和真实服务验证实际行为，而非假设。提供 .scratch/ 目录用于编写一次性、自包含、可单命令运行的验证脚本；提供 scenarios.jsonl 记录成功场景模式，每行一个完整 JSON 对象，字段包括 name、description、setup、steps、expected、tags，可选 env 和 duration_ms，用于回归检测、可执行规格说明和测试生成。
使用方式：先确认 .scratch/ 已加入 .gitignore，命令为 grep -q '.scratch/' .gitignore || echo '.scratch/' >> .gitignore。随后按“编写→执行→记录→清理”循环：在 .scratch/ 写证明程序，针对真实依赖运行并断言实际响应，成功则把模式写入 scenarios.jsonl，最后删除脚本或提升为永久测试。脚本命名可用 test-{feature}.ts、debug-{issue}.ts、prove-{behavior}.ts、explore-{api}.ts。
限制与注意：始终使用测试凭据，绝不使用生产数据；必须包含清理阶段；不得提交 .scratch/ 内容；不得使用 mock、stub 或测试替身。若没有 staging 环境、真实依赖成本过高、需要破坏性生产操作或无法获取测试凭据，应升级处理。资料未提供具体安装命令、收费、价格或平台支持信息。