OSpec CLI
CLI для разработки по спецификациям: агент ведет задачу через файлы в репозитории от плана до проверки и архива
- 390 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Глобальная установка обновляет скиллы агентов; инициализация и обновление меняют документы и настройки проекта
- Команда с флагом `--apply` дописывает хуки в `.claude/settings.json` и меняет поведение Claude Code
- В режиме goal агент запускает субагентов пакетами и выполняет команды проверки, в том числе тесты проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ospecОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Глобальная установка обновляет скиллы агентов; инициализация и обновление меняют документы и настройки проекта
- Команда с флагом `--apply` дописывает хуки в `.claude/settings.json` и меняет поведение Claude Code
- В режиме goal агент запускает субагентов пакетами и выполняет команды проверки, в том числе тесты проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OSpec связывает требования, работу агента и приемку через файлы в репозитории. Для обычного изменения команда `change` создает предложение, список задач и записи проверки. Другая сессия может прочитать эти материалы и восстановить ход работы без полного архива чата. Режим `goal` предназначен для задач с дизайном, планом и несколькими исполнителями. Он хранит граф задач и результаты ревью, а исполнителей запускает текущий агент через возможности своего клиента. Сам CLI готовит план запуска; отдельные процессы агентов он не поднимает. Инициализация добавляет каталог `.ospec` и документы проекта. Для Claude Code можно отдельно включить хуки, которые проверяют состояние процесса перед запуском субагентов. Проверка и архивирование завершают изменение, но сами по себе не доказывают корректность реализации.
Для кого. Для разработчиков и команд, которые ведут задачи через Claude Code, Codex, Gemini или OpenCode и хотят хранить требования, планы и доказательства проверки в репозитории.
Подходит, если
- Нужно провести требование, правку документации или багфикс от предложения до архива с проверяемыми файлами
- Нужно дать крупной задаче план, независимое ревью и тесты, прежде чем ее признают готовой
- Нужно передавать работу между агентами или сессиями так, чтобы контекст лежал в репозитории, а не в чате
- Нужно дать агенту, который входит в проект, краткую сводку об активных изменениях и следующей безопасной команде
- Нужно, чтобы документы о функциях проекта указывали на код и агент читал только нужный раздел
Не подходит, если
- Правка в одну строку: набор файлов `proposal.md`, `tasks.md`, `verification.md` и `review.md` потребует больше времени, чем сама правка
- Клиент не умеет запускать собственные субагенты: полный режим `goal` в таком случае завершает диспетчеризацию ошибкой
- Нужна работа без новых файлов в проекте: `init` создает `.skillrc` и каталог `.ospec` с документацией и состоянием
Пример запроса к агенту
`/ospec-change` создай изменение для этого требования и доведи его до проверки: исправить таймаут при входе в админкуОграничения
Документация требует Node.js 18 и npm 8 или новее. Глобальная установка npm сразу пытается обновить скиллы Codex и Claude Code и удалить устаревшие управляемые записи. Это происходит до инициализации проекта; ошибка синхронизации может оставить CLI установленным без готовых скиллов.
Языки создаваемых документов: `en-US`, `zh-CN`, `ja-JP` и `ar`; русского в списке нет. Команда `update` обновляет проектные файлы, но не версию npm-пакета. Модель обрабатывает исходники и планы по условиям выбранного клиента, а ее вызовы расходуют его лимиты.
Как отключить. Удалите CLI командой `npm uninstall -g @clawplays/ospec-cli`. Скиллы `ospec`, `ospec-change` и `ospec-goal` лежат в `~/.codex/skills/` и `~/.claude/skills/`, удалите эти папки. В проекте уберите `.skillrc` и каталог `.ospec`. Если ставили хуки для Claude Code, удалите записи из `.claude/settings.json`: сами файлы хуков лежат в `.ospec/hooks/claude/`.
Частые вопросы
Как установить OSpec для Claude Code и Codex?
Выполните `npm install -g @clawplays/ospec-cli` и проверьте `ospec --help`. Затем в проекте запустите `ospec init .` или напишите агенту «/ospec initialize this project». Установщик пытается синхронизировать скиллы в `~/.codex/skills/` и, при наличии `~/.claude`, в `~/.claude/skills/`. Проверьте результат: ошибка синхронизации может не прервать установку пакета. Явная установка: `ospec skill install ospec-goal` для Codex и `ospec skill install-claude ospec-goal` для Claude Code.
Чем `ospec change` отличается от `ospec goal`?
`ospec change` держит файлы `proposal.md`, `tasks.md`, `state.json`, `verification.md` и `review.md` и остается легким путем, как бы ни была велика задача. `ospec goal` добавляет `design.md`, `implementation-plan.md`, граф задач, артефакты исполнителей и ревьюеров и доказательства проверки. Выбор между ними делает пользователь, инструмент его не меняет.
Как продолжить работу после прерванной сессии OSpec?
Команда `ospec session` пишет `.ospec/session-brief.md`: активные и отложенные изменения и следующая безопасная команда. Ход цели показывает `ospec loop status --brief`, а после подтвержденной потери сессии `ospec loop recover --force` освобождает только незавершенные элементы.
Какие агенты запускают субагентов в режиме goal?
Документация описывает нативные механизмы Codex, Claude Code, Gemini и OpenCode. Наличие нужного механизма в вашей среде нужно проверить отдельно. При его отсутствии план не будет автоматически выполнен через другой агентский CLI.
Как закрыть изменение после приемки?
Сначала пройдите принятые в проекте деплой, тесты и приемку, затем выполните `ospec verify changes/active/<имя>` и `ospec finalize changes/active/<имя>`. Финализация перестраивает индексы и переносит изменение в архив. Режим `--force-archive` требует точное имя изменения и причину и помечает архив как принудительный и неполный.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыРазработка по спецификациям для кодовых агентов: сначала предложение, требования, дизайн и задачи, потом код
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
CLI spxa и набор скиллов для разработки по спецификациям в Claude Code, Codex и Cursor: от предложения изменения до архива
Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
CLI ведет AI-кодинг от идеи до ревью по цепочке требований, плана, кода и проверок, а следы хранит в репозитории.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| OSpec (эта карточка) | нет | 390 | |
| sudocode | нет | 296 | слой памяти и координации, где спецификации и задачи хранятся в git |
| Goal Workflow | нет | 299 | набор скиллов Claude Code от PRD до слияния pull request, без отдельного CLI |
Коротко о README
Проект распространяется по MIT и разделяет активные, отложенные и архивные изменения. Краткая сводка сессии помогает выбрать следующую команду, когда работа возобновляется после паузы.