AIKraft/AI/Войти
AIKraft/Skills/pma rust

pma rust

Production-grade Rust acceptance baseline for PMA-managed Rust services and CLIs. Use with /pma when creating, reviewing, or upgrading Rust workspaces, Axum/Tokio services, CLI binaries, CI pipelines, release packaging, lint policy, dependency choices, testing, observability, security, or supply-chain controls. Defines hard locks for pure-Rust dependencies, rustls TLS, forbid unsafe code, edition

zzci official Разработка

Что делает навык

Набор жёстких ограничений (hard locks) и стандартов приёмки для создания, ревью и обновления Rust-проектов (сервисов Axum/Tokio, CLI, CI). Определяет обязательные требования к безопасности, качеству кода, зависимостям и релизному процессу. Используется совместно с /pma для контроля качества и утверждения изменений.

Когда применять

  • Создание нового Rust-workspace с нуля, включая настройку edition 2024 и политик lint.
  • Ревью кода или CI-пайплайна на соответствие стандартам безопасности (запрет unsafe, rustls, cargo-deny).
  • Настройка релизного процесса: сборка musl-бинарников, конфигурация profile.dist, подпись и воспроизводимость.
  • Обеспечение наблюдаемости (observability) и стабильности: настройка Tracing, OTLP, эндпоинтов /livez и /readyz.

Как работает

  1. Загрузить references/baseline.md для получения списка Hard Locks, затем выбрать соответствующий пакет (toolchain-and-workspace, runtime-and-data или delivery).
  2. Настроить Cargo.toml: объявить edition 2024, rust-version, запретить unsafe кода (#![forbid(unsafe_code)]) и warnings, использовать только rustls для TLS.
  3. Настроить CI для проверки качества: запуск fmt, clippy (с политикой deny-warnings), nextest, doctest, cargo-deny, cargo-shear, typos и проверки MSRV.
  4. Реализовать обработку ошибок через thiserror 2.x (anyhow/eyre только в bin), использовать secrecy::Secret<T> для секретов и структурированный логирование через Tracing.
  5. Настроить graceful shutdown через axum::serve(...).with_graceful_shutdown(...) и CancellationToken, а также подавить core dumps на всех уровнях.
  6. При отклонении от стандартов создать документированное решение в docs/decisions/<adr>.md с датой sunset, иначе /pma откажет в утверждении.

Примеры запросов агенту

Проведи ревью моего Rust-сервиса на соответствие стандартам pma rust, проверь наличие всех Hard Locks.
Настрой CI-пайплайн для нового workspace на Rust 2024, включающий проверку MSRV, cargo-deny и nextest.
Как правильно настроить TLS и безопасность зависимостей в проекте согласно pma rust?

Что понадобится

  • Инструменты: cargo, cargo clippy, cargo nextest, cargo-deny, cargo-shear, cargo hack (или cargo msrv), typos.
  • Совместное использование с /pma для управления workflow и утверждением задач.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «pma-rust» из репозитория: # https://github.com/zzci/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r pma-rust/ ~/.claude/skills/pma-rust/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.