SuperAPI AI 工具集

turon-api-design

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能用于以 Aaron Turon(前 Rust 团队负责人)的风格编写 Rust 代码,重点在 API 设计、异步 Rust 和生态架构,适合在设计公共 API 时使用。

主要能力:提供一套设计原则与代码模式,包括用户优先设计(先写期望的调用代码再反推 API)、成功之坑(让正确用法容易、错误用法困难)、一致性(遵循 Rust 惯例)、异步对等(异步代码尽量镜像同步代码)。涵盖构建器模式、类型状态模式、扩展 trait、标准 trait 实现等。

使用方式:资料给出若干代码模式示例,如用构建器实现链式请求、用类型状态在编译期约束状态机顺序、用 async fn 与 impl Future 设计异步接口、用扩展 trait 为外部类型添加方法、实现 Debug/Clone/Default/Display 等标准 trait。命名遵循 new、with_、into_、as_、to_、is_、_mut 等惯例。

适用场景:设计 Rust 公共 API、异步库、状态机接口,或希望代码符合 Rust API Guidelines 时。

限制:资料未提供安装命令、平台支持、收费信息或具体使用步骤;内容为风格指南与示例,实际效果取决于项目上下文。