Rust Skills

2026-08-27 浏览 (14)

Rust Skills

基于元认知框架的 AI Rust 开发助手

Version License: MIT Claude Code

什么是 Rust Skills？

Rust Skills 是一个 Claude Code 插件，它改变了 AI 辅助 Rust 开发的方式。它不再给出表面答案，而是通过认知层追溯，提供领域正确的架构方案。

问题

传统 AI 的 Rust 辅助：

用户: "我的交易系统报 E0382"
AI: "用 .clone()"  ← 表面修复，忽略领域约束

解决方案

带元认知的 Rust Skills：

用户: "我的交易系统报 E0382"

AI (使用 Rust Skills):
├── Layer 1: E0382 = 所有权错误 → 为什么需要这个数据？
│       ↑
├── Layer 3: 交易记录是不可变审计数据 → 应该共享而非复制
│       ↓
├── Layer 2: 使用 Arc<TradeRecord> 作为共享不可变值
│       ↓
└── 建议: 重新设计为 Arc<T>，而非 clone()

功能特性

  • 元认知框架: 三层认知模型 (领域 → 设计 → 机制)
  • 实时信息获取: 通过后台 agents 获取最新 Rust 版本和 crate 信息
  • 动态 Skills: 从 Cargo.toml 依赖自动生成 skills
  • 领域扩展: 金融科技、机器学习、云原生、物联网、嵌入式、Web、CLI 支持
  • 编码规范: 完整的 Rust 编码规范和最佳实践

安装

Rust Skills 支持两种安装模式：

  • Plugin 模式（Claude Code）：完整功能，包含 hooks、agents 和自动元认知触发
  • Skills-only 模式：适用于任何支持 skills 的编码助手（Claude Code、Vercel AI 等）

Skills-only 安装（推荐）

最简单的安装方式。适用于任何支持 skills 的编码助手，包括 Claude Code、Vercel add-skills 等。

Skills 现已内置内联回退逻辑 —— 当 agent 文件不可用时，skills 会使用内置工具（actionbook、agent-browser、WebFetch）直接执行。

方式 A：NPX（最简单）

npx skills add actionbook/rust-skills

方式 B：CoWork CLI

通过 CoWork（基于 Rust 的 skills 管理工具）安装：

# 安装 CoWork
cargo install cowork

# 方式 1：直接安装
cowork install actionbook/rust-skills

# 方式 2：配置文件安装（推荐团队使用）
cowork config init                    # 创建 .cowork/Skills.toml
# 编辑 Skills.toml 添加 rust-skills（见下方配置）
cowork config install                 # 安装所有配置的 skills

Skills.toml 配置示例：

[project]
name = "my-rust-project"

[skills.install]
rust-skills = "actionbook/rust-skills"

[security]
trusted_authors = ["ZhangHanDong"]

CoWork（简写 co）提供版本管理、依赖解析、lock 文件和安全审计功能。详见 CoWork 文档。

方式 C：手动复制

git clone https://github.com/actionbook/rust-skills.git
cp -r rust-skills/skills/* ~/.claude/skills/

注意：Skills-only 模式不包含 hooks，元认知不会自动触发。可以手动调用 /rust-router 或特定 skills。后台 agents 会自动回退到内联执行模式。

Claude Code Plugin 安装（完整功能）

适用于想要获得完整体验的 Claude Code 用户，包含 hooks、后台 agents 和自动元认知触发。

方式 A：Marketplace

# 步骤 1: 添加 marketplace
/plugin marketplace add actionbook/rust-skills

# 步骤 2: 安装插件
/plugin install rust-skills@rust-skills

注意：步骤 1 仅添加 marketplace（插件源）。步骤 2 才是真正安装 rust-skills 插件，启用所有功能。

方式 B：完整插件（本地）

# 克隆仓库
git clone https://github.com/actionbook/rust-skills.git

# 使用插件目录启动
claude --plugin-dir /path/to/rust-skills

功能对比

功能Plugin（Marketplace）Plugin（本地）Skills-only（NPX/CoWork/手动）
全部 31 个 Skills✅✅✅
自动触发元认知✅✅❌（手动调用）
Hook 路由✅✅❌
后台 Agents✅✅✅（内联回退）
便捷更新✅❌✅（NPX/CoWork）
兼容其他编码助手❌❌✅

权限配置

后台 agents 需要运行 agent-browser 的权限。在项目中配置：

# 复制示例配置
cp /path/to/rust-skills/.claude/settings.example.json .claude/settings.local.json

或手动创建：

mkdir -p .claude
cat > .claude/settings.local.json << 'EOF'
{
  "permissions": {
    "allow": [
      "Bash(agent-browser *)"
    ]
  }
}
EOF

参见 .claude/settings.example.json 示例。

其他平台

依赖 Skills

Rust Skills 依赖以下外部工具以获得完整功能：

工具说明GitHub
actionbook网站操作手册 MCP 服务器。用于 agents 获取结构化网页内容（Rust 版本、crate 信息、文档）。actionbook/actionbook
agent-browser浏览器自动化工具，用于获取实时网页数据。作为 actionbook 不可用时的备选方案。vercel-labs/agent-browser

元认知框架

核心理念

不直接回答问题，先追溯认知层次。

Layer 3: 领域约束 (WHY - 为什么)
├── 领域规则决定设计选择
└── 例：金融系统要求数据不可变、可审计

Layer 2: 设计选择 (WHAT - 是什么)
├── 设计模式和架构决策
└── 例：使用 Arc<T> 共享不可变数据

Layer 1: 语言机制 (HOW - 怎么做)
├── Rust 语言特性和编译器规则
└── 例：E0382 是所有权设计问题的表现

路由规则

用户信号入口层追溯方向首选 Skill
E0xxx 错误Layer 1向上追溯 ↑m01-m07
"如何设计..."Layer 2双向追溯m09-m15
"[领域]应用开发"Layer 3向下追溯 ↓domain-*
性能问题Layer 1→2先上后下m10-performance

Skills 概览

核心 Skills

  • rust-router - Rust 问题主路由器 (首先调用)
  • rust-learner - 获取最新 Rust/crate 版本信息
  • coding-guidelines - 编码规范查询

Layer 1: 语言机制 (m01-m07)

Skill核心问题触发信号
m01-ownership谁应该拥有这个数据？E0382, E0597, move, borrow
m02-resource需要什么所有权模式？Box, Rc, Arc, RefCell
m03-mutability为什么这个数据需要改变？mut, Cell, E0596, E0499
m04-zero-cost编译时还是运行时多态？generic, trait, E0277
m05-type-driven类型如何防止无效状态？newtype, PhantomData
m06-error-handling预期失败还是 bug？Result, Error, panic, ?
m07-concurrencyCPU 密集还是 I/O 密集？async, Send, Sync, thread

Layer 2: 设计选择 (m09-m15)

Skill核心问题触发信号
m09-domain这个概念的领域角色是什么？DDD, entity, value object
m10-performance瓶颈在哪里？benchmark, profiling
m11-ecosystem哪个 crate 适合这个任务？crate 选择, 依赖
m12-lifecycle何时创建、使用、清理？RAII, Drop, lazy init
m13-domain-error谁处理这个错误？retry, circuit breaker
m14-mental-model如何正确思考这个概念？学习 Rust, 为什么
m15-anti-pattern这个模式隐藏了设计问题吗？code smell, 常见错误

Layer 3: 领域约束 (domain-*)

Skill领域核心约束
domain-fintech金融科技审计追踪, 精度, 一致性
domain-ml机器学习内存效率, GPU 加速
domain-cloud-native云原生12-Factor, 可观测性, 优雅关闭
domain-iot物联网离线优先, 功耗管理, 安全
domain-webWeb 服务无状态, 延迟 SLA, 并发
domain-cli命令行用户体验, 配置优先级, 退出码
domain-embedded嵌入式无堆, no_std, 实时性

命令

命令说明
/rust-features [version]获取 Rust 版本特性
/crate-info <crate>获取 crate 信息
/docs <crate> [item]获取 API 文档
/sync-crate-skills从 Cargo.toml 同步 skills
/update-crate-skill <crate>更新指定 crate skill
/clean-crate-skills清理本地 crate skills

动态 Skills

从项目依赖按需生成 skills：

# 进入 Rust 项目
cd my-rust-project

# 同步所有依赖
/sync-crate-skills

# Skills 创建在 ~/.claude/skills/{crate}/

特性

  • 按需生成: 从 Cargo.toml 依赖创建
  • 本地存储: ~/.claude/skills/
  • 版本追踪: 每个 skill 记录 crate 版本
  • Workspace 支持: 解析所有 workspace 成员

工作原理

用户问题
     │
     ▼
┌─────────────────────────────────────────┐
│           Hook 触发层                    │
│  400+ 关键词触发元认知流程               │
└─────────────────────────────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│           rust-router                    │
│  识别入口层 + 领域                       │
│  决策: 双技能加载                        │
└─────────────────────────────────────────┘
     │
     ├──────────────┬──────────────┐
     ▼              ▼              ▼
┌──────────┐  ┌──────────┐  ┌──────────┐
│ Layer 1  │  │ Layer 2  │  │ Layer 3  │
│ m01-m07  │  │ m09-m15  │  │ domain-* │
└──────────┘  └──────────┘  └──────────┘
     │
     ▼
领域正确的架构方案

文档

贡献

欢迎贡献！提交 PR 前请阅读贡献指南。

致谢

许可证

MIT 许可证 - 详见 LICENSE

链接

  • GitHub: https://github.com/actionbook/rust-skills
  • Issues: https://github.com/actionbook/rust-skills/issues
  • 所属分类： AI
  • 本文标签： rust
  • 版权声明： 本文链接 https://seaxiang.com/blog/fz2zd9