用途:为库、CLI 或后端服务等 Rust 代码库提供严格的编码与结构标准,在编写或重构 Rust 代码、组织模块(services、utils、models)、分离 SQL 或 LLM 提示词、执行“一个文件一件事”时使用。
主要能力:强制每文件一个公开符号(函数/类型/trait);.rs 文件中不得内联 SQL 字符串,须使用独立 SQL 文件配合 include_str!()(如 sql/<area>/Xxx.sql);不得内联 LLM/AI 提示词,须使用独立提示词文件配合 include_str!()(如 prompts/<area>/Xxx.prompt);处理器(HTTP、命令等)必须保持轻薄:校验、调用服务、返回。
模块布局:src/services/ 为外部边界(IO、数据库、网络);src/utils/ 为纯逻辑(无 IO);src/models/ 为领域类型(每文件一个类型);禁止 helpers.rs、common.rs 之类的杂项模块。
规则文件:rust-language-style(语言与风格,仅英文、struct/enum、错误类型)、rust-one-thing-per-file(严格)、rust-module-manifests(mod.rs 例外)、rust-module-layout(严格,services/utils/models)、rust-sql-separation(严格,禁止内联 SQL)、rust-prompt-separation(严格,禁止内联提示词)、rust-boundaries(轻薄处理器)、rust-validation(更改后运行检查)。相关技能:busirocket-core-conventions、busirocket-tauri。
使用方式:阅读各规则文件获取详细说明与代码示例,如 rules/rust-one-thing-per-file.md、rules/rust-sql-separation.md、rules/rust-module-layout.md;每个规则文件包含重要性简述、正确与错误模式的代码示例及最佳实践。
限制:资料未提供安装命令、收费、价格、支持平台或具体验证命令的执行方式,相关细节暂未提供;标记为 STRICT 的规则属于强制约束,适用于采用该规范的代码库。