specx CLI
CLI проверяет архитектуру Python-сервиса по документированным правилам, а скиллы учат агента писать код в этих рамках.
- 199 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Генерирует проект и запускает проверки в рабочем каталоге.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/specxОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Генерирует проект и запускает проверки в рабочем каталоге.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
specx дает кодинг-агентам общую архитектуру для Python-бэкендов и проверяет, что реализация ее соблюдает. Команда `specx init` создает небольшой сервис без привязки к фреймворку: uv, Ruff, `mypy`, `pytest`, сборка зависимостей и зеркальные тесты. Типизированные базовые классы задают роли для сценариев использования, сервисов, контроллеров, репозиториев, шлюзов и DTO. Команда `specx check` ловит утечки между слоями, неверное наследование, скрытое владение транзакциями, неправильно размещенные типы и расхождение тестов, причем у каждого правила есть стабильный задокументированный ID. Отдельно ставятся скиллы, которые покрывают структуру проекта, основное поведение, FastAPI, внедрение зависимостей, хранение данных, настройки, миграции и тесты.
Для кого. Python-разработчики, которые пишут бэкенд с агентом и хотят автоматически удерживать слои и роли классов.
Подходит, если
- Новый сервис на Python стартует с агентом, и нужна строгая стартовая структура.
- Агент добавляет сценарий использования, а проверка должна поймать утечку между слоями.
- Нужно добавить FastAPI-доставку, миграции или слой хранения по единому образцу.
- CI должен падать на нарушении архитектурных правил с понятными кодами.
Не подходит, если
- Проект не на Python.
- Команда уже приняла другую архитектуру и не готова подстраиваться под предложенные роли.
- Нужна быстрая одноразовая утилита без слоев.
Пример запроса к агенту
Создай сервис `order-service` через `specx init`, добавь сценарий оформления заказа и прогони `specx check`.Ограничения
Инструмент жестко навязывает свою архитектуру: существующий код под нее придется приводить, а правила `specx check` не отключаются мелкими настройками. CLI ставится через uv, скиллы через Node.js командой `npx skills add`. Скиллы устанавливаются отдельно от CLI и не обновляются вместе с ним. Генерация сервиса подходит для новых проектов, перенос старых требует ручной работы. Лицензия MIT. Последний коммит датирован августом 2026 года.
Как отключить. Удалите CLI командой `uv tool uninstall specx`, а скиллы уберите из каталога скиллов агента. Созданные проекты остаются обычным Python-кодом.
Частые вопросы
Как установить specx?
Выполните `uv tool install specx` в изолированном окружении. Обновление: `uv tool upgrade specx`.
Как поставить скиллы?
Командой `npx skills add maksimzayats/specx --skill '*' --agent codex -y` ставится весь каталог для Codex. Другие агенты описаны в руководстве по установке скиллов.
Что создает specx init?
Небольшой нейтральный к фреймворку сервис с uv, Ruff, `mypy`, `pytest`, сборкой зависимостей и зеркальными тестами.
Что ловит specx check?
Утечки слоев, неверное наследование, скрытое владение транзакциями, неправильно размещенные типы и расхождение тестов. У каждого правила есть стабильный ID.
Подходит ли для FastAPI?
Да, среди скиллов есть доставка через FastAPI, но сам стартовый сервис не привязан к фреймворку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл учит агента запускать datamodel-codegen и получать модели Pydantic из OpenAPI, JSON Schema и GraphQL
Скилл FastAPI
FastAPI skill
Официальный скилл FastAPI, который поставляется вместе с пакетом и учит агента писать код под установленную версию
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
builder-skills — скиллы для приложений на Convex
builder-skills
17 скиллов учат агента писать приложения на Convex по документации и вести проект через PRD, task.md и журнал изменений
Скилл расспрашивает о проекте и пишет рабочий Django с актуальными пакетами, настройками и CI по свежим справочникам.
Архитектура Laravel API
Laravel API Production-Ready Architecture Skill
Скилл, который удерживает агента в слоистой архитектуре Laravel API: JSON:API v1.1, строгие типы, PHPStan level 8 и тесты
Коротко о README
README представляет возможности, установку CLI и скиллов и быстрый старт с созданием сервиса. Подробные правила, руководства и ссылки собраны на сайте документации.