idiomatic-rust
/idiomatic-rust
Kieruje pisanie, przegląd i refaktoryzację kodu w Rust do rozdziałów podręcznika o idiomach, lintach, błędach, testach, generykach i wskaźnikach dla edycji 2024.
- Autor
- OutlineDriven ↗
- Repozytorium
- outline-driven-development ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 28.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 11
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Kieruje pisanie, przegląd i refaktoryzację kodu w Rust do rozdziałów podręcznika o idiomach, lintach, błędach, testach, generykach i wskaźnikach dla edycji 2024.
Oryginalny opis (EN)
Use when writing, reviewing, or refactoring Rust code. Routes the task to handbook chapters on idioms, lints, errors, testing, generics, and pointers under the edition 2024 and current-stable pins.
Jak działa
- Contract
- Inputs
- Procedure
- References
- Failure and recovery
- Output
Podgląd SKILL.md
--- name: idiomatic-rust description: 'Use when writing, reviewing, or refactoring Rust code. Routes the task to handbook chapters on idioms, lints, errors, testing, generics, and pointers under the edition 2024 and current-stable pins.' --- # Idiomatic Rust ## Contract | Field | Bound contract | |---|---| | Trigger | Rust code is being written, reviewed, or refactored, or a Rust design choice about borrowing, error handling, dispatch, or testing needs the idiomatic answer. | | Authority | Reversible local: writes only the Rust source and project files the invoking task already touches; rollback is version-control restore. No remote mutation. | | Side effect | Rust source files may change under the invoking task; chapter guidance and verification output go to chat. | | Done | The code or review follows the conventions below, the routed chapters were consulted, and the toolchain verification ran clean or its failure is reported. | ## Inputs 1. The Rust task (required): code to write, a diff to review, or a design question. 2. The crate or workspace root (required when it is not the current directory): supplies `Cargo.toml`, `rust-toolchain.toml`, and the edition pin. 3. The toolchain pin (optional): defaults to the grounded pin in step 1. ## Procedure 1. Fix the toolchain baseline. The grounded pin is Rust 1.98.1 stable (released 2026-09-03) on edition 2024. Rust ships a rolling six-week stable train with no LTS channel, so current stable is the maintained target. When the project pins an older toolchain or edition, work inside that pin and note the delta. Done when: the effective toolchain and edition are named. 2. Route the task to the handbook chapters. Read every chapter the task touches in the same turn; the routing table is under References. Done when: each relevant chapter is loaded. 3. Apply the core conventions. Done when: the code or review reflects each convention that applies. - Borrowing and ownership: prefer `&T` over `.clone()` unless ownership must move; take `&str` over `String` and `&[T]` over `Vec<T>` in parameters; use `Cow<'_, T>` when ownership is ambiguous. - `Copy` types: passing a small `Copy` type by value is a heuristic, not a rule. The handbook's threshold is about two to three machine words, roughly 24 bytes on a 64-bit target, because the copy avoids a pointer indirection. The real cutoff depends on the target's register and calling conventions; measure when the path is hot. - Error handling: return `Result<T, E>` for fallible operations; keep `panic!` for unrecoverable bugs; use `thiserror` for library error types and `anyhow` for application binaries; propagate with `?`. - `unwrap()` and `expect()` stay out of production paths; tests and examples may use them. - Performance: benchmark with `--release`; run `cargo clippy -- -D clippy::perf` for hints; avoid cloning in loops; prefer iterators and avoid intermediate `.collect()` calls. - Dispatch: prefer generics (static dispatch) on hot paths; use `dyn Trait` for heterogeneous collections; box at API boundaries, not internally. - Type state: encode valid states in the type system when invalid transitions must fail at compile time. - Documentation: `//` comments carry why (safety, workarounds, rationale); `///` doc comments carry what and how on public API; every `TODO` names a tracking issue; enable `#![deny(missing_docs)]` on libraries. 4. Verify with the toolchain. Run `cargo fmt --check`, `cargo clippy --all-targets --all-features --locked -- -D warnings`, and `cargo test`. A lint that must be suppressed uses `#[expect(clippy::lint)]` with a justification comment, never a bare `#[allow]`. Done when: all three commands pass or each failure is reported with its cause. ## References Chapter content is inherited from the pinned handbook sources; the headline Rust 1.98.1 pin does not independently revalidate its per-feature and library assertions. | File | Read when | |---|---| | `references/chapter_01.md` | Borrowing vs cloning, `Copy`, `Option`/`Result` handling, iterators, comments, when to extract a function | | `references/chapter_02.md` | Clippy configuration, key lints, workspace lint setup | | `references/chapter_03.md` | Profiling, redundant clones, stack vs heap, zero-cost abstractions | | `references/chapter_04.md` | `Result` vs panic, `thiserror` vs `anyhow`, error hierarchies | | `references/chapter_05.md` | Test naming, one assertion per test, snapshot testing | | `references/chapter_06.md` | Static vs dynamic dispatch, trait objects | | `references/chapter_07.md` | Compile-time state safety with the type-state pattern | | `references/chapter_08.md` | When to comment, doc comments, rustdoc | | `references/chapter_09.md` | Thread safety, `Send`/`Sync`, pointer types | ## Failure and recovery | Failure class | Behavior | |---|---| | `cargo clippy` missing | Install it with `rustup component add clippy`; clippy ships as a rustup component in lockstep with rustc, not as a separately versioned package. | | Clippy false positive | Suppress with `#[expect(clippy::lint)]` and a justification comment; `expect` warns once the lint stops firing, so the suppression cannot go stale. | | Heuristic conflicts with measurement | The measurement wins; a heuristic states a default, not a law. | | Project pins an older toolchain | Work inside the project's pin and report which conventions need a newer toolchain. | ## Output Rust code or review feedback that follows the conventions above, with the toolchain verification results or the blocking failure named.
Pliki w paczce (11)
- SKILL.md 5 KB
- agents/openai.yaml 1 KB
- references/chapter_01.md 25 KB
- references/chapter_02.md 5 KB
- references/chapter_03.md 9 KB
- references/chapter_04.md 7 KB
- references/chapter_05.md 14 KB
- references/chapter_06.md 7 KB
- references/chapter_07.md 8 KB
- references/chapter_08.md 10 KB
- references/chapter_09.md 9 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · OutlineDriven/outline-driven-development | 100 | Apache-2.0 |
| gosuda/dalcom-skills | 100 | Apache-2.0 |
| rewrite-rs/skills | 100 | BSD-3-Clause |
Migawka bazy z 13.11.2026 · wersja paczki 484a849c461f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100rust-best-practices
Podpowiada idiomatyczny Rust według podręcznika Apollo GraphQL: pożyczanie zamiast klonowania, typy Result, testy i dokumentacja. - 100rust-best-practices
Podaje dobre praktyki idiomatycznego Rust według podręcznika Apollo GraphQL: nowy kod, przegląd i refaktoryzacja, pożyczanie i klonowanie, błędy Result, wydajność, testy i dokumentacja. - 100rust-best-practices
Stosuje wytyczne Microsoft Pragmatic Rust przy każdej edycji kodu Rust: obsługa błędów, projekt API, wydajność i idiomy. - 100rust
Daje przegląd języka Rust: pisanie kodu, zakładanie projektów i typowe przepływy pracy w rozwoju w Rust. - 86rust-review
Przegląda kod Rust, diff lub crate przed wdrożeniem i ocenia, czy jest poprawny oraz idiomatyczny. - 92write-script-rust
Prowadzi przez pisanie skryptów w Rust zgodnie z konwencjami tej platformy.