用途:在编写、审查或修改 Rust 代码时提供惯用模式、错误处理、类型安全与社区规范参考,按当前任务加载对应主题文档。
主要能力:按场景索引参考文件,例如创建类型或出现 String/i32 时加载 references/type-safety.md;处理 .unwrap()/.expect() 时加载 references/error-handling.md;bool 参数与枚举设计加载 references/enum-design.md;公共 API、builder、trait 实现加载 references/api-design.md;Clippy 与 lint 配置加载 references/clippy-config.md;模块组织与纯逻辑/IO 分离加载 references/fcis.md;异步、tokio、通道、超时加载 references/async.md;生命周期加载 references/lifetimes.md;unsafe/FFI 加载 references/unsafe.md;Send/Sync 加载 references/send-sync.md;Serde 加载 references/serde.md;测试加载 references/testing.md;文档加载 references/writing-docs.md;查找 crate 文档加载 references/finding-docs.md。另提供错误信息到参考文件的映射,如“future cannot be sent between threads safely”对应 send-sync 与 async。
核心原则:优先用 newtype 而非原始类型;库用 thiserror、应用用 color_eyre;.expect() 仅用于初始化,生产运行代码不用 .unwrap()/.expect();用枚举替代 bool;让非法状态不可表示;在构造时校验(TryFrom/newtype);纯逻辑与 IO 分离(FCIS);最小可见性,优先 pub(super)/pub(crate)。
限制:资料未提供安装命令、收费、价格、平台或具体使用步骤;内容为参考指南,不替代编译器与 Clippy 的实际检查。