OpenSpec

Установка ​

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

  • Node.js 20.19.0 или выше — Проверьте вашу версию: node --version

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

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

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

text
Install OpenSpec in this project and set it up for me. Follow these steps in
order, and stop where a step tells you to stop.

1. RUNTIME. Run `node --version`. OpenSpec needs Node.js 20.19.0 or higher. If
   Node is missing or older, say so and stop — don't install Node, switch
   versions, or reconfigure my version manager for me.

2. INSTALL. Use whichever package manager is already on my PATH, preferring 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)
   Don't pick based on this project's lockfile — a global install has nothing to
   do with how this repo's own dependencies are installed. If none of those four
   is available, stop and tell me — don't improvise an install. (If I'm on Nix,
   point me at the Nix section of the OpenSpec installation docs instead.)
   Show me the exact command and let me confirm before you run it; this installs
   software outside the project, and I may want a different package manager to
   own it.
   Stop and ask me again if the install needs sudo or admin rights, fails with a
   permissions error, or reports that its global bin directory is missing or
   unconfigured. Never edit my shell startup files (.bashrc, .zshrc, .profile,
   fish, PowerShell profile), and never run a setup command that edits them for
   me — show me the change and let me make it.

3. PATH. Run `openspec --version`. If the command isn't found, it may just be
   missing from this shell: tell me where the package manager installed it and
   how to add that directory to PATH for my shell and OS, then stop until I
   confirm. If it prints an older version than the one the install just
   reported, an earlier copy is shadowing it on PATH — tell me both versions
   instead of continuing. If I use a version manager, say so rather than editing
   PATH around it: with nvm or fnm the CLI is tied to the Node version that was
   active when you installed it, and with asdf or volta a shim may need
   regenerating.

4. INITIALIZE. Ask me which AI coding tool or tools I use and map each to an id
   from `openspec init --help` (Copilot is `github-copilot`, Zoo Code is
   `roocode`). `--tools` takes a comma-separated list, so name all of them.
   `openspec init --tools <ids>` deletes leftovers from older OpenSpec versions
   automatically, without asking — including `opsx-*.md` prompt files in my home
   directory (Codex keeps them in ~/.codex/prompts). Before you run it, look for
   those: `.../commands/openspec/` folders, OpenSpec marker blocks in files like
   CLAUDE.md or AGENTS.md, and home-directory `opsx-*.md` prompts. List whatever
   you find and wait for my go-ahead; if you find nothing, say so and carry on
   without asking. An existing `openspec/` folder is not a problem — init
   refreshes it and leaves my specs and changes alone.
   Confirm I'm in the right folder too: init creates `openspec/` wherever it
   runs, including inside a monorepo package.
   Then run: openspec init --tools <ids>

5. REPORT. Don't assume what should exist — tell me what init actually printed:
   how many skills and/or commands it created and where, the config file line,
   any "Setup required" note, and what to restart or reload. Some tools are
   skills-only and correctly create zero command files, so missing commands is
   not a failure on its own. If init said nothing was generated, relay the fix
   it suggested instead of retrying. Finish by telling me how to invoke OpenSpec
   in my tool, and take the exact spelling from the files init created rather
   than from its summary line: the punctuation differs per tool (/opsx:propose
   in some, /opsx-propose in others, @opsx-propose in Amazon Q), and tools that
   get skills instead of commands are invoked by skill name (/openspec-propose,
   or $openspec-propose in Codex, or /skill:openspec-propose in Kimi Code).

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

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

npm ​

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

pnpm ​

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

yarn ​

bash
yarn global add @fission-ai/openspec@latest

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

deno ​

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

bash
deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest
# или
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

Примечание: Если ваши подкоманды запускают внешние инструменты, такие как редактирование конфигурации, обратная связь или открытие рабочей области, вам может потребоваться scoped флаг --allow-run=<program>.

bun ​

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

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

Nix ​

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

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

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

bash
nix profile install github:Fission-AI/OpenSpec

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

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 ];
    };
  };
}

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

bash
openspec --version

Обновление ​

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

bash
npm install -g @fission-ai/openspec@latest   # или аналог для pnpm/yarn/bun
openspec update                              # выполните внутри каждого проекта

openspec update перегенерирует файлы навыков (skills) и команд для настроенных вами инструментов, поэтому ваши слэш-команды остаются актуальными относительно установленной версии. Она также проверяет, была ли опубликована новая версия CLI, и предлагает обновиться, поскольку именно обновление делает новые рабочие процессы доступными — см. Справочник CLI.

Удаление ​

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

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

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

2. Удалите OpenSpec из проекта (необязательно). Удалите директорию openspec/, если больше не хотите хранить её спецификации и изменения:

bash
rm -rf openspec/

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

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

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

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

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

bash
cd your-project
openspec init

См. Начало работы для полного руководства.