OpenSpec

Рабочие наборы (бета) ​

Откройте хранилище и репозитории, которые его используют, в одном окне редактора, чтобы ваш агент видел и то, и другое.

При использовании хранилища контекст, необходимый вашему агенту, разделён по папкам. Спецификации и изменения находятся в хранилище, а код — в каждом репозитории. Агент, запущенный в одном репозитории, может читать и искать (grep) только в этом репозитории и больше нигде, поэтому он работает, имея лишь половину картины.

Рабочие наборы — это утилита, которую OpenSpec предоставляет для этого. Рабочий набор — это сохранённый именованный список папок, которые вы открываете вместе. На этой странице предполагается, что хранилище уже настроено и зарегистрировано на вашей машине. Хранилища (бета) описывает это.

Как это работает ​

  • Что это такое: именованный список папок, сохранённый только на вашей машине. В папки-участники ничего не записывается и ничего не коммитится.
  • Что делает открытие: OpenSpec генерирует файл .code-workspace из списка и запускает ваш редактор с ним. Каждая папка-участник находится в одном окне.
  • Что вы получаете: поиск вашего редактора и любой агент, запущенный внутри этого окна, могут читать каждую папку-участник. Агент может выполнять grep по спецификациям хранилища и коду репозитория за один сеанс.
  • Что это не меняет: какую папку openspec/ использует команда. Это по-прежнему определяется в разделе Где создаются артефакты.

Настройка ​

  1. Сохраните рабочий набор (один раз на машину). Укажите репозиторий и хранилище как участников, а также инструмент для их открытия:

    bash
    # save a named list of folders you open together
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Saved workset 'platform' (2 members) to your machine.
Open it any time with: openspec workset open platform

  2. Открывайте его каждый раз, когда начинаете работу:

    bash
    # open every member in one VS Code window
openspec workset open platform

openspec workset list показывает, что вы сохранили, а openspec workset remove <name> удаляет рабочий набор, не затрагивая папки-участники:

yaml
platform  (opens in VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Использование: одно изменение, две папки ​

Допустим, изменение add-login находится в хранилище team-plans, а код для него — в web-app. Откройте рабочий набор platform и попросите вашего агента реализовать изменение. За один сеанс он может:

  • читать team-plans/openspec/changes/add-login/ и спецификации рядом с ним
  • редактировать код в web-app/
  • запускать команды openspec из web-app

Без рабочего набора агент видит только ту папку, в которой он был запущен.

Инструменты из коробки ​

  • VS Code (--tool code) и Cursor (--tool cursor): встроены. Каждый открывает одно окно со всеми папками-участниками.
  • Claude Code и Codex в терминале: временно отключены как открыватели рабочих наборов, пока этот процесс перерабатывается. --tool claude или --tool codex завершается ошибкой, которая сообщает об этом и указывает на VS Code или Cursor.
  • Другие редакторы: добавьте их в разделе openers в Настройках CLI (config.json).