SuperAPI AI 工具集

rust-cli-agent-style

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能用于指导以 OpenAI Codex 代码库风格编写 Rust,适用于构建 CLI 工具或智能体系统、编写 Tokio 异步 Rust、设计工作区组织与错误处理的生产级代码。

主要能力与规则要点:非测试代码禁止 unwrap(),库代码避免 expect();领域错误用 thiserror,入口点用 anyhow::Result,配合 .context() 添加错误上下文,用 #[from] 做错误转换、#[error(transparent)] 包装错误;I/O 函数使用 std::io::Result。组织上采用扁平工作区并在 utils 子目录,目录用 kebab-case 加项目前缀,内部 API 用 pub(crate),测试放入 suite 目录并共享测试工具 crate。组件模式包括一致的 derive 顺序、#[async_trait]、并发 trait 的 Send + Sync + 'static 约束、扩展 trait 用 Ext 后缀、复杂配置用 builder 模式、newtype 保证类型安全、serde rename 与 JsonSchema 派生。命名约定包括:异步函数不加 async 后缀、可失败构造器用 try 前缀、builder 方法用 with_ 前缀、错误类型加 Error 后缀、布尔用 is_/has_/should_ 前缀、集合用复数名等。风格方面要求每个 use 语句只导入一项、库中禁止 stdout/stderr、内联格式化参数、模块级文档、#[expect] 附原因、单元测试放在 mod tests 中。跨 crate 采用工作区级 lint 配置与集中式依赖版本。

使用方式与限制:资料未提供该技能的安装命令、触发方式或具体落地步骤;示例仅展示 thiserror 与 anyhow 的错误处理写法。适用前提是项目采用 Edition 2024、Tokio 与 Clippy 严格配置。资料未说明是否有偿、支持平台或版本范围。