Tokio Async Rust taste — промпт для ChatGPT
Промпт Tokio Async Rust taste для ChatGPT задаёт правила проектирования асинхронных сервисов на Rust с Tokio. Он включается при написании или проверке кода, где важны отмена задач, тайм-ауты и завершение работы.
CC0-1.0 ★ 178 201 обновлён 2026-10-24
Открыть на GitHubЧто делает Tokio Async Rust taste
Промпт задаёт инженерные правила для асинхронного Rust-кода на Tokio. Он предлагает оставлять #[tokio::main] в бинарных приложениях, не блокировать runtime и ограничивать параллелизм через Semaphore или buffer_unordered(n). Для библиотек рекомендует сохранять независимость от runtime там, где это практично.
Отдельные пункты касаются каналов, обработки ошибок и диагностики. Промпт предлагает задавать тайм-ауты сетевым вызовам, отслеживать запущенные задачи через JoinSet или TaskTracker, а длительные операции завершать с помощью CancellationToken. Для HTTP-сервисов он рекомендует axum с middleware из tower; тесты — через #[tokio::test] и управление временем с start_paused = true.
Для коротких критических секций предлагается std::sync::Mutex или parking_lot; tokio::sync::Mutex — когда блокировка должна пережить .await. В Claude Code файл размещается по пути .claude/commands/prompts.csv.md.
Какие задачи решает
- разделить настройку Tokio между бинарным приложением и библиотекой
- обрабатывать тайм-ауты и отмену асинхронных задач
- ограничить параллельную обработку запросов
- проверять асинхронный код без реальных задержек
Примеры запросов агенту
- Проверь этот сервис на блокирующие операции и неограниченные каналы.
- Предложи безопасное завершение долгих задач с помощью
CancellationToken. - Напиши тест Tokio с управляемым временем для этого обработчика.
Как установить Tokio Async Rust taste
Как использовать
Вставьте текст в начало диалога или в инструкции проекта
Вручную: положить файлы
.claude/commands/prompts.csv.mdВопросы о Tokio Async Rust taste
Как установить Tokio Async Rust taste в Claude Code?
Размести файл по пути .claude/commands/prompts.csv.md.
Что делает Tokio Async Rust taste?
Он задаёт правила для асинхронных сервисов на Rust с Tokio: от тайм-аутов и управления задачами до логирования и тестов.
Как промпт предлагает тестировать асинхронный код?
Использовать #[tokio::test] и управлять временем через start_paused = true, а не полагаться на реальные паузы.
Исходный текст
prompts.csv · CC0-1.0
# Tokio Async Rust taste of a production service engineer - Use `#[tokio::main]` only in the binary and keep library crates runtime-agnostic where practical, taking futures and handles as inputs. Confidence: 0.80 - Never block the async runtime; move CPU-heavy or blocking I/O work to `spawn_blocking` or a dedicated thread pool. Confidence: 0.95 - Use `tokio::sync::Mutex` only when a lock must be held across an `.await`; otherwise use `std::sync::Mutex` or `parking_lot` for short critical sections. Confidence: 0.90 - Prefer message passing with bounded `mpsc` channels over shared mutable state, and size every channel deliberately for backpressure. Confidence: 0.85 - Never use unbounded channels in request paths, because a slow consumer turns into unbounded memory growth. Confidence: 0.85 - Put a timeout on every network call with `tokio::time::timeout` or a client-level setting; no await on the network should be able to hang forever. Confidence: 0.95 - Use `JoinSet` or `TaskTracker` to own spawned tasks so they are awaited, cancelled and their errors are observed. Confidence: 0.85 - Treat every `.await` as a possible cancellation point and keep state consistent if the future is dropped there. Confidence: 0.85 - Use `select!` carefully and only with cancel-safe branches; document why each branch is safe to drop. Confidence: 0.80 - Implement graceful shutdown with a `CancellationToken` passed to every long-running task, plus a drain deadline. Confidence: 0.90 - Use `thiserror` for library error enums and `anyhow` (or `eyre`) with context in binaries. Confidence: 0.85 - Instrument with `tracing`, using `#[instrument(skip_all, fields(...))]` on handlers and structured fields instead of formatted strings. Confidence: 0.90 - Build HTTP services on `axum` with `tower` middleware for timeouts, concurrency limits, tracing and request IDs. Confidence: 0.80 - Share application state through an `Arc<AppState>` holding pools and clients, not through global statics. Confidence: 0.85 - Reuse one `reqwest::Client` and one database pool per process instead of creating them per request. Confidence: 0.95 - Bound concurrency for fan-out work with a `Semaphore` or `buffer_unordered(n)` rather than spawning a task per item. Confidence: 0.85 - Avoid holding guards or non-`Send` values across `.await`; let the compiler's `Send` errors guide the code toward a cleaner structure. Confidence: 0.75 - Test async code with `#[tokio::test]` and control time with `start_paused = true` instead of real sleeps. Confidence: 0.80 - Use `tokio-console` or runtime metrics when debugging stalls, before guessing at the cause. Confidence: 0.65 - Keep tokio feature flags minimal in libraries and enable `full` only in binaries or tests. Confidence: 0.70
© f · CC0-1.0 · f/prompts.chat