Rust/RTK filter 开发时用 TDD…

为 RTK 等命令输出过滤器编写 Rust 实现时，用 Red-Green-Refactor、真实 fixture、snapshot 和 token 节省断言驱动开发。

适用场景

解决思路

1. 遵循 Red-Green-Refactor 循环：RED 写失败测试（用真实 fixture），GREEN 写最小实现让测试通过，REFACTOR 清理并确认仍通过，SAVINGS 验证 token 降低 ≥60%，SNAPSHOT 用 insta 锁定输出格式。
2. 先捕获真实 command 输出作为 fixture；不要写合成测试数据。示例：`git log -20 > tests/fixtures/git_log_raw.txt`、`cargo test 2>&1 > tests/fixtures/cargo_test_raw.txt`、`cargo clippy 2>&1 > tests/fixtures/cargo_clippy_raw.txt`、`gh pr view 42 > tests/fixtures/gh_pr_view_raw.txt`。
3. 对带 ANSI codes 的命令按原样捕获：`script -q /dev/null cargo test 2>&1 > tests/fixtures/cargo_test_ansi_raw.txt`。
4. Fixture 命名统一为 `tests/fixtures/<command>_raw.txt`。
5. 在测试模块中实现 `count_tokens(s: &str) -> usize`，用 `s.split_whitespace().count()` 计数。
6. 写输出格式 snapshot 测试：用 `include_str!` 读取 `../tests/fixtures/mycmd_raw.txt`，调用 `filter_mycmd(input)`，用 `insta::assert_snapshot!(output)` 断言。
7. 写 token savings 测试：读取真实 fixture，调用 filter，计算 input_tokens 和 output_tokens，计算 `savings = 100.0 * (1.0 - output_tokens as f64 / input_tokens as f64)`，断言 `savings >= 60.0`，失败消息包含实际百分比和 token 数。
8. 写空输入边界测试：调用 `filter_mycmd` 传入空字符串，断言 `is_ok()`；空输入应返回空输出或原样传递，绝不能 panic。
9. 写畸形输入边界测试：调用 `filter_mycmd` 传入 `not valid command output` 和随机文本，断言 `is_ok()`；不能 panic，应尽力过滤或原样返回输入。
10. 先运行 `cargo test`，确认测试失败（函数尚不存在）。
11. 写最小实现：在 `src/mycmd_cmd.rs` 中引入 `anyhow::{Context, Result}`、`regex::Regex`、`std::sync::LazyLock`。
12. 用 `LazyLock<Regex>` 预编译匹配行首 `^error` 的正则，避免在 filter 函数内重复编译。
13. 实现 `filter_mycmd(input: &str) -> Result<String>`：若 `input.is_empty()` 返回 `Ok(String::new())`；否则按行过滤，只保留匹配 `ERROR_RE` 的行，并用换行符 join 后返回。
14. 运行 `cargo test` 使其变绿。
15. 首次运行 `cargo test test_filter_output_format` 生成 snapshot。
16. 运行 `cargo insta review`，按 `a` 接受 snapshot；snapshot 保存到 `src/snapshots/mycmd_cmd__tests__test_filter_output_format.snap`。
17. 在 `src/main.rs` 接入命令：添加 `mod mycmd_cmd;`，在 `Commands` enum 中加入 `Mycmd(MycmdArgs)`，在 match 中调用 `Commands::Mycmd(args) => mycmd_cmd::run(args)`。
18. 在 `src/mycmd_cmd.rs` 添加 `run(args: MycmdArgs) -> Result<()>`：调用 `execute_command`，命令名为 `mycmd`，参数为 `&args.to_vec()`，并用 `context` 附加上下文 `Failed to execute mycmd`。
19. run 中使用 fallback 模式：`filter_mycmd(&output.stdout).unwrap_or_else`，出错时用 `eprintln!` 打印 `rtk: filter warning:` 和错误 `e`，然后回退为 `output.stdout.clone()`。
20. 调用 `tracking::record` 记录命令名 `mycmd`、原始 stdout 和 filtered。
21. 用 `print!` 输出 filtered；若 `!output.status.success()`，用 `std::process::exit(output.status.code().unwrap_or(1))` 返回退出码。
22. 质量门禁：运行 `cargo fmt --all && cargo clippy --all-targets && cargo test`，三者全过，clippy 零警告。
23. 使用 Arrange-Act-Assert 模式写行为测试：准备输入（如包含 info、error[E0001]、warning 的多行文本），执行 `filter_mycmd`，断言保留 `error[E0001]`，丢弃 `info:` 和 `warning:`。
24. 写 ANSI stripping 测试：输入含 ANSI 转义序列的绿色 `Success` 和红色 `error: failed`，断言输出不包含 ANSI 转义前缀，且仍包含 `error: failed`。
25. 写 fallback 行为测试：输入完全意外的二进制/随机数据，调用 filter，断言 `is_ok()`，不能 panic，返回空或 passthrough。
26. 写多尺寸 savings 测试：构造 1000 行 `info: processing item {i}` 的大输入，调用 filter，计算 savings，断言仍 `>= 60.0`。
27. 完成前检查：`tests/fixtures/<cmd>_raw.txt` 使用真实命令输出。
28. 完成前检查：`filter_<cmd>()` 返回 `Result<String>`。
29. 完成前检查：snapshot 测试通过且已用 `cargo insta review` 接受。
30. 完成前检查：token savings 测试验证 ≥60%。
31. 完成前检查：空输入测试不 panic。
32. 完成前检查：畸形输入测试不 panic。
33. 完成前检查：`run()` 函数包含 fallback 模式。
34. 完成前检查：命令已注册到 `main.rs` 的 `Commands` enum。
35. 完成前检查：`cargo fmt --all && cargo clippy --all-targets && cargo test` 全绿。
36. 禁止使用合成 fixture 数据（例如不要用 `fake error: something went wrong` 代替真实 cargo 输出）。
37. 禁止缺少 savings 测试：不能只断言输出非空而不验证 token 节省。
38. 禁止在生产代码中使用 `unwrap()`（例如 `filter_mycmd(input).unwrap()` 会在生产环境 panic）。
39. 禁止在 filter 函数内部创建正则（例如每次调用都 `Regex::new` 会重新编译）。

适用边界 · 注意事项

• 不适用于非 Rust/Cargo 项目，或未使用 insta、anyhow、regex、LazyLock 等依赖的代码库。
• 不适用于不需要过滤命令输出、也不关心 token 节省的普通功能开发；不必强制 ≥60% token 降低和真实命令 fixture。
• 不适用于无法安全捕获或保存真实命令输出的环境（例如输出包含敏感信息且不能落盘为 fixture）。