rust-best-practices – Rust 代码最佳实践 Skill

rust-best-practices 是用于指导 AI Agent 遵循 Rust 语言最佳实践编写与审查代码的 Skill，适合 Rust 项目的开发、重构和代码质量改进等任务。

查看调研报告在来源平台打开

代码审查开发与编程 # Apollo GraphQL # Claude Code # Rust # 代码审查 # 最佳实践

Skill 安装

多 Agent 安装

npx skills add https://github.com/apollographql/skills --skill rust-best-practices

使用 npx skills 快速安装，支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

apollographql/skills#rust-best-practices 是 Apollo GraphQL 官方 skills 仓库中的一个 Rust 最佳实践 Skill。它的作用是把一套面向 Rust 项目的编码规范、代码组织约定和常见陷阱清单，注入到支持 Skill 机制的 AI Agent 中，让 Agent 在生成、审查或重构 Rust 代码时，遵循这些约定，而不是只给出通用的 Rust 写法。

需要先明确一点：它本身不是一个可独立运行的软件，也不是编译器插件、clippy 规则集或 Cargo 子命令。它是一份以 Skill 形式分发的指导性内容（偏提示词 / 开发规范性质的指令集），只有被 Agent 加载后才会生效。

核心用途大致包括：

– 让 Agent 在写 Rust 时遵循一致的风格与结构约定
– 在代码审查环节指出偏离最佳实践的写法
– 辅助重构，把可用但不够地道的 Rust 代码调整得更符合惯用写法
– 在多文件、多模块的 Rust 工程里保持组织方式一致

典型任务：

– 生成新的 Rust 函数、模块或 crate 骨架
– 审阅现有 Rust 代码并给出改进建议
– 解释某段 Rust 代码为什么要按某种方式写
– 把其他语言的习惯性写法纠正为 Rust 惯用写法

工作方式：Agent 在处理 Rust 相关请求时，把该 Skill 的内容作为上下文约束，从而影响输出。它不执行代码、不连网、不调用外部服务，能力边界完全取决于宿主 Agent 自身。

适合的用户：正在用 AI Agent 辅助 Rust 开发、希望输出更贴近社区和团队约定的开发者。

不适合的需求：把它当成 Rust 编译器、静态检查工具或安全扫描器；也不要用它替代 `cargo`、`clippy`、`rustfmt` 等真正的工程工具。

与 Agent 自身能力的区别：没有这个 Skill，Agent 也能写 Rust，但风格和质量取决于模型本身。装上它之后，输出会被这套最佳实践约束，一致性和方向性更强。

Skill 安全评估

总体判断：这是一个以文本指令为主的 Skill，本身不包含可执行逻辑，正常使用下风险很低。真正需要留意的是宿主 Agent 的权限，而不是 Skill 自身。

– 来源可信度：来自 Apollo GraphQL 官方 skills 仓库，属于一手来源，可信度较高。
– 是否执行代码：Skill 本身不执行任何命令，不安装依赖，不发起网络请求。
– 文件读写：Skill 内容不会主动读写文件；但如果宿主 Agent 被授予了文件写入权限，它在应用这些规范时可能修改你的 Rust 代码。这属于 Agent 权限问题，不是 Skill 行为。
– Shell 权限：Skill 不需要 Shell。如果 Agent 在写 Rust 时自动运行 `cargo build`、`cargo test` 等命令，那是 Agent 的自动执行配置决定的，可以关闭，改为由你手动运行。
– 网络与凭证：该 Skill 不涉及 API Key、Token、OAuth 或远程服务。
– 供应链风险：主要来自你获取该 Skill 的渠道。建议从官方仓库读取，避免使用来路不明的转载版本，因为提示词类内容被替换后不易察觉。
– 提示词注入：任何第三方 Skill 都存在这一基础风险。加载前最好通读一遍内容，确认没有夹带与 Rust 最佳实践无关的指令。

降低风险的建议：

1. 只从官方来源获取该 Skill。
2. 如果只想让 Agent 给建议，可关闭自动执行 Shell 的权限，由你手动跑构建和测试。
3. 在重要代码库上使用前，先用小范围任务观察 Agent 的输出是否符合预期。

Skill 使用要求

一、Agent / 客户端

该 Skill 以通用 Skill 形式发布，官方没有公布完整的第三方 Agent 兼容列表。从 Skill 的工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中通常都可以尝试，例如 Claude Code、Codex、Cursor、Trae、OpenClaw、WorkBuddy。不同 Agent 的加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

Skill 本身是指导性内容，不依赖特定运行时。

三、权限

– 文件读取：可选，用于让 Agent 查看你的 Rust 代码。
– 文件写入：可选，仅在希望 Agent 直接改写代码时需要。
– Shell：可选，仅在希望 Agent 运行 `cargo` 等命令时需要。
– 网络：不需要。
– 浏览器 / Docker / GitHub：不需要。

四、账号 / API Key

Skill 本身不需要账号、API Key 或 Token。它后续帮助处理的 Rust 项目如果需要访问私有仓库或私有依赖，那属于项目自身的凭证需求，与该 Skill 无关。

最小使用条件

1. 一个支持 Skill 加载的 AI Agent。
2. 能获取到该 Skill 的来源。
3. 需要处理 Rust 代码时，准备好代码上下文。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。

如果不确定自己的 Agent 如何安装，可以直接询问当前 Agent：

如何安装 apollographql/skills#rust-best-practices？

如何在 Claude Code 中安装 apollographql/skills#rust-best-practices？

如何在 Cursor 中安装 apollographql/skills#rust-best-practices？

让 Agent 根据自己的 Skill 加载 / 管理机制来指导安装。该 Skill 没有需要额外说明的特殊安装条件。

二、安装后如何使用

安装后，在处理 Rust 相关任务时 Agent 会参考这套最佳实践。适合交给它的任务：编写 Rust 代码、审查 Rust 代码、重构 Rust 模块、解释 Rust 惯用写法。

使用示例：

使用 rust-best-practices，帮我审查这个 Rust 模块，指出不符合最佳实践的写法。

使用 rust-best-practices，把这个函数改写成更符合 Rust 惯用风格的实现。

使用 rust-best-practices，为这个 crate 设计一个清晰的模块划分。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。通常可以直接通过对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill，或者直接询问当前 Agent：

如何卸载 apollographql/skills#rust-best-practices？

如果没有统一卸载命令，让 Agent 根据其自身机制移除通常更稳妥。

常见问题

它会自动修改我的 Rust 项目吗？
不会主动修改。只有在宿主 Agent 被授予文件写入权限、且你的指令要求它改动代码时，才可能发生修改。只想拿建议时，可以只让它输出审查意见。

它是 clippy 或 rustfmt 的替代品吗？
不是。它提供的是编写层面的指导，不做编译期检查或自动格式化。工程上仍应配合 `cargo`、`clippy`、`rustfmt` 使用。

安装后 Agent 好像没识别到，怎么办？
先确认 Skill 是否真的被加载（不同 Agent 的存放位置和加载机制不同），再确认当前会话是否需要重新启动或重新加载。可以直接问 Agent 是否已加载该 Skill，让它自行检查。

更新后需要重新安装吗？
取决于你使用的方式。多数情况下需要重新获取最新版本，具体以对应 Agent 的 Skill 管理机制为准。

可以同时装到多个 Agent 吗？
可以，只要各 Agent 都支持 Skill 加载。不同 Agent 的兼容程度和效果可能不同，建议分别在各自环境中验证。

能不能关掉 Shell 权限来用？
可以。这个 Skill 本身不需要 Shell。关掉自动执行后，构建和测试命令由你手动运行即可。

Skill 更新日志

版本列表

v1.2.10 最新 2026-09-24

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.9.8，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/79 * docs: 将 connectors 技能指向最新的 Federation 和 Connectors LTS，由 @mabuyo 提交于 https://github.com/apollographql/skills/pull/80 ## 新贡献者 * @mabuyo 在 https://github.com/apollographql/skills/pull/80 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.9...v1.2.10

v1.2.9 2026-07-29

## 变更内容 * feat: 添加 authz、safelisting、config-as-code，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/69 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.8...v1.2.9

v1.2.8 2026-07-28

## 变更内容 * chore: 将 CLAUDE.md 符号链接到 AGENTS.md 并记录版本升级，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/78 * docs: 将 rust-best-practices 技能与上游手册同步，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/76 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.7...v1.2.8

v1.2.7 2026-07-28

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.9.4，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/73 * chore(deps): 将依赖 prettier 更新至 v3.9.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/74 * chore(deps): 将依赖 prettier 更新至 v3.9.6，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/75 * docs: 澄清 federation 链接版本是下限，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/77 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.6...v1.2.7

v1.2.6 2026-07-03

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.8.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/70 * chore(deps): 将依赖 prettier 更新至 v3.9.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/71 * 修复 list-apollo-kotlin-versions.sh 的链接，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/72 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.5...v1.2.6

v1.2.5 2026-06-04

## 变更内容 * docs: 记录 rover schema --coord 形式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/68 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.4...v1.2.5

v1.2.4 2026-06-03

## 变更内容 * Rover schema 探索，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/67 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.3...v1.2.4

v1.2.3 2026-05-25

## 变更内容 * 更新 Apollo Kotlin 技能以包含迁移指南，由 @martinbonnin 提交于 https://github.com/apollographql/skills/pull/66 ## 新贡献者 * @martinbonnin 在 https://github.com/apollographql/skills/pull/66 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.2...v1.2.3

v1.2.2 2026-05-04

## 变更内容 * docs: 将 gh 技能固定切换为 --pin 标志，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/62 * docs: 澄清 gh cli 注释与多技能安装匹配，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/63 * docs: 修复无效的 SDL 和不匹配的复杂度库，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/64 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.1...v1.2.2

v1.2.1 2026-04-28

## 变更内容 * feat: 将 gh skill cli 与自动发布集成，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/60 * fix(apollo-ios): 记录不受信任内容的威胁模型，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/61 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.0...v1.2.1

v1.2.0 2026-04-28

## 变更内容 * ci: 强制升级插件版本，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/59 * 添加 apollo-ios 技能，由 @AnthonyMDev 提交于 https://github.com/apollographql/skills/pull/58 ## 新贡献者 * @AnthonyMDev 在 https://github.com/apollographql/skills/pull/58 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.0.0...v1.2.0

v1.0.0 2026-04-28

## 变更内容 * 处理 Apollo Client 技能反馈：AC4 模式、TypedDocumentNode、缓存最佳实践，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/2 * 更新 README.md，由 @debergalis 提交于 https://github.com/apollographql/skills/pull/4 * 处理 PR #1 反馈：修复 Apollo Client 4.x 文档问题，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/3 * 为 Next.js、React Router 和 TanStack Start 添加框架特定的 Apollo Client 设置指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/6 * chore: 配置 Renovate，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/9 * 使文档语气与 Apollo Voice 指南保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/8 * 添加针对 Apollo Client 技能的 Copilot 指令，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/12 * 添加 skill-creator 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/10 * 从恢复的文档访问中添加完整的 Apollo Client Suspense hooks 文档，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/11 * 添加强调共置而非复用的 fragments 参考指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/13 * 分离客户端和 SSR 集成指南，将 setup 重命名为 integration，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/16 * 用完整手册章节替换 rust-best-practices 摘要，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/15 * 为 JavaScript/TypeScript 代码示例添加 Prettier 格式化，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/17 * 将 apollo-client 技能与上游提交 7f665110 同步，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/18 * 使 Apollo Server 技能与 Apollo Server 5.x 文档保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/19 * 更新一些导入，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/20 * 将 `skill-creator` 技能添加到活跃的 Copilot Skills，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/23 * 修复 apollo-mcp-server 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/21 * 为 PR 添加 skills-ref 验证工作流，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/25 * 添加 Apollo Kotlin 技能，由 @BoD 提交于 https://github.com/apollographql/skills/pull/26 * Apollo Kotlin 技能：添加脚本以获取最新版本，由 @BoD 提交于 https://github.com/apollographql/skills/pull/28 * 标准化技能版本格式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/29 * 更新指令信息，由 @dariuszkuc 提交于 https://github.com/apollographql/skills/pull/32 * chore(deps): 将依赖 prettier 固定到 3.8.1，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/33 * 修复拼写错误，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/31 * 添加 apollo-federation 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/5 * feat: 为联邦 GraphQL 超级图添加 apollo-router 技能，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/22 * 添加 Claude Code 插件支持，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/34 * 修复 apollo-mcp-server 技能配置示例中不正确的字段名，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/35 * feat(apollo-router): 使交接和快速开始以技能为先，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/36 * feat(skill): apollo-router-plugin-creator，由 @samuelAndalon 提交于 https://github.com/apollographql/skills/pull/30 * 从允许的工具中移除 curl，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/38 * 更新 apollo-mcp-server 技能以确保准确性，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/39 * fix: 修正 apollo-mcp-server 参考中不正确的 CORS 配置选项，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/40 * fix: 修复损坏的链接和语法/拼写问题，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/41 * ci: 添加 AI 驱动的技能同步工作流，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/42 * refactor: 直接将技能与产品源进行比较，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/43 * ci: 在技能同步中包含新功能覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/44 * fix: 使用 structured_output 作为分类结果，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/45 * fix: 将多操作示例拆分为每个文件一个操作，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/46 * 用 Claude CLI 替换 claude-code-action，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/47 * feat: 添加 GraphQL LSP 服务器配置，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/49 * chore(deps): 将依赖 prettier 更新至 v3.8.2，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/50 * chore(deps): 将依赖 prettier 更新至 v3.8.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/51 * feat: 从 apollo-client 仓库同步 apollo-client 技能，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/52 * fix(apollo-router): 围绕 Cache-Control 头重构响应缓存，由 @abernix 提交于 https://github.com/apollographql/skills/pull/53 * docs(apollo-router): 扩展可观测性和 Redis 部署指南，由 @abernix 提交于 https://github.com/apollographql/skills/pull/54 * sync: 从 apollo-client@47c63b9795770ad581f77d892932f97b1cb2eb87 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/55 * 为 apollo-router 技能添加响应缓存覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/37 * sync: 从 apollo-client@de252731ffdc61026b01dd4be9f8d11a98daf43e 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/57 ## 新贡献者 * @Copilot 在 https://github.com/apollographql/skills/pull/2 中做出了首次贡献 * @debergalis 在 https://github.com/apollographql/skills/pull/4 中做出了首次贡献 * @svc-secops 在 https://github.com/apollographql/skills/pull/9 中做出了首次贡献 * @phryneas 在 https://github.com/apollographql/skills/pull/12 中做出了首次贡献 * @DaleSeo 在 https://github.com/apollographql/skills/pull/10 中做出了首次贡献 * @BoD 在 https://github.com/apollographql/skills/pull/26 中做出了首次贡献 * @dariuszkuc 在 https://github.com/apollographql/skills/pull/32 中做出了首次贡献 * @jvanderwee 在 https://github.com/apollographql/skills/pull/31 中做出了首次贡献 * @gocamille 在 https://github.com/apollographql/skills/pull/22 中做出了首次贡献 * @samuelAndalon 在 https://github.com/apollographql/skills/pull/30 中做出了首次贡献 * @abernix 在 https://github.com/apollographql/skills/pull/53 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/commits/v1.0.0

暂无评论

暂无评论...