SuperAPI AI 工具集

rust-best-practices

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:在 Rust 项目中编写、审查、重构或优化代码,包括所有权与借用、错误处理、异步与并发、trait 与泛型、测试、性能、Clippy 和文档。不适用于其他语言。

主要能力:按主题提供参考文档,需要时加载对应文件——编码风格(references/coding-style.md)、错误处理(references/error-handling.md)、所有权与指针(references/ownership-and-pointers.md)、trait 与泛型(references/traits-and-generics.md)、异步与并发(references/async-and-concurrency.md)、同步并发(references/concurrency-sync.md)、测试(references/testing.md)、性能(references/performance.md)、Clippy 与 lint(references/clippy-and-linting.md)、文档(references/documentation.md)。

使用方式:遵循现有 crate 设计、edition、rust-toolchain.toml 与 Cargo.toml 中的 rust-version(MSRV)。示例可能使用较新特性,采用前需确认支持情况,不要仅为模仿示例而升级工具链或添加依赖。只阅读与所改动 Rust 关注点相关的参考;局部修改无需覆盖所有类别、引入新测试框架或做全工作区审计。运行仓库规定的限定范围 format、lint 和 test 命令,并复用有效证据。

工程要点:有意识地借用或转移所有权,需要独立所有权时再 clone。可失败操作使用 Result 并保留错误上下文,panic/断言仅用于程序员不变式被违反的情况,外部输入用可恢复错误校验。错误类型、分发方式和依赖应与现有公共契约一致,thiserror、anyhow、Tokio 及第三方同步 crate 是可选项而非强制。保持锁持有时间短、维持锁顺序,考虑取消、关闭与派生任务的所有权,不要在 .await 期间持有同步锁。把 Send/Sync 约束和原子内存序视为正确性属性,仅在具备有效同步论证时选择更弱的顺序,性能驱动重写前先做基准。行为测试放入拥有该不变式的测试套件,必要时补充类型级、属性、模糊、快照或基准测试。

限制:全工作区/全特性运行和文档覆盖规则以项目政策为准;需检查 crate 实际支持的特性组合。资料未提供具体收费、价格、平台支持与效果数据。