spec-first CLI
CLI ведет AI-кодинг от идеи до ревью по цепочке требований, плана, кода и проверок, а следы хранит в репозитории.
- 110 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- `spec-first init` записывает управляемые файлы агента в репозиторий, а `spec-work` меняет исходный код по плану.
- Входы коммита и отправки PR работают только при вашем разрешении.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/spec-firstОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `spec-first init` записывает управляемые файлы агента в репозиторий, а `spec-work` меняет исходный код по плану.
- Входы коммита и отправки PR работают только при вашем разрешении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
spec-first превращает сессии AI-кодинга в проверяемые изменения внутри репозитория. Команда `spec-first init` генерирует для выбранного агента входы `spec-*`, а сами рабочие процессы запускают в сессии агента: `spec-brainstorm` собирает требования, `spec-plan` готовит план реализации, `spec-work` выполняет его, `spec-code-review` проверяет изменения. Планы, задачи, проверки и знания остаются в `docs/` проекта. `docs/plans/` хранит требования и планы, `docs/solutions/` проверенные решения, `docs/validation/` доказательства проверок. Агент не объявляет задачу выполненной на слово: завершение подтверждают команды, коды выхода и логи.
Для кого. Командам, которые пишут код с Claude Code, Codex или Cursor и хотят сохранять намерения, планы и доказательства проверок между сессиями и агентами.
Подходит, если
- Идея сырая, и ее нужно превратить в требования через `spec-brainstorm`.
- Планы и решения теряются между сессиями или при переходе с Codex на Claude Code.
- Код ревьюят по diff или PR, и нужны находки с пробелами в проверках.
- Тесты падают, причина неясна, и в ход идет `spec-debug` с доказательством исправления.
- Проверенные решения копят в `docs/solutions/`, чтобы переиспользовать их позже.
Не подходит, если
- Нужен одноразовый промпт без артефактов в репозитории.
- Политика запрещает хранить файлы процесса в репозитории.
- Требуется отдельная IDE или центральный движок процессов.
- Выбор приоритетов продукта и архитектуры хотят поручить инструменту.
Пример запроса к агенту
Запусти `spec-brainstorm "Добавить импорт конфигурации в CLI"` и покажи требования до написания плана.Ограничения
Нужны Node.js 20 или новее, npm, Git и хотя бы один поддерживаемый агент. Основная поддержка у Claude Code и Codex, остальные агенты работают в режиме предварительной проверки. Входы `spec-*` — команды внутри сессии агента, в оболочке их не запустить, и `spec-first` для них только готовит файлы. После `init` агента нужно перезапустить, иначе он не увидит новые входы. Основная документация на китайском, английская версия лежит в `README.en.md`.
Как отключить. Выполните `spec-first clean`, чтобы убрать сгенерированные файлы выбранного агента, затем `npm uninstall -g spec-first`. Каталог `docs/` с планами и знаниями остается вашим.
Частые вопросы
Как начать работу со spec-first?
Выполните `npm install -g spec-first`, затем в корне Git-репозитория `spec-first quickstart`. Мастер проверит Node.js, Git и установленные агенты. После выбора агента перезапустите его, чтобы он увидел входы.
Какие агенты поддерживаются?
Основная поддержка у Claude Code и Codex. Kiro, Qoder, ZCode и Pi идут как предварительные, Cursor и OpenCode помечены как `generated_runtime_preview`.
Чем `spec-brainstorm` отличается от `spec-plan`?
`spec-brainstorm` превращает сырую идею в документ требований. `spec-plan` готовит план реализации, когда требования уже ясны, и тогда `spec-brainstorm` можно пропустить.
Что делать, если агент не видит входы `spec-*`?
Выполните `spec-first doctor --verbose`: команда покажет факты о среде и состоянии генерации. Затем сверьтесь с каталогом возможностей агентов в `docs/catalog/runtime-capabilities.md`.
Делает ли `init` коммиты?
Нет. `spec-first init` показывает предпросмотр управляемых файлов перед записью, не добавляет файлы в индекс git и ничего не коммитит.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
CLI для разработки по спецификациям: агент ведет задачу через файлы в репозитории от плана до проверки и архива
Скилл-оркестратор: по описанию идеи агент пишет требования и спецификацию, делит работу на таски, собирает проект и проверяет итог
Разработка по спецификациям для кодовых агентов: сначала предложение, требования, дизайн и задачи, потом код
Скилл расспрашивает про проект и пишет requirements.md, design.md и tasks.md, чтобы Claude Code и Cursor работали по одному плану
Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| spec-first (эта карточка) | нет | 110 | |
| spec-superflow | нет | 879 | плагин ведет одну задачу от согласованного объема до проверки; spec-first хранит цепочку от идеи до знаний в `docs/` и работает в восьми агентах |
| LeanSpec | нет | 300 | короткие спецификации в markdown и доска задач; spec-first добавляет планы, ревью и доказательства проверок |
Коротко о README
Цепочка идет так: идея, требования, план, задачи, код, ревью, знания. Принцип доверия сформулирован одной фразой: скрипты готовят факты, модель судит по смыслу, владелец проекта разрешает побочные эффекты.