用途:为 Rust crate 的新增或变更行为提供一套测试驱动开发(TDD)执行流程,适用于模块旁的单元测试;tests/ 目录仅用于公共 API 契约测试。
主要能力与阶段:
- 上下文与 RED:若 crate 已存在则加载上下文(load-context),编写最小的失败测试,运行 cargo test <test_name> -- --exact。
- HITL 与 GREEN:展示实际测试与失败信息,除非任务已授予实现权限,否则等待用户明确批准;仅在已接受范围内实现,反复运行直至通过。
- 重构:保持行为不变,每步后重新运行测试。
- 质量门:运行 cargo fmt --check、cargo clippy --all-targets -- -D warnings、cargo test。
硬性约束:在测试存在、已运行且因行为缺失而失败之前,不得进行实现;测试因编译噪音失败时需先修复测试并停留在 RED。实现需等待用户明确批准,除非任务已授予实现权限。
验证要点:RED 失败原因是行为缺失;用户已同意实现;目标测试 GREEN;fmt/clippy/test 退出码为 0。
错误恢复:测试不编译则修复测试并保持 RED;实现后仍红则做最小修复,若方法或范围变化需重新批准;重构变红则回退上一步;Clippy 报错需修复,不得用 #[allow] 跳过质量门。
集成:GREEN 阶段按需使用 type-driven-design、error-handling、ownership-borrowing,且不可跳过 rust-essentials。
输出格式为 TDD Report,包含行为、测试路径与名称、RED 命令与原因、是否批准、GREEN 命令、质量检查结果及跳过项。
限制:资料未提供具体安装命令、收费信息或平台支持范围;使用前需先应用执行契约(execution contract)。