Specsfy CLI
Методология и CLI разработки по единой спецификации: скиллы ставятся в проект и ведут агента от идеи до проверенного кода
- 88 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Специалист деплоя управляет серверами через Ansible и Docker Swarm, а `./deploy run --non-interactive` выполняет выкатку без вопросов с внешним паролем Vault.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/specsfyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Специалист деплоя управляет серверами через Ansible и Docker Swarm, а `./deploy run --non-interactive` выполняет выкатку без вопросов с внешним паролем Vault.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Specsfy строит разработку вокруг единой исполняемой спецификации и держит требования, тесты и код в одном проверяемом контуре. Девиз проекта: «Especifique. Prove. Entregue.» (специфицируй, докажи, отгрузи). CLI `specsfy` устанавливает в проект скиллы методологии и по запросу технические специализации. Агент идет шагами: `$specsfy-01-inbox` сохраняет исходную формулировку в `specs/inbox/`, `$specsfy-02-backlog` превращает ее в пронумерованный пункт, дальше скиллы ведут к спецификации, тестам и коду. Команды CLI: `specsfy doctor --project .` проверяет окружение, `specsfy install --project .` ставит скиллы, `specsfy update` обновляет скиллы проекта, `specsfy upgrade` обновляет сам CLI. В проекте на GitHub Spec Kit скилл `$specsfy-setup` читает `.specify/memory/constitution.md` и каталог `specs/` и пишет мост `.specsfy/SPECKIT.md`, не трогая исходные файлы. Есть специалист `specsfy-specialist-deploy` для выпуска и продакшена в Docker Swarm.
Для кого. Командам, которые пишут продукт вместе с агентом и хотят, чтобы спецификация, тесты и код оставались согласованными и проверяемыми.
Подходит, если
- Идею сначала фиксируют во входящих, затем доводят до бэклога и спецификации без размазывания по plan.md и tasks.md
- Проект уже ведется на GitHub Spec Kit, и нужен мост к методологии без переноса файлов
- Скиллы методологии нужно поставить и обновлять в проекте командами `specsfy install` и `specsfy update`
- Релиз и серверы Docker Swarm ведут через специалиста деплоя с инвентарем Ansible
Не подходит, если
- Небольшая правка или прототип: полный цикл от входящих до спецификации займет больше времени, чем сама работа
- Нужен только готовый общий набор скиллов без методологии и бэклога
- Нет Node.js 22.20 и новее: CLI требует эту версию
Пример запроса к агенту
Используй $specsfy-01-inbox и сохрани идею: страница /boas-vindas приветствует посетителя по имениОграничения
Нужны Node.js 22.20 или новее, npm и команда `skills` либо `npx`. Документация и скиллы написаны по-португальски, пример в руководстве использует Laravel и Pest. Если репозиторий приватный, а README оговаривает такой случай, нужна однократная авторизация `gh auth login`, а в автоматизации задают `GH_TOKEN` или `GITHUB_TOKEN` с правом чтения. Для запуска деплоя агентом команда `./deploy configure-vault` готовит внешний пароль Vault, и `./deploy run --non-interactive` использует его без вопросов: выдавайте такой доступ осознанно. Версия фреймворка, CLI и скиллов едина.
Как отключить. Удалите пакет командой `npm uninstall --global @promovaweb/specsfy` и поставленные в проект скиллы, а файлы `specs/` и `.specsfy/` оставьте или удалите по необходимости.
Частые вопросы
Как установить Specsfy?
Выполните `npm install --global @promovaweb/specsfy`, затем в папке проекта `specsfy doctor --project .` и `specsfy install --project .`. Версия проверяется командой `specsfy --version`.
Как обновить скиллы и сам CLI?
Скиллы проекта обновляет `specsfy update --project .`, а сам CLI `specsfy upgrade`.
Что делает скилл $specsfy-01-inbox?
Сохраняет исходную формулировку в `specs/inbox/` файлом с датой, временем и слагом. Он не задает вопросов, не создает бэклог и не меняет код.
Работает ли Specsfy вместе со Spec Kit?
Да. Скилл `$specsfy-setup` читает `.specify/memory/constitution.md` и каталог `specs/` и публикует мост `.specsfy/SPECKIT.md`, исходные артефакты остаются на месте.
Может ли агент сам выкатывать релизы?
Только если вы настроили `./deploy configure-vault`: тогда `./deploy run --non-interactive` использует внешний пароль Vault без вопросов. Ручной деплой продолжает запрашивать пароль.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
Терминальная среда и CLI для разработки по спецификациям: Gherkin, доска задач и несколько агентов в Rust.
CLI хранит спецификацию, задачи и доказательства готовности в git, чтобы Claude, Codex, Grok и Cursor передавали работу друг другу
CLI spxa и набор скиллов для разработки по спецификациям в Claude Code, Codex и Cursor: от предложения изменения до архива
Коротко о README
README представляет монорепозиторий с методологией, специализациями, CLI, документацией и примером, дает установку через npm и `specsfy install`, описывает мост со Spec Kit, деплой с Ansible и Vault и сборку материалов бренда.