Установка

Предварительные требования

• Node.js версии 20.19.0 или новее — проверьте версию: node --version

Установка с помощью ИИ-ассистента

Не хотите выполнять эти действия вручную? Вставьте приведённую ниже инструкцию в любой ассистент для программирования, умеющий запускать команды оболочки, например Claude Code, Codex, Cursor, Gemini CLI, Copilot или другие поддерживаемые инструменты. Ассистент установит CLI, инициализирует проект и сообщит, что именно было сделано.

Ручные шаги ниже — источник истины; инструкция лишь выполняет их за вас. Если ассистент остановится и попросит вас продолжить, это предусмотрено: перед действиями с повышенными привилегиями он запрашивает разрешение и никогда не изменяет файлы запуска оболочки. Выполните оставшиеся шаги самостоятельно, воспользовавшись разделами Менеджеры пакетов и Устранение неполадок.

Установи OpenSpec в этот проект и настрой его. Выполняй шаги по порядку и
останавливайся там, где это указано.

1. СРЕДА ВЫПОЛНЕНИЯ. Выполни `node --version`. Для OpenSpec требуется Node.js
   версии 20.19.0 или новее. Если Node.js не установлен или его версия ниже,
   сообщи об этом и остановись — не устанавливай Node.js, не переключай версии
   и не перенастраивай мой менеджер версий.

2. УСТАНОВКА. Используй менеджер пакетов, уже доступный в PATH; предпочтителен npm:
     npm install -g @fission-ai/openspec@latest
     pnpm add -g @fission-ai/openspec@latest
     bun add -g @fission-ai/openspec@latest
     yarn global add @fission-ai/openspec@latest   (Yarn 1.x only)
   Не выбирай менеджер по lock-файлу проекта: глобальная установка не связана с
   тем, как устанавливаются зависимости этого репозитория. Если ни один из этих
   четырёх менеджеров недоступен, остановись и сообщи мне — не придумывай другой
   способ установки. (Если я использую Nix, укажи вместо этого раздел Nix в
   документации по установке OpenSpec.)
   Покажи точную команду и дождись моего подтверждения перед выполнением:
   программа устанавливается за пределами проекта, и я могу захотеть поручить
   глобальную установку другому менеджеру пакетов.
   Если для установки нужны sudo или права администратора, возникла ошибка
   доступа либо сообщается, что глобальный каталог бинарных файлов отсутствует
   или не настроен, остановись и снова спроси меня. Никогда не изменяй файлы
   запуска моей оболочки (.bashrc, .zshrc, .profile, fish, профиль PowerShell)
   и не запускай команды настройки, которые редактируют их за меня: покажи
   изменение и предоставь мне возможность внести его самостоятельно.

3. PATH. Выполни `openspec --version`. Если команда не найдена, возможно,
   она просто недоступна в текущей оболочке: сообщи, куда менеджер пакетов
   установил программу и как добавить этот каталог в PATH для моей оболочки
   и ОС, а затем дождись моего подтверждения. Если отображается версия старее
   только что установленной, значит, более ранняя копия перекрывает её в PATH:
   сообщи обе версии и не продолжай. Если я использую менеджер версий, укажи
   на это вместо изменения PATH: при использовании nvm или fnm CLI привязана
   к активной на момент установки версии Node.js, а для asdf или volta может
   потребоваться обновить shim.

4. ИНИЦИАЛИЗАЦИЯ. Спроси, каким инструментом или инструментами для программирования
   с ИИ я пользуюсь, и сопоставь каждый из них с идентификатором из
   `openspec init --help` (для Copilot это `github-copilot`, для Zoo Code —
   `roocode`). Параметр `--tools` принимает список, разделённый запятыми,
   поэтому укажи все инструменты.
   Команда `openspec init --tools <ids>` автоматически и без запроса удаляет
   остатки файлов от старых версий OpenSpec, в том числе файлы запросов
   `opsx-*.md` в моей домашней папке (Codex хранит их в ~/.codex/prompts).
   Перед запуском поищи их: каталоги `.../commands/openspec/`, блоки OpenSpec
   в файлах вроде CLAUDE.md или AGENTS.md и запросы `opsx-*.md` в домашнем
   каталоге. Перечисли всё найденное и дождись моего разрешения. Если ничего
   не найдено, сообщи об этом и продолжай без запроса. Наличие каталога
   `openspec/` не является проблемой: команда init обновит его, не затрагивая
   мои спецификации и изменения.
   Также проверь, что я нахожусь в нужной папке: команда init создаёт
   `openspec/` в текущем каталоге, в том числе внутри пакета монорепозитория.
   Затем выполни: openspec init --tools <ids>

5. ОТЧЁТ. Не предполагай, что должно существовать, — сообщи, что именно вывела
   команда init: сколько навыков и/или команд создано и где, строку о файле
   конфигурации, возможное примечание «Требуется настройка» и то, что нужно
   перезапустить или перезагрузить. Некоторые инструменты используют только
   навыки и корректно создают ноль файлов команд, поэтому отсутствие команд
   само по себе не является ошибкой. Если команда init сообщила, что ничего
   не создано, передай предложенный способ исправления, а не запускай её снова.
   В завершение объясни, как вызвать OpenSpec в выбранном инструменте. Возьми
   точное написание из созданных файлов, а не из строки-резюме: пунктуация
   зависит от инструмента (/opsx:propose в одних, /opsx-propose в других,
   @opsx-propose в Amazon Q); инструменты, использующие навыки вместо команд,
   вызывают их по имени навыка (/openspec-propose, $openspec-propose в Codex
   или /skill:openspec-propose в Kimi Code).

Инструкция не привязана к конкретному поставщику: это обычные указания и те же команды, что описаны на этой странице. Она работает в macOS, Linux и Windows и намеренно останавливается, а не импровизирует, когда требуется ваше разрешение. Ассистент должен уметь запускать команды оболочки — некоторые интеграции с IDE этого не умеют.

Менеджеры пакетов

npm

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

pnpm

pnpm add -g @fission-ai/openspec@latest

yarn

yarn global add @fission-ai/openspec@latest

В Yarn 2 и более поздних версиях (Berry) команда global удалена. В этих версиях установите OpenSpec с помощью npm, pnpm или bun: глобальный CLI не обязан использовать тот же менеджер пакетов, что и проект.

deno

Deno иногда не может обработать тег @latest, но при первоначальной установке можно указать версию. В этом случае попробуйте заменить @latest номером версии, например @^1.3.1.

deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest
# or
deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@^1.3.1

Примечание: если подкоманды запускают внешние инструменты, например config edit, feedback или workspace open, может понадобиться точечное разрешение --allow-run=<program>.

bun

Bun может установить OpenSpec глобально, но сейчас OpenSpec работает на Node.js. Node.js версии 20.19.0 или новее всё равно должна быть доступна в PATH.

bun add -g @fission-ai/openspec@latest

Nix

Запускайте OpenSpec напрямую, без установки:

nix run github:Fission-AI/OpenSpec -- init

Или установите его в свой профиль:

nix profile install github:Fission-AI/OpenSpec

Или добавьте его в среду разработки в flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    openspec.url = "github:Fission-AI/OpenSpec";
  };

  outputs = { nixpkgs, openspec, ... }: {
    devShells.x86_64-linux.default = nixpkgs.legacyPackages.x86_64-linux.mkShell {
      buildInputs = [ openspec.packages.x86_64-linux.default ];
    };
  };
}

Проверка установки

openspec --version

Обновление

Обновите пакет, а затем обновите сгенерированные файлы в каждом проекте:

npm install -g @fission-ai/openspec@latest   # or pnpm/yarn/bun equivalent
openspec update                              # run inside each project

Команда openspec update повторно создаёт файлы навыков и команд для настроенных инструментов, чтобы slash-команды соответствовали установленной версии. Она также проверяет, не выпущена ли новая версия CLI, и предлагает обновиться: именно обновление позволяет использовать новые рабочие процессы. См. Справочник по CLI.

Удаление

Команды openspec uninstall нет, поскольку OpenSpec — это глобальный пакет и несколько файлов в проекте. Удаление выполняется вручную в несколько шагов и не затрагивает исходный код.

1. Удалите глобальный пакет:

npm uninstall -g @fission-ai/openspec   # or: pnpm rm -g / yarn global remove / bun rm -g

2. Удалите OpenSpec из проекта (необязательно). Если спецификации и изменения больше не нужны, удалите каталог openspec/:

rm -rf openspec/

Прежде чем делать это, подумайте: openspec/specs/ и openspec/changes/archive/ хранят сведения о поведении системы и причинах изменений. Если эта история может понадобиться, оставьте каталог (или сохраните его в git) даже после удаления OpenSpec.

3. Удалите сгенерированные файлы ИИ-инструментов (необязательно). OpenSpec записывает файлы навыков и команд в каталоги отдельных инструментов, например .claude/skills/openspec-*/, .cursor/commands/opsx-* и другие. Удалите навыки openspec-* и команды opsx-* для настроенных инструментов. Точные пути для каждого инструмента приведены в разделе Поддерживаемые инструменты.

Если в файлах вроде CLAUDE.md или AGENTS.md есть блоки-маркеры OpenSpec, удалите их вручную; остальное ваше содержимое в этих файлах можно оставить.

Следующие шаги

После установки инициализируйте OpenSpec в проекте:

cd your-project
openspec init

Полное руководство см. в разделе Начало работы.