LeanSpec CLI
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
- 300 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI и агент создают и меняют файлы спецификаций в проекте, а веб-интерфейс запускает локальный сервер.
Установка
- Работает в
Ручная установка
npm install -g @leanspec/cli && leanspec initПервая команда из раздела Quick Start. Нужен Node.js 20 или новее.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI и агент создают и меняют файлы спецификаций в проекте, а веб-интерфейс запускает локальный сервер.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
LeanSpec ведет разработку по спецификациям: спека описывает фичу до кода, а агент реализует ее по тексту. Команда `leanspec init` создает проект, спеки лежат в каталоге `specs` как markdown с метаданными: статус, приоритет, теги, исполнитель, зависимости `depends_on` и `related`. По этим файлам работают `leanspec board` (канбан), `leanspec stats` (метрики и узкие места), `leanspec search` и `leanspec validate`, а `leanspec ui` открывает веб-интерфейс на `localhost:3000`. Тот же набор доступен агентам через MCP-сервер `@leanspec/mcp` и скилл `leanspec`. Скилл объясняет, когда писать спеку, а когда сразу писать код, и как найти существующие спеки до создания новой. Размер спеки держат ниже 2 тысяч токенов, чтобы не перегружать контекст.
Для кого. Командам, которые ведут задачи для агентов в markdown или хотят подключить GitHub Issues как источник спецификаций.
Подходит, если
- Крупную фичу сначала описывают спекой, а потом отдают агенту на реализацию.
- Спеки разрослись, и агент теряет контекст на длинных документах.
- Статус и приоритет задач хотят видеть на канбан-доске прямо из терминала.
- Агенту подключают MCP-сервер, чтобы он искал и создавал спеки сам.
- Спеки связаны зависимостями, и нужно понять, какие блокируют другие.
Не подходит, если
- Задача мелкая и решается одной правкой без описания.
- Нужны готовые интеграции с Jira или Linear: провайдеры для них пока только в планах.
- В проекте уже заведен другой процесс со спеками, и второй формат лишь запутает команду.
Пример запроса к агенту
Создай спеку для фичи экспорта в CSV, свяжи ее с уже существующей спекой про отчеты и покажи доску через `leanspec board`.Ограничения
Из провайдеров спецификаций работает только `markdown` с локальным каталогом `specs`. Провайдеры GitHub Issues и Azure DevOps в таблице README отмечены как планируемые, Jira и Linear как будущие. Нужны Node.js 20 или новее и pnpm 10 или новее, а для сборки CLI из исходников еще Rust 1.70. Последний коммит в репозитории — май 2026. Настольное приложение вынесено в отдельный репозиторий `codervisor/lean-spec-desktop`, а часть документации доступна на китайском.
Как отключить. Удалите пакет командой `npm uninstall -g @leanspec/cli`, уберите запись `leanspec` из конфигурации MCP и скилл из каталога скиллов агента. Каталог `specs` и файл `leanspec.provider.yaml` останутся в проекте.
Частые вопросы
Как установить LeanSpec и начать работу?
Выполните `npm install -g @leanspec/cli && leanspec init`. Команда создаст каталог `specs` и конфигурацию, а `npx -p @leanspec/cli leanspec init --example dark-theme` развернет учебный проект.
Как подключить LeanSpec к Claude Code или Cursor?
Добавьте в конфигурацию MCP сервер `leanspec` с командой `npx` и аргументом `@leanspec/mcp`. Дополнительно скилл ставится командой `npx skills add codervisor/leanspec@leanspec`.
Где хранятся спецификации?
В каталоге `specs` как markdown-файлы, имя каталога задает `directory` в `leanspec.provider.yaml`. Статус, приоритет и теги лежат в метаданных файла.
Что дает скилл leanspec агенту?
Правила процесса: когда писать спеку, а когда реализовать сразу, как искать существующие спеки до создания новой и как держать их компактными. Весь цикл описан как Discover, Design, Implement, Validate.
Можно ли вести спеки в GitHub Issues?
Пока нет. Провайдер `github` в README отмечен как планируемый, рабочий вариант только `markdown`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
MCP-сервер для разработки по спецификациям: требования, дизайн и задачи по шагам, с веб-дашбордом и расширением для VS Code
CLI для разработки по спецификациям: агент ведет задачу через файлы в репозитории от плана до проверки и архива
ProductSpec задает формат продуктовой спецификации, а скиллы, CLI и MCP-сервер ведут агента по ней и проверяют итог
Разработка по спецификациям для кодовых агентов: сначала предложение, требования, дизайн и задачи, потом код
Spec-Driven Development MCP — промпты для разработки по спецификации
Spec-Driven Development MCP Server
Три MCP-промпта ведут агента от требований в формате EARS к документу дизайна и затем к коду приложения
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| LeanSpec (эта карточка) | нет | 300 | |
| Spec Kit | нет | 148 171 | соседняя карточка про разработку по спецификациям от GitHub; LeanSpec хранит спеки в markdown и добавляет доску, статистику и веб-интерфейс |
| OpenSpec | нет | 74 038 | другой инструмент для спецификаций; LeanSpec отличается ограничением размера спеки и единым интерфейсом CLI, MCP и веб-панели |
Коротко о README
Автор подает LeanSpec как фреймворк для любого бэкенда спецификаций и сравнивает его с Spec Kit, OpenSpec и Kiro на сайте проекта. Поддерживаемые агенты: VS Code Copilot, Claude Code, Gemini CLI, Cursor, Windsurf, Kiro CLI, Amp и другие.