用途:对已完成的 Rust 代码做深度质量审查,检查惯用法与潜在缺陷。它不负责路由任务,也不负责修复编译错误,编译通过不等于审查通过。
主要能力:按固定顺序执行六道关卡——机械检查(cargo clippy --all-targets --all-features -- -D warnings 与 cargo fmt --all --check)、命名检查(对照 Rust API Guidelines 大小写表,含 as_/to_/into_ 前缀与 getter 无 get_ 前缀)、错误处理检查(逐个审查 .unwrap()/.expect()/panic!)、async 检查(阻塞调用、跨 .await 持锁、Send 约束)、内存检查(Arc<Mutex<T>>、RwLock、RefCell、.clone() 是否合适)、抑制检查(#[allow] 需理由,推荐 #[expect]),最后输出结构化结论。
关键规则:clippy 的 correctness 与 suspicious 应阻断,style/complexity/perf 可要求修改,pedantic/nursery/restriction/cargo 仅作建议;不建议整组启用 clippy::restriction。测试代码中的 panic 可接受;库代码可失败路径应返回 Result。async 中禁止阻塞调用与跨 await 持锁,spawn 的 future 需 Send + 'static。单值共享状态优先原子类型,读多写少优先 RwLock。禁止 crate 级 #![allow(clippy::all)]。
适用场景:审查 Rust 代码、判断是否惯用、查找代码异味,或在批准 Rust PR 前使用。
限制:仅审查,不路由、不修编译错误;具体命令、结论模板与示例见其 references 文件。其他细节暂未提供。