1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | BeautifulRust |
| 作者/维护者 | morganlinton(Morgan Linton,个人开发者,已有外部贡献者提交 PR 与 issue) |
| 来源链接 | https://github.com/morganlinton/BeautifulRust |
| 许可证 | MIT(版权人 Morgan Linton) |
| GitHub Stars / Forks | 1,292 / 57(GitHub API,2026-10-28 读取) |
| 最新版本 | 插件清单 v1.4.0;主分支最近一次提交 2026-10-27 |
| 安装方式 | npx skills add morganlinton/BeautifulRust,或 Claude Code 插件安装 |
项目自述名称为 Beautiful Rust。
2. 功能介绍与亮点
三个技能加一份 clippy 配置,专管「让 agent 写出地道 Rust」。
| 组成 | 做什么 |
|---|---|
rust-best-practices |
写或改 Rust 时自动介入,把设计取舍写成规则:错误用 Result 建模、资源用所有权与 Drop、多态用 trait 与枚举、可空性用 Option,并区分库代码与业务代码的尺度 |
rust-review |
审文件、crate 或 diff,产出按优先级排序的报告,每条标明违反哪条规则并给出改法 |
rust-port |
把 C、C++、Python、Go、JavaScript 移植成行为一致的 Rust,先搬原测试再改实现 |
lints/ |
可直接落进项目的 clippy 配置,把能机器校验的规则交给 CI |
规则蒸馏自 Google Rust Style Guide、Rust API Guidelines、Effective Rust、Rust Design Patterns 与 Microsoft Pragmatic Rust Guidelines,冲突处明说取哪边、为什么。示例可在 stable 上编译,每个技能配 evals/ 用例,另有 2026-10 跨 agent 盲评(Claude Code 与 Codex 各跑 8 个任务、32 份结果盲判)。
3. 适用场景
所属分类:工程效率与代码质量。
| 场景 | 说明 |
|---|---|
| 日常写 Rust | 新建 crate、改模块、写测试与 rustdoc 时自动触发,避免把 C++/Java 习惯直译成 Rust |
| 代码评审 | 要一份「违反哪条规则、怎么改」的清单,而不是泛泛的风格意见 |
| 语言迁移 | 把 C/C++/Python/Go/JS 服务迁到 Rust,要求行为不变、测试先行 |
| 团队规范落地 | 把 lints/clippy.toml 放进仓库,让 CI 守住可机器校验的那部分 |
受益人群:用 Claude Code 或 Codex 写 Rust 的初中级开发者,以及要把遗留服务迁到 Rust 的团队。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 可作插件安装,三个技能以 /beautiful-rust:* 出现;也可把 skills/ 下三个目录复制进 ~/.claude/skills/ |
| Codex | 原生支持 | 仓库 2026-10 盲评即以 Codex CLI 跑通同一批任务,通过率 62%→89% |
| OpenClaw | 未验证 | 遵循 Agent Skills 目录格式(SKILL.md + references),复制安装理论上可行,未见实测 |
| Hermes Agent | 未验证 | 同上,未见实测 |
5. 推荐理由
Rust 的难点不在语法而在形状:所有权怎么切、错误类型怎么建、API 该暴露什么。这份技能把五份权威指南压成 agent 照着做的规则,评审时把意见落到「违反哪条、怎么改」,再配一份能进 CI 的 clippy 配置,让规范从建议变成门禁。对刚上手 Rust、又常让 agent 代写代码的人,省掉的正是「能编译但不像 Rust」的返工。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 1,292 stars、57 forks,建仓 6 天;GitHub 上已有外部贡献者的 issue 与合并 PR,但 Hacker News、Reddit 等平台尚无具名讨论 |
| 可用性 | 9 | 一条安装命令装完三个技能;文档含安装、评测方法、规则来源与前后对照示例;无 API key、无付费依赖;主分支当日仍在提交 |
| 安全性 | 9 | 纯规则文本与 clippy 配置,无联网、无凭据 |
安全性检查清单:
| 检查项 | 结果 |
|---|---|
| ① 执行 shell 命令及权限范围 | 有:scripts/check-lints.sh 等只调用本地 cargo 与 git,作用域限于当前项目 |
| ② 运行时联网外发数据 | 无 |
| ③ 要求 API key/凭据 | 不需要 |
| ④ 可疑指令 | 未见;SKILL.md 内只有规则正文与文献链接 |
| ⑤ 作者/组织信誉 | 个人开发者;仓库有 CI、贡献指南、变更日志与外部合并 PR,未见刷量迹象 |
| ⑥ License | MIT,署名明确 |
| ⑦ 最近维护时间 | 2026-10-27 |
7. 跟同类 Skills 相比的优势
| 竞品 | 它是什么 | 与 BeautifulRust 的差别 |
|---|---|---|
| modern-cpp(Trail of Bits) | C++ 现代化改造的规则集与检查清单 | 语言不同;C++ 侧重安全与遗留代码整治,这里侧重 Rust 的 API 形状与所有权建模 |
| Rust MCP Server Generator | 生成 Rust 写的 MCP 服务器骨架 | 只覆盖一类项目脚手架,不管日常风格、评审与语言迁移 |
| clippy / rustfmt(工具本体) | Rust 官方 lint 与格式化工具 | 只能拦机器可判的规则;「该用枚举还是布尔」「错误类型怎么设计」拦不住,本技能把它们写成了可执行的取舍 |
差别在于:写作、评审、迁移、门禁连成一条链,规则有出处、例子能编译、效果有跨 agent 盲评。
8. 用户评价
| 评价者 | 来源 | 内容 |
|---|---|---|
| mvanhorn | GitHub,2026-10-25,已合并 | 补离线自检脚本,以及一份强制技能自身规则的 Cargo [lints] 表 |
| DylanCosto | GitHub,2026-10-27 | 指出示例中的访问器越界会 panic,并提交改写 |
| millionart | GitHub,2026-10-26 | 请求补 Bevy/ECS 指导与对应评测用例 |
该技能在 Hacker News、Reddit 等第三方平台尚无具名用户评价。
9. 其他补充
v1.4.0;evals/ 覆盖 semver 库、日志 CLI、模块重构、Bevy 特性四类任务;跨 agent 基准逐条断言与判分证据随仓库公开。
10. 安装使用方式
npx skills add morganlinton/BeautifulRust # 任意支持 skills 安装器的 agent
claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust
Claude Code 会话内:/plugin marketplace add morganlinton/BeautifulRust,再 /plugin install beautiful-rust@beautiful-rust。手动安装则复制 skills/ 下三个目录。装完不必重启,提到 Rust/cargo/clippy 时自动触发;要把 lint 变成门禁,再把 lints/clippy.toml 复制到仓库根。
11. 注意事项
| 限制 | 说明 |
|---|---|
| 新仓 | 建于 2026-10-23,扩散快但尚无长期口碑;规则取舍由个人维护者裁定 |
| 盲评回退 | Bevy 特性任务上 Claude 带技能得 7/10(无技能 10/10),作者已修正 references/bevy.md;「该封装还是该裸露」这类边界仍会误导,结论需自核 |
| 语言范围 | 只服务 Rust,非 Rust 项目不会触发;团队已有自家规范时需先与技能内裁定对齐 |