OpenSpec — воркфлоу
Разработка по спецификациям для кодовых агентов: сначала предложение, требования, дизайн и задачи, потом код
- 73 280 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI записывает файлы скиллов и команд в папки агентов проекта
- На этапе apply агент меняет код по списку задач
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add workflows/openspecОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI записывает файлы скиллов и команд в папки агентов проекта
- На этапе apply агент меняет код по списку задач
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenSpec добавляет в проект папку openspec/ со спецификациями и отдельной папкой на каждое изменение. CLI ставит в выбранные агенты скиллы и слэш-команды: /opsx:explore для обсуждения идеи, /opsx:propose для создания proposal.md, дельты спецификаций, design.md и tasks.md, /opsx:apply для реализации по задачам и /opsx:archive для переноса изменений в основные спецификации. Расширенный профиль добавляет пошаговые команды new, continue, ff, verify и bulk-archive. Для команд есть режим stores: спецификации живут в отдельном репозитории и читаются агентами из нескольких кодовых баз.
Для кого. Для разработчиков и команд, которые хотят согласовать план с агентом до того, как он начнет менять код.
Подходит, если
- Фича затрагивает несколько модулей и нужен письменный план перед реализацией
- Требования теряются в истории чата и агент делает не то
- Нужно вести спецификации в существующем проекте, а не только в новом
Не подходит, если
- Мелкая правка на пару строк, где спецификация займет больше времени, чем код
- Команда уже ведет требования в другой системе и не готова дублировать их в репозитории
Пример запроса к агенту
/opsx:propose добавить темную тему с учетом системной настройкиОграничения
Нужен Node.js 20.19.0 или новее. Авторы рекомендуют модели с сильным рассуждением и чистый контекст перед реализацией. CLI собирает анонимную статистику по названиям команд, ее отключают через openspec config set telemetry.enabled false или OPENSPEC_TELEMETRY=0. Режим stores пока в бете.
Как отключить. Удалите пакет командой npm uninstall -g @fission-ai/openspec и сгенерированные файлы скиллов и команд из папок агентов в проекте.
Частые вопросы
Как называются команды в разных агентах?
Каноническое имя /opsx:propose, в Cursor и GitHub Copilot это /opsx-propose, в Codex $openspec-propose. openspec init выводит правильную форму для выбранных инструментов.
Как обновить инструкции после обновления пакета?
Выполните openspec update в каждом проекте, команда перегенерирует скиллы и слэш-команды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВоркфлоуНабор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Два скилла для разработки от спецификации: /spec задает вопросы и сохраняет документ в specs/, /spec-impl реализует утвержденную спецификацию по шагам
MCP-сервер для разработки по спецификациям: требования, дизайн и задачи по шагам, с веб-дашбордом и расширением для VS Code
Плагин из трех скиллов для крупных задач разработки: анализ проекта, разбивка на фазы с задачами в GitHub Issues, параллельные агенты и ревью кода
Сохраняет историю работы с кодовыми агентами, синхронизирует ее и превращает диалоги в переиспользуемые скиллы
Плагины Claude Code для разработки от спецификации: команды specify, implement, review и агенты-специалисты
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Из блога
Коротко о README
README показывает цикл explore, propose, apply, archive на примере темной темы и формат спецификаций: требования со сценариями WHEN и THEN в обычном Markdown. Установка через npm, после нее openspec init в проекте. Отдельно описаны stores для командной работы в нескольких репозиториях, сравнение со Spec Kit и Kiro, обновление и отключение телеметрии. Поддерживается больше 30 инструментов, лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: openspec-propose description: Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation. allowed-tools: Bash(openspec:*) license: MIT compatibility: Requires openspec CLI. metadata: author: openspec version: "1.0" --- Propose a new change - create the change and generate all artifacts in one step. **Planning boundary**: This workflow creates planning artifacts only. The user request that selected or triggered this workflow authorizes planning only, even if it asks to build or fix something. Do not edit project code. After the planning artifacts are complete, stop. Do not start implementation in the same response, even if the initial request asks for it. Wait for a new user request after the artifacts are presented; then start the apply workflow. I'll create a change with the artifacts your schema defines. With the default spec-driven schema that is: - proposal.md (what & why) - `specs/<capability-path>/spec.md` (what the system must do - a delta, not the main spec) - design.md (how) - tasks.md (implementation steps) `<capability-path>` is the spec directory relative to `specs/` (for example, `user-auth` or `identity/user-auth`). Preserve an existing capability's full path and follow the project's established organization for new capabilities. When the user is ready to implement, they must start the apply workflow explicitly.