用途
backend-rust 是一个 Rust 后端开发技能包,面向使用 Axum、SQLx、tokio 构建现代 Rust 后端服务的场景。资料描述其用途为:构建 Rust API、高性能服务,或需要构建/测试/lint/审计自动化时使用。
主要能力
- 项目保护设置:要求在写任何代码前执行,包括创建 .gitignore(忽略 target/、Cargo.lock、IDE 目录、.env、密钥文件等)、检查并安装 pre-commit、生成 .pre-commit-config.yaml(含 trailing-whitespace、end-of-file-fixer、check-added-large-files、detect-private-key、gitleaks 等钩子)、安装钩子并验证。资料说明其目的是防止误提交 target/(2GB+)、密钥与凭据。
- 技术栈参考:提供 testing.md(axum-test、mockall、异步测试)、ci-cd.md(GitHub Actions、Docker、缓存)、cross-compile.md(目标、musl、静态二进制)等参考文档。
- 自动化脚本:build.py(构建 debug/release)、test.py(测试+覆盖率)、lint.py(格式化+clippy)、audit.py(安全审计)、check.py(完整 CI 检查)。脚本自动检测 Cargo.toml,可用 --path 指定位置。
- 工具链:Axum(Web 框架)、SQLx(数据库,编译期检查查询)、tokio(异步运行时)、serde(序列化)、tracing(日志)、Shuttle(部署)。
- 依赖管理:强调添加依赖前用 Context7 检查最新 crate 版本,并说明技能中的版本仅为示例,需通过 Context7 或 crates.io 验证。
- 项目设置:要求 Rust 1.85+(支持 edition 2024),新项目使用 edition = "2024"。给出 Cargo.toml 依赖示例与项目目录结构。
- Axum 模式:基础应用、App State(FromRef)、带提取器的处理器、请求/响应类型、错误处理(thiserror + IntoResponse)。
- SQLx 模式:数据库连接池、迁移、编译期检查查询、事务。
- 配置与中间件:Config 从环境变量加载、auth_middleware 示例。
- 构建与 CI 工作流:完整 CI 检查、单独步骤、交叉编译静态二进制。
- TDD 工作流:tdd-test-writer 写失败测试(RED)、rust-developer 实现(GREEN+自审)、code-reviewer 最终审查;可启用 TDD 强制钩子(tdd_gate.py)。
- 审查清单:逻辑正确性、安全性、错误处理、模式遵循、测试覆盖。
- 反模式对照:如处理器中避免 unwrap()、避免到处 clone()、避免原始 SQL 字符串、避免 println!、避免异步中阻塞代码、避免手动 JSON。
使用方式
资料给出的使用方式包括:在新项目上先执行项目保护设置步骤;通过 python scripts/check.py 做完整 CI 检查,或分别运行 lint.py --fix、test.py、audit.py、build.py --release;交叉编译使用 python scripts/build.py --release --target x86_64-unknown-linux-musl;TDD 流程按 RED→GREEN→REVIEW→COMMIT 循环,并可通过 .claude/settings.json 配置 PreToolUse 钩子调用 tdd_gate.py。
适用场景
适用于构建 Rust API、高性能服务,以及需要构建、测试、lint、审计自动化的 Rust 后端项目。
限制
资料未提供该技能的收费、价格、平台支持范围、性能效果等具体信息,暂未提供。技能中列出的依赖版本为示例,需自行验证最新版本。