Programowanie · Analiza
rust-profiling
/rust-profiling
Pomaga profilować binaria Rust przez flamegraphy, cargo-bloat, cargo-llvm-lines, Criterion, perf, heaptrack i DHAT.
Dla kogo
- Autor
- OutlineDriven ↗
- Repozytorium
- outline-driven-development ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 28.09.2026
Ocena i bezpieczeństwo
100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 3
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.
Licencja
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Pomaga profilować binaria Rust przez flamegraphy, cargo-bloat, cargo-llvm-lines, Criterion, perf, heaptrack i DHAT.
Oryginalny opis (EN)
Use when profiling Rust binaries with flamegraphs, cargo-bloat, cargo-llvm-lines, Criterion, perf, heaptrack, or DHAT.
Jak działa
- Contract
- Inputs
- Procedure
- Failure and recovery
- Output
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 574 słów
Podgląd SKILL.md
--- name: rust-profiling description: 'Use when profiling Rust binaries with flamegraphs, cargo-bloat, cargo-llvm-lines, Criterion, perf, heaptrack, or DHAT.' disable-model-invocation: true --- # Rust profiling ## Contract | Field | Bound contract | |---|---| | Trigger | Profiling Rust performance, reducing binary size, measuring monomorphization bloat, writing Criterion benchmarks, or interpreting flamegraphs and perf output. | | Authority | Read-only. Emits a guidance report and command transcripts to chat. No source or remote mutation. | | Side effect | Emits a structured guidance report with profiling commands, benchmark setup, and interpretation. No source files are modified. | | Done | A report is emitted that names the hot path, bloat source, size contributor, or benchmark result and the next action to take. | ## Inputs 1. **Target binary or benchmark** (required): the program, test, or Criterion benchmark to measure. 2. **Build profile** (required if not inferrable): a release profile with debug symbols (`release-with-debug` or `CARGO_PROFILE_RELEASE_DEBUG=true`). 3. **Profiling tool** (required): `cargo-flamegraph`, `cargo-bloat`, `cargo-llvm-lines`, Criterion, `perf`, `heaptrack`, or `valgrind --tool=dhat`. 4. **Optional inputs**: a saved baseline for comparison, or a specific function to annotate. ## Procedure 1. **Build for profiling.** Use a release profile with `debug = true` or set `CARGO_PROFILE_RELEASE_DEBUG=true`. For line-level attribution with faster builds, use `debug = 1`. For better call graphs, set `RUSTFLAGS="-C force-frame-pointers=yes"`. Done when: the binary has debug symbols and frame pointers are configured as needed. 2. **Generate a flamegraph.** Run `cargo flamegraph --bin <name> -- <args>`, or use `perf record -g` followed by `stackcollapse-perf.pl` and `flamegraph.pl`. Look for wide top frames, unexpected standard-library and allocator frames, and thin closure frames. Done when: a flamegraph SVG identifies hot leaves. 3. **Measure binary size with cargo-bloat.** Run `cargo bloat --release -n 20`, `cargo bloat --release --crates`, or `cargo bloat --release --filter <crate>`. Compare before and after with saved output. Done when: the largest size contributors are listed. 4. **Measure monomorphization bloat with cargo-llvm-lines.** Run `cargo llvm-lines --release | head -40`. A high `Copies` count usually means generic monomorphization; confirm by reading the function and its type parameters. Reduce it with a thin generic wrapper plus a concrete inner function. Done when: the functions with the most LLVM IR and copies are named. 5. **Write Criterion benchmarks.** Add `criterion` to `dev-dependencies`, create `benches/<name>.rs` with `criterion_group!` and `criterion_main!`, use `black_box` to prevent optimization, and compare with saved baselines. Done when: a benchmark file runs and produces a report. 6. **Profile with perf on Linux.** Record with `perf record -g -F 999 <binary>`, report with `perf report` or `perf annotate`, and gather quick counters with `perf stat`. Done when: the hot function and call graph are visible. 7. **Profile allocations with heaptrack or DHAT.** Run `heaptrack <binary>` and inspect with `heaptrack_print`, or run `valgrind --tool=dhat <binary>` and view `dhat-out.*` with `dh_view.html`. Done when: allocation hotspots and lifetimes are identified. ## Failure and recovery | Failure class | Behavior | |---|---| | No debug symbols | Rebuild with `debug = true` or `debug = 1`. | | Incomplete call graph | Set `RUSTFLAGS="-C force-frame-pointers=yes"` and disable ASLR with `setarch $(uname -m) -R`. | | Flamegraph permission denied | Lower `perf_event_paranoid` to 1 or run with sudo/DTrace on macOS. | | Benchmark results are noisy | Increase `measurement_time`, `sample_size`, and `warm_up_time` in Criterion. | | Allocation profile is too large | Filter to a smaller workload or reduce profiling duration. | ## Output 1. A structured guidance report with the chosen tool, measured result, and interpretation. 2. A recommended next action: a code change, a new benchmark, or a further profiling pass. 3. Commands to reproduce the measurement.
Pliki w paczce (3)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
- references/cargo-flamegraph-setup.md 5 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · OutlineDriven/outline-driven-development | 100 | Apache-2.0 |
| mohitmishra786/low-level-dev-skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki b86a440fbc8f (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-performance
Mierzy i profiluje Rust pod kątem opóźnień, CPU, pamięci i rozmiaru binarki, z benchmarkami Criterion, DHAT i testami regresji. - 100cargo-llvm-cov
Mierzy pokrycie kodu Rust przez instrumentację LLVM w cargo-llvm-cov: progi, raporty i integracja z codecov lub coveralls. - 100rust-cross
Buduje binaria Rust na inne architektury i systemy przez cross lub cargo-zigbuild, konfiguruje .cargo/config.toml i cele bare-metal. - 100claude-skill-rust
Prowadzi rozwój w Rust: styl kodu, testy, budowanie i kontrole jakości narzędziami cargo, przy pracy z kodem Rust, Cargo.toml i poleceniami cargo. - 95rust-optimization
Optymalizuje wydajność Rust: benchmarki, profilowanie, profil release, alokacje, współbieżność, asynchroniczność i rozmiar binarki. - 100rust-cross
Pomaga budować binaria Rust dla innej architektury lub systemu przez cross i cargo-zigbuild, konfigurować .cargo/config.toml i celować w systemy wbudowane bare-metal.