BeautifulRust 是什么:教编程 Agent 写地道 Rust

让编程 Agent 写 Rust,代码多半能编译,可 熟悉 Rust 的人一看就皱眉:字段全公开、到处 unwrap()、为了躲借用检查器满屏 clone()。BeautifulRust 是一套 MIT 开源的 Agent Skills,把五份主流 Rust 风格指南浓缩成 Agent 能边写边查的规则,再配一份 clippy 配置在 CI 里把关。这篇按官方 README、更新日志和隐私说明(截至 2026-11-20 的 v1.6.0),讲它包含什么、怎么装到不同的 Agent。
它是什么
BeautifulRust 是教编程 Agent 写、审、迁移地道 Rust 的一组 Skill,规则来自 Google Rust 风格指南、Rust 官方 API Guidelines、《Effective Rust》、Rust Design Patterns 和微软的 Pragmatic Rust Guidelines。几份资料说法冲突时,Skill 会选一边并写明理由。
| 仓库 | github.com/morganlinton/BeautifulRust |
|---|---|
| 作者 | Morgan Linton |
| 许可证 | MIT |
| 热度 | GitHub 2,074 星、98 fork(GitHub API);skills.sh 三个 Skill 合计安装 3.2K 次(均为 2026-11-20 北京时间) |
| 组成 / 要求 | Markdown 指令与参考摘要 + clippy 配置;用 npx skills 安装要 Node.js 22.20+,审查和迁移最好本机装有 Rust 工具链 |
| 最新版本 | v1.6.0(2026-11-08 23:50 北京时间打 tag) |
解决什么问题
README 举了个例子:同一个 Agent 写一个小型语义化版本解析库,没装 Skill 时字段全部公开、没有 # Errors 文档、文档示例里用 unwrap();装了以后字段私有、写清失败情形、示例可以直接复制。三个 Skill 分工如下:
| Skill | 什么时候用 | 产出 |
|---|---|---|
| rust-best-practices | Agent 新写或修改 Rust 时自动加载 | 约 500 行规则:所有权、API 设计、错误处理、并发、unsafe、测试,交付前跑 fmt/clippy/test |
| rust-review | 「审一下 src/parser.rs」「这个 PR 你会改什么」 | 分「必须改 / 应该改 / 可以考虑」三档的报告,每条带 file:line、违反的规则出处和最小改法 |
| rust-port | 「把 parser.c 迁到 Rust」 | 先迁原有测试,再重新设计 Rust API,附 PORTING.md 列出新旧对应和刻意的差异 |
官方在三个任务上做过对比(写库、写命令行工具、重构一个乱糟糟的模块),装 Skill 后 30 项检查通过 29 项,不装是 24 项。10 月的跨 Agent 对比里,Skill 对 Codex 的帮助比对 Claude 大,对审查任务帮助最大;也有一项变差:Claude 做 Bevy 新功能时装了 Skill 反而分低。官方注明每种配置只跑了一次,由 Claude 模型盲评。
怎么用
1. 安装三个 Skill。审查和迁移会参考写作 Skill 的风格规则,官方建议三个都装。通用方式用 npx skills:
# 任意 Agent(加 -g 装到用户目录,-a codex 指定 Agent)
npx skills add morganlinton/BeautifulRust
# Claude Code 插件
claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust
# OpenAI Codex 插件
codex plugin marketplace add morganlinton/BeautifulRust
codex plugin add beautiful-rust@beautiful-rust
# GitHub Copilot(GitHub CLI 2.90+)
gh skill install morganlinton/BeautifulRust rust-review
Gemini CLI 用 gemini skills install https://github.com/morganlinton/BeautifulRust --path skills/rust-review,三个 Skill 各装一次。手动复制的话放进 ~/.agents/skills/,但 Claude Code 不读这个目录,要放 ~/.claude/skills/ 或用插件。
2. 正常写代码。写作 Skill 会自动触发,要审查或迁移时直接说「review src/parser.rs」「port parser.c to Rust」。
3. 把 lint 接进 CI。把 lints/clippy.toml 放到 Cargo.toml 旁边,把 lints/lints.toml 里的 [lints] 段贴进 Cargo.toml,然后:
cargo clippy --all-targets --all-features -- -D warnings
它会拦下测试以外的 unwrap()、没有 // SAFETY: 注释的 unsafe、不写理由的 #[allow]、bool 参数、静默有损的 as 转换、遗留的 dbg! 和 todo! 等。标了 [lib] 的条目针对库,应用项目可以去掉。
Skill 管 Agent 写代码时怎么做,clippy 配置在 CI 里复查结果,漏网的写法会直接让构建失败。
装之前看这几条
- Skill 不联网。隐私说明写明:安装时不运行代码,没有统计和遥测。装了 Rust 工具链时,Agent 会按 Skill 要求跑
cargo fmt、cargo clippy、cargo test,cargo 照常会下载依赖、执行构建脚本。 - Codex / ChatGPT 插件会连一个远程 MCP。v1.6.0 起插件声明了
https://mcp.beautifulrust.dev/mcp,三个只读工具:查规则、解释 lint、查 crates.io 版本。不需要账号,只收到工具参数,托管在 Vercel,请求 IP 由 Vercel 处理。 - Bevy 项目有专门处理。依赖
bevy或bevy_ecs时,Skill 先读 Bevy 0.20 参考,不会把系统参数改成引用;lint 配置要另加四条 allow。 - 两条 lint 要求较新的 Rust。
allow_attributes和allow_attributes_without_reason需要rust-version = "1.81"或更高,否则 clippy 会关掉它们。 - 跑官方评测要花钱。仓库里的 evals 是真实模型调用,按用量计费。
适合谁,不适合谁
适合已经在用 Agent 写 Rust、想让产出更接近团队代码规范的人,也适合想把一个 C 或 Python 模块迁到 Rust、又要能证明行为不变的人。不写 Rust 的用不上;团队已有成熟 clippy 配置的,可以只装 rust-review 拿来审代码。要迁移整个小工具并逐项比对行为,可以看站内写过的 rust-anything。
最后
想试的话,先把 lint 配置放进一个现有 crate 跑一次 clippy,看报出多少条;再装上 rust-review,让 Agent 审同一个 crate,对比两边找出的问题。