# OpenAI Codex Rust CLI 代理最佳实践这项技能教您以 OpenAI Codex 代码库的风格编写 Rust 代码 - 一个包含 50 个 crate 和 787 个 Rust 文件的生产 CLI/代理系统。 ## 主要特征 * **2024 年版** 具有严格的 Clippy 配置 * **非测试代码中的零解包/期望**（在工作区级别强制执行） * **Tokio 异步运行时** 具有适当的发送 + 同步范围 * **thiserror** 表示库错误，**anyhow** 表示应用程序代码 * **具有集中依赖关系的扁平工作区**结构 ## 何时申请在以下情况下应用此技能： * 用 Rust 构建 CLI 工具或代理系统 * 使用 Tokio 编写异步 Rust * 设计 Rust 工作区组织 * 实现错误处理模式 * 致力于生产 Rust 代码库 ## 快速参考 ### 关键规则（必须遵守）规则|描述 ---|--- [err-no-unwrap]() |切勿在非测试代码中使用“unwrap()” [err-no-expect]() |避免在库代码中使用“expect()” [err-thiserror-domain]() |使用此错误来处理域错误 [err-context-chain]() |使用 `.context()` 添加错误上下文 ### 错误处理规则|描述 ---|--- [err-anyhow-application]() |无论如何使用::Result 作为入口点 [err-from-derive]() |使用#[from]进行错误转换 [err-transparent]() |使用 #[error(transparent)] 来处理包装错误 [err-structed-variants]() |在错误变体中包含相关数据 [err-io-result]() |对 I/O 函数使用 std::io::Result [err-map-err-conversion]() |使用map_err进行错误转换 [err-doc-errors]() |记录错误情况 ### 组织规则|描述 ---|--- [org-workspace-flat]() |带有 utils 子目录的平面工作区 [org-crate-naming]() | kebab-case目录，项目前缀 [org-module-visibility]() |使用 pub(crate) 作为内部 API [org-test-common-crate]() |共享测试实用程序箱 [org-integration-tests-suite]() |套件目录中的测试 [org-feature-modules]() |基于特征的模块组织 [org-handlers-subdir]() |专用子目录中的处理程序 [org-errors-file]() |专用文件中的错误 ### 组件模式规则|描述 ---|--- [mod-derive-order]() |一致的派生宏排序 [mod-async-trait-macro]() |使用 #[async_trait] 表示异步特征 [mod-trait-bounds]() | Send + Sync + 'static 用于并发特征 [mod-extension-trait-suffix]() |扩展特征的 Ext 后缀 [mod-builder-pattern]() |复杂配置的构建器模式 [mod-type-alias-complex]() |复杂泛型的类型别名 [mod-impl-block-order]() |一致的 impl 块排序 [mod-generic-constraints]() |复杂边界的 where 子句 [mod-newtype-pattern]() |类型安全的新类型 [mod-struct-visibility]() |具有公共构造函数的私有字段 [mod-serde-rename]() | Serde 重命名为有线格式 [mod-jsonschema-derive]() | API 类型的 JsonSchema ### 命名约定规则|描述 ---|--- [name-async-no-suffix]() |异步函数没有 _async 后缀 [name-try-prefix-fallible]() |容易出错的构造函数的 try_ 前缀 [name-with-prefix-builder]() |构建器方法的 with_ 前缀 [name-handler-suffix]() |处理程序的处理程序后缀 [名称错误后缀]() |错误类型的错误后缀 [name-result-type-alias]() |特定于板条箱的结果别名 [name-const-env-var]() |环境常量的 _ENV_VAR 后缀 [name-request-response]() |请求/响应类型配对 [name-options-suffix]() |配置包的选项后缀 [name-info-suffix]() |只读数据的信息后缀 [name-provider-suffix]() |服务的提供商后缀 [名称客户端后缀]() | API 客户端的客户端后缀 [name-manager-suffix]() |生命周期管理的经理后缀 [name-bool-is-prefix]() | is_/has_/should_ 表示布尔值 [name-plural-collections]() |集合的复数名称 ### 风格规则|描述 ---|--- [样式导入粒度]() |每次使用声明一件物品 [style-deny-stdout]() |拒绝库中的 stdout/stderr [style-inline-format-args]() |内联格式参数 [style-module-docs]() |模块级文档 [style-expect-reason]() | #[expect] 存在 lints 的原因 [style-cfg-test-module]() | mod 测试中的单元测试 ### 跨板条箱规则|描述 ---|--- [cross-workspace-lints]() |工作区级别的 lint 配置 [cross-workspace-deps]() |集中依赖版本 ## 示例：正确的错误处理使用这个错误::错误；无论如何使用::Context; // 带有 thiserror 的域错误 #[导出（调试，错误）] pub 枚举配置错误 { #[error("无法读取配置文件：{path}")] 读取失败{ 路径：PathBuf， #[来源] 来源：std::io::错误， }, #[错误（透明）] 解析(#[from] toml::de::Error), } // 库函数返回域错误 pub fn load_config(path: &Path) -> Result { 让内容 = fs::read_to_string(路径) .map_err(|源| ConfigError::ReadFailed { 路径：path.to_owned(), 来源， })?; toml::from_str(&content).map_err(Into::into) } // 应用程序代码使用无论如何与上下文 fn main() -> 无论如何::Result<()> { 让 config = load_config(Path::new("config.toml")) .context("加载配置失败")?; 运行（配置）.await } ## 来源从 [OpenAI Codex]()（`codex-rs/` 子目录）中提取的模式 - 一个包含 50 个板条箱和 787 个 Rust 文件的生产 Rust 代码库。

Rust CLI 代理风格

包含技能