ClaudeMap

Beautiful Rust

三个 Agent Skills 加一份 clippy 配置:教编码 agent 写、审、移植地道 Rust——每条规则注明出处,每个示例都在 stable Rust 上编译过,每条 lint 都验证过会触发(MIT)

技能与命令rustcode reviewagent skillsclippyporting

beautiful-rust 是一套教编码 agent「写地道 Rust」的技能集(2026-10 创建,撰稿时 1769 星,2026-11-09):三个标准 Agent Skills——rust-best-practices(约 500 行、13 节,覆盖所有权与借用、类型与 API 设计、错误与 panic、并发与 async、unsafe 与 FFI、测试与性能)、rust-review(对文件、crate 或 diff 出分级审查报告,每条发现给出 file:line、违反的规则及其出处——API Guidelines 代码如 C-GETTER、Effective Rust 条目、Microsoft 指南或 clippy lint——与最小修复)、rust-port(把 C、C++、Python、Go 或 JavaScript 移植成地道 Rust,先移植原测试以证明行为一致,再设计 Rust API 而非直译,随附 PORTING.md 记录每个有意差异)——外加 lints/ 一份即插即用 clippy 配置,把机器可查的规则落进 CI(测试外 unwrap、无 SAFETY 注释的 unsafe、无理由的 #[allow]、bool 参数、有损 as 转换、缺 # Errors/# Panics 文档、无消息 assert!、未标 #[non_exhaustive] 的导出枚举、残留 dbg!/todo!)。规则蒸馏自五个来源(Google Rust Style Guide、Rust API Guidelines、Effective Rust、Rust Design Patterns、Microsoft Pragmatic Rust Guidelines),来源有分歧时明确站队并说明理由;针对 Bevy(0.20)有专门参考,免得通用建议误伤 ECS 惯例。每个 Rust 示例都经 check-examples.py 用 cargo check 编译验证,每条 lint 由 scripts/check-lints.sh 证明会触发。Claude Code 可整包作为插件安装(仓库自带 marketplace 清单),也支持 Codex、Copilot、Cursor、Gemini CLI 与 claude.ai(逐 skill 传 zip,需先开启 code execution)。自报跨 agent 基准(2026-10,8 个用例每配置跑一次、由 Claude 模型盲评):Claude Code(Opus 5.5)无技能 72/85、带技能 80/85;Codex CLI 无技能 53/85、带技能 76/85。

它做什么

  • 三个标准 Agent Skills——rust-best-practices、rust-review、rust-port——外加一份把机器可查规则落进 CI 的即插即用 clippy 配置
  • 每条规则注明出处(Google Rust Style Guide、Rust API Guidelines、Effective Rust、Rust Design Patterns、Microsoft Pragmatic Rust Guidelines);来源有分歧时明确站队并说明理由
  • rust-review 报告按必须修 / 应改进 / 可考虑分级,每条发现落到 file:line,附规则、出处与最小修复
  • rust-port 先移植原测试、设计 Rust API 而非直译原文,随附 PORTING.md 把旧 API 与测试映射到新家
  • Bevy 0.20 专门参考防止技能跟 ECS 惯例打架,并列出能干净编译过的 ECS bug(双可变 query、先读世界后应用 Commands 等)
  • 每个示例在 stable Rust 上编译过(check-examples.py),配置里每条 lint 都证明会触发(scripts/check-lints.sh)

什么时候用

适合 Rust 项目的日常 agent 开发与审查:让 agent 写出的代码一上手就是地道的、给存量代码或 PR 跑分级审查、把老 C/C++/Python 模块移植成 Rust 并证明行为一致;clippy 配置可直接进 CI 防规则回滑。

如何上手

# Claude Code——装成插件,以后一条命令更新:
claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust

# 在 Claude Code 会话里输入则等价于:
/plugin marketplace add morganlinton/BeautifulRust
/plugin install beautiful-rust@beautiful-rust

# 任意 agent 一条命令(skills 安装器,需 Node 22.20+):
npx skills add morganlinton/BeautifulRust

# Cursor 或其他工具:直接拷目录
git clone https://github.com/morganlinton/BeautifulRust
mkdir -p ~/.agents/skills
cp -R BeautifulRust/skills/rust-* ~/.agents/skills/

# 在 CI 里强制执行:
cargo clippy --all-targets --all-features -- -D warnings

注意事项

基准是自报的小样本:每配置只跑一次、由 Claude 模型盲评——而且有一例是负收益(带技能后 Claude 在 Bevy 功能任务上表现更差)。Bevy 参考只覆盖 Bevy 0.20,Bevy crate 还需额外四处 clippy allow,否则规则表会把每个地道系统签名都标出来。Claude Code 不读 .agents/skills/——要么用 ~/.claude/skills/ 要么走插件,装完没出现就重启 agent。allow_attributes 两条 lint 需要 rust-version 1.81 及以上。claude.ai 上传要求逐 skill 打 zip 且先开启 code execution。跑 evals 是真实模型调用,会产生费用。MIT。撰稿时 1769 星(2026-11-09)。

代码仓库

morganlinton/BeautifulRust

收录日期

地图上的相关资源

  • SureForge

    技能

    纯指令式 skill:让 agent 先调研再提问、先规划再动手、先验证再说「做完了」。

    • workflow
    • verification
    • quality
    • skill
  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap