Rust 开发实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sammcj-agentic-coding-rust-development。
技能介绍
要解决什么问题
Rust 项目在规模变大后,编译时间、crate 边界和对外 API 形态往往会拖慢迭代:workspace 没拆好会反复全量编译;Cargo.toml 里给依赖开一堆默认 feature 会悄悄拉长构建图;public 接口里堆满泛型,也会让跨 crate 维护和文档成本陡增。这个技能不是要教你学 Rust 语法,而是让 AI 助手在写/改代码时默认遵守一组工程约定,产出更符合「可维护 + 可编译」预期的补丁。
技能如何工作
技能把 SKILL.md 里的几条硬规则嵌入对话上下文,主要覆盖四类决策:
- 工具链:优先采用较新的 Rust / Cargo 能力与写法,避免用过时模式拖累性能或兼容性。
- Workspace 拆分:在合适时建议用 rust workspace,把逻辑拆成多个内部 crate,缩短增量编译路径。
- API 设计:除非有充分理由,避免在 public 或跨 crate API 上暴露泛型,减轻类型签名对调用方的压力。
- 依赖 feature:对外部 crate 只启用必需 feature,控制依赖图与编译单元体积。
助手在重构模块、改 Cargo.toml、设计 crate 边界或评审 diff 时,会按上述清单做取舍说明,而不是只给「能编译就行」的最小改动。
适用边界与注意点
- 覆盖的是项目结构与 Cargo 层面的惯例,不替代
unsafe审计、并发模型设计或领域算法选型。 - Workspace 拆分需要结合你仓库的真实依赖关系;技能会倾向「可编译、构建更快」的方向,最终布局仍要你自己拍板。
- 「避免 public 泛型」是默认立场,确有类型擦除或插件式扩展需求时,应明确要求助手例外处理并写清理由。
使用场景
- 多 crate 单体仓库编译变慢,需要拆 workspace 并划分内部 crate 边界
- 评审 PR 时发现 public API 泛型过多,希望按团队约定收紧对外接口
- 升级依赖后构建时间暴涨,需要梳理各 crate 只开必要的 feature
- 用 AI 改 `Cargo.toml` 与模块结构时,希望默认遵循较新 Rust/Cargo 写法
适合人员
- 维护公司内部 Rust 平台库、需要控制对外 API 稳定性的基础架构工程师
- 负责 CI 编译时长与依赖治理、经常改 workspace 布局的 Rust 技术负责人
- 在开源 crate 上接待外部贡献、希望 PR 符合 Cargo feature 与 crate 边界的维护者
- 用 Copilot 类助手日常写 Rust、希望少踩「全量 feature + 泛型泄漏」补丁的库作者