SpecWeave CLI
CLI хранит спецификацию, задачи и доказательства готовности в git, чтобы Claude, Codex, Grok и Cursor передавали работу друг другу
- 171 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI создает и коммитит файлы в `.specweave/`, при включенной настройке делает автокоммиты и отправляет ветку командой handoff
- Команда review передает разницу кода другой модели у стороннего провайдера
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/specweaveОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI создает и коммитит файлы в `.specweave/`, при включенной настройке делает автокоммиты и отправляет ветку командой handoff
- Команда review передает разницу кода другой модели у стороннего провайдера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SpecWeave ставится командой `npm install -g specweave`, а `specweave init .` пишет в проект файл `AGENTS.md`, двухстрочный `CLAUDE.md` со ссылкой на него и скиллы для Claude Code и Codex. Фоновых процессов нет. Работа ведется приращениями: одна папка `.specweave/increments/NNNN-slug/` с файлом `spec.md` для людей и журналом `ledger.jsonl`, куда дописывает только CLI. Цикл состоит из шагов. Команда `/sw:increment` или `specweave create-increment` создает спецификацию с проблемой, объемом, критериями приемки, подходом и задачами. Затем `task claim` берет задачу, а `task done T-01 --run "<тест>"` отказывается закрывать задачу при падающем тесте и сохраняет доказательство в журнал. `specweave verify` прогоняет тесты, линтер и сборку, `specweave review` отдает разницу другой семье моделей, `specweave complete` закрывает приращение при зеленой проверке. Передача работы идет двумя словами: «hand off» вызывает `specweave handoff`, снимает ваши заявки на задачи и отправляет ветку со снимком незакоммиченных правок, а «pick up» в другом инструменте продолжает с того же места. Память проекта лежит в `.specweave/memory/` и ездит вместе с кодом.
Для кого. Командам и одиночным разработчикам, которые ведут задачу по очереди в Claude Code, Codex, Grok или Cursor и хотят общую спецификацию и журнал в git.
Подходит, если
- Задачу начинает один агент, а заканчивает другой, и нужен общий список задач с критериями приемки
- Закрытие задачи должно отклоняться, если команда `--run` с тестом падает
- Решения и договоренности проекта надо хранить в `.specweave/memory/` рядом с кодом, вне чата
- Ревью разницы поручают другой семье моделей командой `specweave review`
- В существующем монорепозитории надо зарегистрировать соседние проекты через `--workspace`, ничего не перенося
Не подходит, если
- Правка в одну строку: полный цикл с приращением, задачами и проверкой для нее избыточен
- Нет Node.js 20.12.0 или новее: CLI на него опирается
- Нужен только один агент и заметки в чате: общая спецификация в git ничего не добавит
Пример запроса к агенту
Создай приращение «экспорт отчета в CSV» командой specweave create-increment, возьми первую задачу и закрой ее только после зеленого тестаОграничения
CLI требует Node.js 20.12.0 или новее и ставится глобально через npm. Версия 3.0 убрала скиллы `brainstorm` и `team`, их заменяют шаг решений в `increment`, интервью `grill-me` и параллельные дорожки в `do`. Старые приращения с `tasks.md` продолжают работать. Команда `specweave review` отдает разницу другой семье моделей, значит, код уходит стороннему провайдеру по вашему ключу. Автокоммит приращений включают отдельной настройкой `git.autoCommitIncrement`, по умолчанию он выключен. Опциональные скиллы `sync`, `project` и `jev` ставятся по обнаружению трекера или настройки.
Как отключить. Удалите каталог `.specweave/`, строки со ссылкой из `CLAUDE.md` и `AGENTS.md` и скиллы `sw-*` из `.claude/skills/`. Сам CLI снимает `npm uninstall -g specweave`.
Частые вопросы
Как поставить SpecWeave для Claude Code?
Выполните `npm install -g specweave`, затем `specweave init .` в корне проекта. Команда добавит `AGENTS.md`, короткий `CLAUDE.md` и скиллы, которые отвечают на `/sw:increment`, `/sw:do`, `/sw:done`.
Что значит «hand off» и «pick up»?
Первое вызывает `specweave handoff`: снимает ваши заявки на задачи, пишет причину остановки и отправляет ветку с копией незакоммиченных правок. Второе вызывает `specweave pickup` в другом инструменте и показывает открытое приращение и следующую задачу.
Как SpecWeave определяет, что задача готова?
Команда `specweave task done` с флагом `--run` запускает ваш тест и при падении отказывается закрывать задачу. Успешный результат попадает в `ledger.jsonl` как доказательство.
Чем SpecWeave отличается от Spec Kit?
Spec Kit ставит в проект команды разработки от спецификации. SpecWeave добавляет журнал доказательств в git, общую память, передачу работы между агентами и проверку другой моделью.
Можно ли подключить существующие репозитории?
Да. Команда `specweave --workspace ./planning get ../existing-api --json` регистрирует соседний или вложенный репозиторий без переноса файлов. Предварительный просмотр дает флаг `--dry-run`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыFeatherSpec ведет разработку от спецификации к плану и коду в Claude Code и Copilot: 13 команд /sdd и память в Markdown
Скилл ведет долгую задачу как пакет с проверяемыми шагами и состоянием на диске, чтобы продолжить ее в новой сессии.
CLI spxa и набор скиллов для разработки по спецификациям в Claude Code, Codex и Cursor: от предложения изменения до архива
Методология и CLI разработки по единой спецификации: скиллы ставятся в проект и ведут агента от идеи до проверенного кода
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Плагин из трех скиллов для крупных задач разработки: анализ проекта, разбивка на фазы с задачами в GitHub Issues, параллельные агенты и ревью кода
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| SpecWeave (эта карточка) | нет | 171 | |
| Spec Kit | нет | 149 434 | набор GitHub с командами разработки от спецификации, а здесь журнал доказательств, память проекта и передача работы между агентами |
| OpenSpec | нет | 74 686 | цикл предложения, требований и задач, а здесь закрытие задач с проверкой тестом и ревью другой моделью |
Коротко о README
README начинается с установки и строки о том, что `init` пишет в проект. Дальше идут настольное приложение SpecWithCode на основе CLI, подключение уже существующих репозиториев, передача работы между инструментами и таблица шести шагов цикла. Затем сравнение с Projects в Claude Code, семь основных и четыре необязательных скилла и инструкция по переходу на 3.0.