SuperAPI AI 工具集

implementation

编程与开发

查看项目

更新于 10-16 06:59

技能介绍

该技能用于在开源 Rust/WebAssembly 项目中,按照已批准的架构设计实现生产级代码。其定位是扮演资深软件工程师角色,产出整洁、可维护、经过充分测试的代码。

核心原则:遵循已批准的设计进行实现;没有对应测试就不写代码;代码必须无警告编译且无 linting 问题;所有公共项都要有文档。

主要职责分为四类。代码实现:编写惯用 Rust 代码,遵循项目编码标准,使用合适的错误类型实现错误处理,采用恰当抽象且不过度设计。测试:为所有公共函数编写单元测试,为模块交互编写集成测试,为复杂逻辑编写基于属性的测试,为示例编写文档测试。文档:为所有公共项编写 Rustdoc 注释,在文档中提供示例,编写模块级文档,必要时更新 README。代码质量:通过 cargo clippy 且无警告,通过 cargo fmt 检查,显式处理所有错误情况,生产代码中不使用 unwrap()(测试除外)。

技能提供了实现完成前的检查清单:代码无警告编译;所有 clippy lint 通过;代码已用 rustfmt 格式化;已编写并通过单元测试;适用时编写集成测试;为公共 API 提供文档;错误处理完整;没有未处理的 TODO 注释;必要时更新 CHANGELOG。

在 Rust 模式方面,给出了错误处理示例(库错误用 thiserror,应用用 anyhow)、Builder 模式示例以及异步模式示例(偏好 tokio 运行时,使用 channel 通信)。

技术栈偏好:异步运行时为 tokio;序列化使用 serde 及合适的格式(JSON、MessagePack 等);HTTP 客户端使用 reqwest,服务端使用 axum;CLI 使用带 derive 宏的 clap;日志使用 tracing 生态;测试使用内置测试加 proptest 做属性测试。

代码风格:行长 100 字符;在 impl 块中使用 Self;函数签名偏好显式类型;使用 ? 运算符传播错误;分组导入(std、外部 crate、内部模块);为不应被忽略的返回值函数添加 #[must_use]。

约束:绝不跳过测试;库代码绝不使用 unwrap() 或 expect();绝不静默忽略错误;始终处理所有 match 分支;除非绝对必要避免 unsafe(并记录原因);尽量保持函数少于 50 行。

成功指标:零编译器警告;零 clippy 警告;测试覆盖率大于 80%;所有文档示例可编译;生产代码路径中无 panic。