mcpField
R
rust-router

rust-router

github.com/actionbookAgent 工作流1.6k2.7k 次安装9 周前更新
代码仓库

关于 rust-router

用于 Rust 问题分流的技能,可根据错误、概念和应用领域定位相关技能。它引导分层分析,并在涉及领域关键词时要求同时加载语言层与领域层技能。

主要功能

  1. 01按编译错误和概念分流
  2. 02将问题映射到认知层级
  3. 03指定领域需加载配套技能
  4. 04比较类问题触发协商流程
  5. 05分流 Crate 与任务相关问题

适用场景

  1. 01查找 Rust 编译错误对应技能
  2. 02结合领域约束分析设计问题
  3. 03分流比较或最佳实践问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/actionbook/rust-skills --skill rust-router

安装后在 Claude Code 中输入/rust-router确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

examples/
workflow.md
integrations/
os-checker.md
patterns/
negotiation.md

详细介绍


Rust 问题路由器

版本: 2.0.0 | 最后更新: 2025-01-22

v2.0: 优化上下文——详细示例已移至子文件

元认知框架

核心原则

不要直接回答。先逐层追溯认知层级。

Layer 3: Domain Constraints (WHY)
├── Business rules, regulatory requirements
├── domain-fintech, domain-web, domain-cli, etc.
└── "Why is it designed this way?"

Layer 2: Design Choices (WHAT)
├── Architecture patterns, DDD concepts
├── m09-m15 skills
└── "What pattern should I use?"

Layer 1: Language Mechanics (HOW)
├── Ownership, borrowing, lifetimes, traits
├── m01-m07 skills
└── "How do I implement this in Rust?"
按入口路由
用户信号入口层方向首选技能
E0xxx 错误第 1 层向上追溯 ↑m01-m07
编译错误第 1 层向上追溯 ↑下方错误表
“如何设计……”第 2 层检查第 3 层,然后向下 ↓m09-domain
“构建 [领域] 应用”第 3 层向下追溯 ↓domain-*
“最佳实践……”第 2 层双向m09-m15
性能问题第 1 层 → 第 2 层先向上,再向下m10-performance
关键:加载双重技能

出现领域关键词时,必须同时加载两项技能:

领域关键词第 1 层技能第 3 层技能
Web API、HTTP、axum、handlerm07-concurrencydomain-web
交易、支付、trading、paymentm01-ownershipdomain-fintech
CLI、终端、clapm07-concurrencydomain-cli
kubernetes、grpc、microservicem07-concurrencydomain-cloud-native
embedded、no_std、MCUm02-resourcedomain-embedded

给 CLAUDE 的说明

关键:协商协议触发条件

回答前,先检查是否需要协商:

查询包含操作
“比较”、“对比”、“compare”、“vs”、“versus”必须进行协商
“最佳实践”、“best practice”必须进行协商
领域 + 错误(例如,“交易系统 E0382”)必须进行协商
范围不明确(例如,“tokio 性能”)应进行协商

需要协商时,请包含:

## Negotiation Analysis

**Query Type:** [Comparative | Cross-domain | Synthesis | Ambiguous]
**Negotiation:** Enabled

### Source: [Agent/Skill Name]
**Confidence:** HIGH | MEDIUM | LOW | UNCERTAIN
**Gaps:** [What's missing]

## Synthesized Answer
[Answer]

**Overall Confidence:** [Level]
**Disclosed Gaps:** [Gaps user should know]

详见协议: patterns/negotiation.md


默认项目设置

创建新的 Rust 项目或 Cargo.toml 文件时,始终使用:

[package]
edition = "2024"  # ALWAYS use latest stable edition
rust-version = "1.85"

[lints.rust]
unsafe_code = "warn"

[lints.clippy]
all = "warn"
pedantic = "warn"

第 1 层技能(语言机制)

模式路由至
move、borrow、lifetime、E0382、E0597m01-ownership
Box、Rc、Arc、RefCell、Cellm02-resource
mut、内部可变性、E0499、E0502、E0596m03-mutability
generic、trait、inline、monomorphizationm04-zero-cost
type state、phantom、newtypem05-type-driven
Result、Error、panic、?、anyhow、thiserrorm06-error-handling
Send、Sync、thread、async、channelm07-concurrency
unsafe、FFI、extern、raw pointer、transmuteunsafe-checker

第 2 层技能(设计选择)

模式路由至
domain model、business logicm09-domain
performance、optimization、benchmarkm10-performance
integration、interop、bindingsm11-ecosystem
resource lifecycle、RAII、Dropm12-lifecycle
domain error、recovery strategym13-domain-error
mental model、how to thinkm14-mental-model
anti-pattern、common mistake、pitfallm15-anti-pattern

第 3 层技能(领域约束)

领域关键词路由至
fintech、trading、decimal、currencydomain-fintech
ml、tensor、model、inferencedomain-ml
kubernetes、docker、grpc、microservicedomain-cloud-native
embedded、sensor、mqtt、iotdomain-iot
web server、HTTP、REST、axum、actixdomain-web
CLI、命令行、clap、终端domain-cli
no_std、microcontroller、firmwaredomain-embedded

错误代码路由

错误代码路由到常见原因
E0382m01-ownership使用了已移动的值
E0597m01-ownership生命周期过短
E0506m01-ownership无法对借用的值赋值
E0507m01-ownership无法移出借用的值
E0515m01-ownership返回局部引用
E0716m01-ownership临时值已被丢弃
E0106m01-ownership缺少生命周期说明符
E0596m03-mutability无法进行可变借用
E0499m03-mutability存在多个可变借用
E0502m03-mutability借用冲突
E0277m04/m07未满足 Trait 约束
E0308m04-zero-cost类型不匹配
E0599m04-zero-cost找不到方法
E0038m04-zero-costTrait 不满足对象安全要求
E0433m11-ecosystem找不到 crate/模块

功能路由表

模式路由到操作
最新版本、新功能rust-learner使用 Agent
API、文档docs-researcher使用 Agent
代码风格、命名、clippycoding-guidelines阅读技能
unsafe 代码、FFIunsafe-checker阅读技能
代码审查os-checker查看 integrations/os-checker.md

优先级顺序

  1. 识别认知层级(L1/L2/L3)
  2. 加载入口技能(m0x/m1x/领域)
  3. 按层追踪(向上或向下)
  4. 按照“追踪”部分的说明交叉引用技能
  5. 给出推理链
关键词冲突解决
关键词解决方式
unsafeunsafe-checker(比 m11 更具体)
error一般情况使用 m06,特定领域使用 m13
RAII设计使用 m12,实现使用 m01
crate版本使用 rust-learner,集成使用 m11
tokioAPI 使用 tokio-*,概念使用 m07

优先级层级:

1. Error codes (E0xxx) → Direct lookup, highest priority
2. Negotiation triggers (compare, vs, best practice) → Enable negotiation
3. Domain keywords + error → Load BOTH domain + error skills
4. Specific crate keywords → Route to crate-specific skill if exists
5. General concept keywords → Route to meta-question skill

子文件参考

文件内容
patterns/negotiation.md协商协议详情
examples/workflow.md工作流示例
integrations/os-checker.mdOS-Checker 集成

评论

支持 Markdown