Nemagu
- 32 skills
- 0 followers
- 15 hours ago last updated
- ▌ Documentation Quality Review · nemagu bundleПроверка нормативной документации на внутренние и междокументные противоречия, неоднозначность, пробелы требований, нарушения структуры, владения и ссылок с записью замечаний в `.review/documentation-quality.md`. Использовать после создания или изменения документации для полного либо ограниченного аудита её готовности к реализации без чтения кода и без исправления документов. Не использовать для проектирования требований, сверки с реализацией или непосредственного устранения замечаний.
- ▌ Python Pytest Testing · nemagu bundleИспользуй как вспомогательный скил при настройке и организации тестов Python через pytest, pytest-asyncio и pytest-cov: структура unit/integration, фикстуры, фабрики, conftest.py, параметризация, маркеры, асинхронные тесты, команды запуска, покрытие и общий lifecycle временной интеграционной инфраструктуры. Не использовать для определения тестовых сценариев, ожидаемого поведения компонентов и технологически специфичных проверок.
- ▌ CLI Documentation Writing · nemagu bundleПроектирование, создание, адаптация и ревью аналитической Markdown-документации CLI presentation-слоя: исполняемой команды, иерархии групп и действий, аргументов, опций, справки, внешней валидации, моделей результата, форматов, подробности, потоков, статусов завершения, application-mapping, ошибок, примеров ответов, корреляции и SUMMARY.md. Использовать, когда CLI-контракт должен быть достаточен для реализации без новых продуктовых решений. Не использовать для определения application/domain-контрактов, реализации CLI или восстановления требований из кода без разрешения.
- ▌ Python Click CLI Writing · nemagu bundleИспользуй при реализации или рефакторинге presentation-слоя CLI на Python с Click: дерева групп и команд, аргументов и опций, command-local моделей, Click context/state, тонких command handlers и общей границы выполнения. Не применять для одной только документации CLI, application/domain-логики, реализации конфигурации, адаптеров ресурсов или общего logging runtime.
- ▌ Python Code Style Writing · nemagu bundleИспользуй при написании, изменении, рефакторинге и ревью любого Python-кода: единообразие условий, enum-сравнений, импортов, исключений, абстрактных методов, порядка членов класса, размера файлов и проверки форматировщиком проекта. Применяй совместно с профильным архитектурным или технологическим скилом; не использовать вместо него для определения поведения и структуры слоёв.
- ▌ Python Fastapi API Worker · nemagu bundleИспользуй при реализации или правке сборки HTTP API-процесса на FastAPI: фабрики приложения, типизированного runtime context, lifespan shared-ресурсов, middleware, logging context запроса, error boundary, health endpoints и запуска через Uvicorn. Не применять для определения HTTP-контрактов, реализации конкретных endpoint-ов и transport-моделей, application/domain-логики, persistence-адаптеров и фоновых worker-ов.
- ▌ Python Gitlab CI Pipeline · nemagu bundleИспользуй при создании или правке .gitlab-ci.yml для Python-сервисов на uv (DDD/CQRS-бэкенды). Триггеры — добавление/изменение джоб lint, test (unit и integration), build образа; настройка кэша uv, стадий, workflow.rules; авто-отмена устаревших пайплайнов при новом push'е (`workflow.auto_cancel.on_new_commit` + `interruptible`); сборка docker-образа в CI (Kaniko, теги по ветке, registry mirror); подключение отчётов (JUnit, coverage, code quality) и security-гейтов (bandit, pip-audit, trivy); деплой в Docker Swarm через SSH с обновлением существующего стека на сервере (`docker stack deploy` поверх compose на хосте, deploy token для registry, environments и manual-gate для prod). Не применять для написания самих тестов — для этого есть python-pytest-testing.
- ▌ HTTP API Documentation Writing · nemagu bundleПроектирование, создание, адаптация и ревью аналитической Markdown-документации HTTP API: публичных и приватных областей, версий, ресурсов, endpoint-ов, параметров, заголовков, моделей запросов и ответов, пагинации, фильтрации, сортировки, перечислений, ошибок, примеров, стабильных обозначений и SUMMARY.md. Использовать, когда HTTP-контракт должен быть достаточен для реализации без новых продуктовых решений. Не использовать для определения application/domain-контрактов, реализации FastAPI, входящих сообщений, фоновых процессов или восстановления требований из кода без разрешения.
- ▌ Python Repository Documentation · nemagu bundleИспользуй при документировании Python-репозиториев в прикладных сервисах. Триггеры — описание архитектуры, модулей, публичных методов и контрактов; написание docstring на русском языке в кратком стиле; оформление README и синхронизация документации с изменениями кода. Примеры конфигурации относятся к специализированному скилу конфигурации приложения.
- ▌ Python Service Logging Writing · nemagu bundleИспользуй при реализации или правке логирования отдельно запускаемых процессов Python-сервиса: общей настройки logger-а, structured context, полей запроса или сообщения, стабильных событий, уровней, единственной error boundary, JSON renderer-а и тестов logging-контракта. Применяй совместно со скилом конкретного API или worker-процесса. Не использовать для аналитического проектирования logging-контракта, выбора collector-а, метрик и трассировки.
- ▌ Implementation Skill Compliance Review · nemagu bundleПроверка реализации на соответствие требованиям и рекомендациям динамически обнаруженных implementation-скилов с записью замечаний в `.review/skill-compliance.md`. Использовать для полного или ограниченного аудита кода, структуры, конфигурации и тестов без их исправления. Не использовать для написания или изменения реализации, проверки соответствия документации либо автоматического запуска после каждой правки.
- ▌ Ddd Domain Documentation Writing · nemagu bundleПроектирование и ведение аналитической документации доменной модели в сервисах с DDD и гексагональной архитектурой: агрегатов, сущностей, состояний, инвариантов, поведения, value objects, доменных сервисов, проекций, доменных ошибок и событий. Использовать для сбора требований и создания или дополнения Markdown-спецификаций domain-слоя. Не использовать для CQRS-оркестрации, DTO application-слоя, транспортных контрактов, реализации кода или восстановления требований из кода.
- ▌ Python Ddd Domain Layer Writing · nemagu bundleИспользуй при реализации или правке доменного слоя в Python-проекте по DDD/гексагональной архитектуре. Триггеры — добавление или изменение агрегата, проекции, объекта-значения, доменного сервиса, фабрики, абстрактного repository-интерфейса в `domain/`; реализация заданных инвариантов, поведения, версионирования, доменных ошибок и состояний. Не применять для определения требований и слоёв `application/`, `infrastructure/`, `presentation/`.
- ▌ Python Docker Entrypoint Writing · nemagu bundleИспользуй при создании, изменении и ревью Dockerfile, Docker ENTRYPOINT/CMD и контейнерного запуска Python-сервиса с одним или несколькими процессами. Скил унифицирует выбор Python entrypoint-модулей, способ запуска из установленного окружения, передачу аргументов, сигналов и кодов завершения, непривилегированного пользователя, сборку зависимостей и process-specific healthcheck. Не применять для внутреннего устройства FastAPI, фонового runtime, consumer/publisher или application-логики.
- ▌ Service Implementation Orchestrator · nemagu bundleСквозная реализация согласованного объёма backend-сервиса по готовой нормативной документации: инвентаризация требований, зависимый план, динамический выбор профильных implementation-скилов, реализация всех слоёв и процессов, тесты, полные проверки, независимые аудиты и исправление замечаний до общего Definition of Done. Использовать, когда пользователь просит реализовать сервис, возможность или комплект требований полностью либо «сделать всё сразу». Не использовать для проектирования отсутствующих требований, локальной правки одного однозначного компонента или только аудита без реализации.
- ▌ Python Fastapi HTTP Endpoint Writing · nemagu bundleИспользуй при реализации или правке обычных HTTP endpoint-ов на FastAPI: routers, внешних Pydantic request/response-моделей, path/query/header/cookie параметров, transport validation, caller identity, явных mappings в публичные application-входы и результаты, пагинации, идемпотентности и OpenAPI. Не применять для WebSocket/SSE, сборки API-процесса, application/domain-логики, Unit of Work и исходящих адаптеров.
- ▌ Cqrs Application Documentation Writing · nemagu bundleПроектирование и ведение аналитической документации application-слоя с CQRS в сервисах с гексагональной архитектурой: пользовательских и системных команд, запросов, входных и выходных DTO, портов, авторизации, транзакционных границ, application-ошибок и составных сценариев. Использовать для сбора требований и создания или дополнения Markdown-спецификаций application-операций и пайплайнов. Не использовать для описания доменных инвариантов, транспортных контрактов, реализации кода или восстановления требований из кода.
- ▌ Message Consumer Documentation Writing · nemagu bundleПроектирование, создание, адаптация и ревью аналитической Markdown-документации входящих сообщений presentation-слоя: источника и адресации, envelope и payload, доверия, преобразования в application-вход, исходов обработки, повторной доставки, идемпотентности, порядка, свежести и совместимости. Использовать для NATS, Kafka, очередей и других message consumer-контрактов без привязки к клиентской библиотеке. Не использовать для publisher-адаптеров, runtime фонового процесса, application/domain-контрактов или реализации consumer-а.
- ▌ Python Cqrs Application Layer Writing · nemagu bundleИспользуй при реализации или правке прикладного слоя в Python-проекте по гексагональной архитектуре с CQRS. Триггеры — добавление или изменение заданного use case, команды, запроса, DTO, порта, UnitOfWork, преобразования ошибок и механизма version/outbox в `application/`. Не применять для определения требований и слоёв `domain/`, `infrastructure/`, `presentation/`.
- ▌ Documentation Improvement Orchestrator · nemagu bundleСквозная проверка и доработка нормативной документации до готовности к реализации: инвентаризация области, динамический выбор профильных documentation-writing скилов, независимый аудит качества, исправление однозначных замечаний и повторение audit/fix цикла. Использовать, когда пользователь просит проверить и довести документ, комплект требований или документацию сервиса до согласованного состояния. Обязательно запрашивать у пользователя отсутствующие продуктовые и архитектурные решения и не угадывать их. Не использовать для проверки реализации, написания кода или только read-only аудита без исправлений.
- ▌ Hexagonal Service Documentation Writing · nemagu bundleПроектирование структуры и координация аналитической документации сервисов с гексагональной архитектурой: определение бизнес-контекстов, терминологии, границ ответственности, связей, состава документов, распределения требований между слоями и кратких паспортов неочевидных адаптеров. Использовать для первичного интервью, документирования сервиса целиком и проверки согласованности документов разных слоёв. Не использовать как основной навык для подробного проектирования отдельного слоя, восстановления требований из кода или проверки реализации.
- ▌ Python Nats Jetstream Consumer Writing · nemagu bundleИспользуй при реализации или правке входящего NATS JetStream consumer на Python через nats-py: выбор владения и подготовки stream/subjects и durable consumer, повтор подписки при отсутствующей топологии, pull consumer, envelope и payload, mapping в application-вход, bounded concurrency, backpressure, ACK/NAK/TERM, логирование обработки, in-progress, redelivery, reconnect, идемпотентность и необязательный DLQ. Не применять для publisher, общего runtime процесса, исходящих адаптеров и application/domain-логики.
- ▌ Background Process Documentation Writing · nemagu bundleПроектирование, создание и ревью аналитической Markdown-документации фоновых процессов сервиса: периодических задач, постоянно работающих внутренних циклов, запуска application-операций, расписания, перекрытия запусков, тайм-аутов, политики ошибок, lifecycle, остановки, готовности, heartbeat и наблюдаемости. Использовать до реализации scheduler-а или background worker-а и при описании его ожидаемого поведения. Не использовать для HTTP API, message consumer-контрактов, реализации runtime, выбора библиотек или определения domain/application-логики.
- ▌ Presentation Layer Documentation Writing · nemagu bundleКоординация аналитической Markdown-документации presentation-слоя в сервисах с гексагональной архитектурой: определение внешних точек входа, границ ответственности, владельцев контрактов, связей с application-слоем и выбор специализированного скила для HTTP API или входящих сообщений. Использовать при проектировании presentation-слоя целиком, распределении требований между документами и проверке межтранспортной согласованности. Не использовать как основной скил для подробного описания HTTP endpoint-ов, message consumer-ов, фоновых процессов, исходящих адаптеров или реализации кода.
- ▌ Python Psycopg Yoyo Persistence Writing · nemagu bundleИспользуй при реализации или ревью PostgreSQL persistence-адаптеров на Python через psycopg и миграций через yoyo. Триггеры — репозитории, mapping строк БД в domain или DTO порта, одиночное и пакетное чтение/сохранение, optimistic locking, PostgreSQL Unit of Work и его фабрика, connection manager и pool, безопасный SQL, создание и изменение таблиц, ограничений, индексов и других объектов схемы миграциями yoyo. Не применять для определения application-портов, доменных правил, публичных API-контрактов и хранилищ на других технологиях.
- ▌ Python Pydantic Settings Config Writing · nemagu bundleИспользуй при реализации или правке типизированной конфигурации Python-сервиса в infrastructure через pydantic-settings и pydantic: top-level settings worker-а, вложенных технологических блоков, YAML/env/custom sources, загрузчика CONFIG_FILE, строгой валидации, file-based secrets, startup preflight и примеров конфигурации. Не применять для domain/application-логики, реализации runtime-клиентов и presentation worker-ов.
- ▌ Documentation Implementation Consistency Review · nemagu bundleПроверка соответствия реализации нормативной документации проекта с анализом подтверждающих тестов и записью расхождений в `.review/documentation-consistency.md`. Использовать для полного или ограниченного аудита требований, контрактов и реализованного поведения без изменения кода или документации. Не использовать для проектирования документации, восстановления требований из кода или непосредственного исправления замечаний.
- ▌ Python Background Worker Runtime Writing · nemagu bundleИспользуй при реализации или правке общего runtime фоновых процессов на Python: lifecycle ресурсов и его логирование, asyncio.TaskGroup, fail-fast задач, stop event, heartbeat, readiness, обработка SIGTERM/SIGINT, graceful shutdown и коды завершения. Не применять для расписания конкретной операции, NATS, HTTP, application/domain-логики и технологических адаптеров.
- ▌ Service Observability Documentation Writing · nemagu bundleПроектирование, создание и ревью аналитической Markdown-документации наблюдаемости сервиса. Сейчас использовать для согласования logging-контракта: общих полей и формата, значимых логируемых ситуаций API и отдельных worker-процессов, уровней, идентификаторов, ошибок, безопасности и контроля объёма. Не применять для реализации logging, выбора системы сбора, метрик или трассировки.
- ▌ Python Periodic Application Worker Writing · nemagu bundleИспользуй при реализации или правке периодической фоновой задачи на Python, которая владеет собственным циклом и вызывает заданную application-операцию по fixed-delay, fixed-rate или явно заданной задержке по результату: stop-aware ожидание, timeout, политика ошибок, progress heartbeat, readiness, логирование итогов итераций и отсутствие перекрывающихся запусков. Не применять для общего lifecycle процесса, NATS, HTTP, реализации application/domain-логики, портов и адаптеров.
- ▌ Python Nats Jetstream Publisher Adapter Writing · nemagu bundleИспользуй при реализации или правке исходящего NATS JetStream publisher-адаптера на Python через nats-py и Pydantic: реализация application-порта, явный mapping DTO в transport-модель, маршрутизация, сериализация, headers, PubAck, типизированные ошибки и безопасное создание stream или добавление subject. Не применять для воркеров, consumer-ов, outbox, Unit of Work и application/domain-логики.
- ▌ Postgresql Persistence Adapter Documentation Writing · nemagu bundleПроектирование и ведение аналитической Markdown-документации PostgreSQL persistence-адаптера в сервисах с гексагональной архитектурой: application-портов, mapping, Unit of Work, транзакций, optimistic locking, ошибок, миграционных пакетов, таблиц, колонок, ограничений, связей и обоснованных индексов. Использовать при создании, адаптации или ревью паспорта PostgreSQL-адаптера и схемы БД, особенно когда каждая физическая таблица должна иметь отдельный файл и таблицу колонок, а изменения схемы — версионированные каталоги. Не использовать для реализации кода или SQL/yoyo-миграций, определения domain/application-требований, других типов хранилищ и общей документации репозитория.