fspec CLI
Терминальная среда и CLI для разработки по спецификациям: Gherkin, доска задач и несколько агентов в Rust.
- 104 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Встроенные агенты выполняют команды и правят файлы с правами вашей учетной записи.
- Режим демона и мост в Telegram открывают удаленное управление сессиями.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/sengac/fspec/main/scripts/install.sh | bashСкрипт для macOS и Linux ставит бинарный файл в ~/.local/bin. Для Windows есть install.ps1, готовые бинарные файлы лежат на странице релизов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Встроенные агенты выполняют команды и правят файлы с правами вашей учетной записи.
- Режим демона и мост в Telegram открывают удаленное управление сессиями.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
fspec собирает в одном терминальном приложении агентов для кода, живую доску задач и исполняемые спецификации. Требования хранятся рядом с кодом: основы проекта, рабочие единицы, карты примеров, доменные модели и сценарии Gherkin со связями на тесты и места реализации. Связи можно аудировать, а переход задачи между стадиями проходит через проверки. Приложение можно запускать целиком или использовать как набор команд для своего агента. Команда `fspec init --agent=claude` или `--agent=codex` ставит в проект описание процесса и команду `/fspec` для Claude Code либо `/prompts:fspec` для Codex, после чего агент управляет спецификациями через CLI. Есть работа нескольких сессий с отдельными рабочими деревьями Git, чтение предыдущих разговоров, правила на команды и доступ к файлам, подключение MCP, демон для долгих сессий и отдельный мост в Telegram.
Для кого. Командам, которые пишут код с агентами и хотят держать требования, тесты и реализацию связанными в самом репозитории.
Подходит, если
- Задача начинается с примеров поведения, которые надо превратить в сценарии Gherkin.
- Несколько агентов работают над разными задачами, и каждому нужно свое рабочее дерево Git.
- Агент Claude Code или Codex должен вести спецификации через команды, а не файлы вручную.
- Нужно проверить, что у каждого сценария есть тест и место реализации.
Не подходит, если
- Проект маленький, и процесс со стадиями и проверками замедлит работу.
- Нужна изоляция: агенты работают с правами вашей учетной записи, а песочницу надо настраивать отдельно.
- Недопустима установка скриптом через `curl`: используйте готовый бинарный файл со страницы релизов.
Пример запроса к агенту
Запусти `/fspec`, заведи рабочую единицу для экспорта в CSV, составь примеры и сценарии Gherkin и свяжи их с тестами.Ограничения
Агенты выполняются с правами файловой системы, оболочки и сети учетной записи, под которой запущен fspec, поэтому для настоящей изоляции нужна песочница уровня ОС или контейнера. Правила на команды и файлы, контрольные точки и рабочие деревья помогают управлять изменениями, но не заменяют резервные копии и ревью. Полный доступ по RPC требует подходящего демона, а подключение MCP-хоста имеет собственные ограничения транспорта и авторизации. Установочный скрипт скачивает и запускает код, перед запуском его стоит просмотреть. Для сборки из исходников нужны Rust, компилятор и `protoc`.
Как отключить. Удалите бинарный файл fspec из `~/.local/bin` и файлы, которые создал `fspec init`, включая команду `/fspec` в каталоге агента. Спецификации лежат в репозитории и остаются.
Частые вопросы
Как подключить fspec к Claude Code?
В папке проекта выполните `fspec init --agent=claude`, затем в Claude Code вызовите `/fspec`. Команда загрузит `fspec bootstrap`, и агент сможет вести спецификации через CLI.
Как обновить fspec?
Выполните `fspec update --check`, а затем `fspec update`. Загрузчик проверяет контрольную сумму и заменяет бинарный файл на месте.
Есть ли доступ по MCP?
Да, `fspec client --mcp` отдает инструменты сервиса по stdio. Для полного RPC нужен подходящий демон, ограничения описаны в `docs/CLIENT_MCP.md`.
Как ограничить действия агентов?
Настройте правила блокировки и разрешения на команды и файлы, они описаны в `docs/BLOCKLIST.md`. Для настоящей изоляции используйте песочницу ОС или контейнер.
Какие платформы поддерживаются?
Есть готовые бинарные файлы и установщики для macOS, Linux и Windows PowerShell. Сборка из исходников нужна только для доработки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI для разработки по спецификациям: агент ведет задачу через файлы в репозитории от плана до проверки и архива
FeatherSpec ведет разработку от спецификации к плану и коду в Claude Code и Copilot: 13 команд /sdd и память в Markdown
Методология и CLI разработки по единой спецификации: скиллы ставятся в проект и ведут агента от идеи до проверенного кода
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
Коротко о README
Документ рассказывает о возможностях, установке, режиме внешнего агента, безопасности и сборке. Подробные темы вынесены в `docs/`, а мост в Telegram лежит в папке `bridge`.