项目2026-11-20 · 智涌AI

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

BeautifulRust 项目头图:左侧大字「BeautifulRust 地道 Rust Skill」与钩子「Agent 写的 Rust 按五份风格指南来」,三张数据卡为 3 个 Skill、2,074 GitHub 星、最新版本 v1.6.0;右侧对比面板列出官方评测装 Skill 前后的得分:Codex CLI 53/85 到 76/85,Claude Code 72/85 到 80/85,三任务检查 24/30 到 29/30,底部写 CI 用 cargo clippy -D warnings 把关

让编程 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-practicesAgent 新写或修改 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 里复查结果,漏网的写法会直接让构建失败。

装之前看这几条

适合谁,不适合谁

适合已经在用 Agent 写 Rust、想让产出更接近团队代码规范的人,也适合想把一个 C 或 Python 模块迁到 Rust、又要能证明行为不变的人。不写 Rust 的用不上;团队已有成熟 clippy 配置的,可以只装 rust-review 拿来审代码。要迁移整个小工具并逐项比对行为,可以看站内写过的 rust-anything。

最后

想试的话,先把 lint 配置放进一个现有 crate 跑一次 clippy,看报出多少条;再装上 rust-review,让 Agent 审同一个 crate,对比两边找出的问题。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。