rust-systems — скилл для Claude Code: Rust-паттерны и установка
Скилл rust-systems помогает писать системный код на Rust: работать с владением, ошибками, трейдами и асинхронностью. Подключайте его при проектировании библиотек и сервисов.
Apache-2.0 ★ 2 858 обновлён 2026-05-12
npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a claude-codeЧто делает rust-systems
В рекомендациях разбираются заимствования вместо лишней передачи владения, типы ошибок с thiserror и применение трейдов для абстракций. Есть примеры с sqlx, tokio и шаблоном Builder для конфигурации сервера.
Отдельные советы касаются ограничения параллельных задач, корректного завершения асинхронного приложения и безопасного использования unsafe. Удержание MutexGuard через .await может привести к взаимной блокировке, а блоки unsafe требуют документировать инварианты безопасности. Скилл также советует избегать .unwrap() в рабочем коде и включать проверки Clippy.
Какие задачи решает
- выбрать заимствование вместо ненужного клонирования данных
- оформить ошибки библиотеки через
thiserror - ограничить число одновременных асинхронных задач
- спроектировать трейд для репозитория и тестируемой абстракции
- добавить безопасное завершение и документировать блоки
unsafe
Примеры запросов агенту
- Проверь этот Rust-код: найди лишнее клонирование и предложи заимствования.
- Переработай обработку ошибок библиотеки с помощью
thiserrorи оператора?. - Ограничь параллельные запросы в этом асинхронном Rust-сервисе и проверь работу с
MutexGuard.
Как установить rust-systems
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a claude-code2Вручную: положить файлы
~/.claude/skills/rust-systems/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rust-systems/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a codex2Вручную: положить файлы
.agents/skills/rust-systems/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a cursor2Вручную: положить файлы
.cursor/skills/rust-systems/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/awesome-claude-code-toolkit skills/rust-systems2Вручную: положить файлы
.github/skills/rust-systems/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/awesome-claude-code-toolkit --path skills/rust-systemsВручную: положить файлы
.devin/skills/rust-systems/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о rust-systems
Как установить rust-systems в Claude Code?
Выполните npx skills add rohitg00/awesome-claude-code-toolkit --skill rust-systems -a claude-code. Файл скилла находится по пути ~/.claude/skills/rust-systems/SKILL.md.
Что делает rust-systems?
Скилл даёт рекомендации по Rust для системного программирования: от владения и типов ошибок до асинхронных задач, трейдов и правил для unsafe.
Какие ошибки в асинхронном Rust помогает находить rust-systems?
Он предостерегает от удержания MutexGuard через .await, предлагает ограничивать параллелизм с помощью семафоров или buffer_unordered и описывает graceful shutdown.
Исходный текст
SKILL.md · Apache-2.0
---
name: rust-systems
description: Rust systems programming patterns including ownership, traits, async runtime, error handling, and unsafe guidelines
---
# Rust Systems
## Ownership and Borrowing
```rust
fn process_data(data: &[u8]) -> Vec<u8> {
data.iter().map(|b| b.wrapping_add(1)).collect()
}
fn modify_in_place(data: &mut Vec<u8>) {
data.retain(|b| *b != 0);
data.sort_unstable();
}
fn take_ownership(data: Vec<u8>) -> Vec<u8> {
let mut result = data;
result.push(0xFF);
result
}
fn main() {
let data = vec![1, 2, 3, 0, 4];
let processed = process_data(&data); // borrow: data still usable
let mut owned = take_ownership(data); // move: data no longer usable
modify_in_place(&mut owned); // mutable borrow
}
```
Prefer borrowing (`&T`, `&mut T`) over ownership transfer. Use `Clone` only when necessary.
## Error Handling
```rust
use thiserror::Error;
#[derive(Error, Debug)]
pub enum AppError {
#[error("database error: {0}")]
Database(#[from] sqlx::Error),
#[error("not found: {resource} with id {id}")]
NotFound { resource: &'static str, id: String },
#[error("validation failed: {0}")]
Validation(String),
}
type Result<T> = std::result::Result<T, AppError>;
async fn get_user(pool: &PgPool, id: &str) -> Result<User> {
sqlx::query_as::<_, User>("SELECT * FROM users WHERE id = $1")
.bind(id)
.fetch_optional(pool)
.await?
.ok_or_else(|| AppError::NotFound {
resource: "User",
id: id.to_string(),
})
}
```
Use `thiserror` for library errors, `anyhow` for application-level errors. Avoid `.unwrap()` in production code.
## Traits and Generics
```rust
trait Repository {
type Item;
type Error;
async fn find_by_id(&self, id: &str) -> std::result::Result<Option<Self::Item>, Self::Error>;
async fn save(&self, item: &Self::Item) -> std::result::Result<(), Self::Error>;
}
struct PgUserRepo {
pool: PgPool,
}
impl Repository for PgUserRepo {
type Item = User;
type Error = AppError;
async fn find_by_id(&self, id: &str) -> Result<Option<User>> {
let user = sqlx::query_as::<_, User>("SELECT * FROM users WHERE id = $1")
.bind(id)
.fetch_optional(&self.pool)
.await?;
Ok(user)
}
async fn save(&self, user: &User) -> Result<()> {
sqlx::query("INSERT INTO users (id, name, email) VALUES ($1, $2, $3)")
.bind(&user.id)
.bind(&user.name)
.bind(&user.email)
.execute(&self.pool)
.await?;
Ok(())
}
}
```
## Async Patterns
```rust
use tokio::sync::Semaphore;
use futures::stream::{self, StreamExt};
async fn fetch_all(urls: Vec<String>, max_concurrent: usize) -> Vec<Result<String>> {
let semaphore = Arc::new(Semaphore::new(max_concurrent));
stream::iter(urls)
.map(|url| {
let sem = semaphore.clone();
async move {
let _permit = sem.acquire().await.unwrap();
reqwest::get(&url).await?.text().await.map_err(Into::into)
}
})
.buffer_unordered(max_concurrent)
.collect()
.await
}
async fn graceful_shutdown(handle: tokio::runtime::Handle) {
let ctrl_c = tokio::signal::ctrl_c();
ctrl_c.await.expect("Failed to listen for Ctrl+C");
handle.shutdown_timeout(std::time::Duration::from_secs(30));
}
```
## Builder Pattern
```rust
pub struct ServerConfig {
host: String,
port: u16,
workers: usize,
tls: bool,
}
pub struct ServerConfigBuilder {
host: String,
port: u16,
workers: usize,
tls: bool,
}
impl ServerConfigBuilder {
pub fn new() -> Self {
Self { host: "0.0.0.0".into(), port: 8080, workers: 4, tls: false }
}
pub fn host(mut self, host: impl Into<String>) -> Self { self.host = host.into(); self }
pub fn port(mut self, port: u16) -> Self { self.port = port; self }
pub fn workers(mut self, n: usize) -> Self { self.workers = n; self }
pub fn tls(mut self, enabled: bool) -> Self { self.tls = enabled; self }
pub fn build(self) -> ServerConfig {
ServerConfig { host: self.host, port: self.port, workers: self.workers, tls: self.tls }
}
}
```
## Anti-Patterns
- Using `.unwrap()` or `.expect()` in library code
- Cloning data unnecessarily instead of borrowing
- Holding a `MutexGuard` across `.await` points (causes deadlocks)
- Using `Arc<Mutex<Vec<T>>>` when a channel would be more appropriate
- Writing `unsafe` without documenting invariants
- Not using `#[must_use]` on Result-returning functions
## Checklist
- [ ] Error types defined with `thiserror` and `?` operator used for propagation
- [ ] No `.unwrap()` in production paths
- [ ] Ownership model minimizes cloning
- [ ] Async code uses bounded concurrency (semaphores or `buffer_unordered`)
- [ ] Traits used for abstraction and testability
- [ ] `unsafe` blocks have documented safety invariants
- [ ] Builder pattern used for complex configuration structs
- [ ] Clippy lints enabled and warnings addressed
© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit