OpenSpec

Установка

npm install -g @fission-ai/openspec@latest
openspec init

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

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 и сгенерированные файлы скиллов и команд из папок агентов в проекте.

Проверка безопасности

• CLI записывает файлы скиллов и команд в папки агентов проекта
• На этапе apply агент меняет код по списку задач

Коротко о README

README показывает цикл explore, propose, apply, archive на примере темной темы и формат спецификаций: требования со сценариями WHEN и THEN в обычном Markdown. Установка через npm, после нее openspec init в проекте. Отдельно описаны stores для командной работы в нескольких репозиториях, сравнение со Spec Kit и Kiro, обновление и отключение телеметрии. Поддерживается больше 30 инструментов, лицензия MIT.

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.

Похожие