Справочник
Глоссарий
Все термины OpenSpec — по одному в строке.
OpenSpec использует слова, которые в git, CI и инструментах для агентов означают другое. В каждой строке указано значение термина в OpenSpec. Последний столбец содержит ссылки на дополнительные сведения, где они доступны.
| Термин | Определение | Подробнее |
|---|---|---|
| Применение | Реализация задач из предложения об изменении. Навык: openspec-apply-change. | Применение изменения |
| Архивирование | Завершение предложения об изменении: его дельты объединяются с основными спецификациями, а его папка перемещается в openspec/changes/archive/. | Быстрый старт |
| Артефакт | Документ планирования внутри предложения об изменении: proposal.md, дельта-спецификации, design.md, tasks.md. Не является результатом сборки. | Артефакты |
| Возможность | Отдельная область поведения вашей системы. Для каждой существует одна спецификация по пути openspec/specs/<capability>/spec.md. | Возможности |
| Предложение об изменении | Отдельная единица работы: папка в openspec/changes/<name>/, содержащая артефакты планирования. Часто сокращается до «изменения». Не является коммитом git. | Создание предложения |
| Команда | Вводимая вручную точка входа в процесс. Написание зависит от инструмента (/opsx:propose, /opsx-propose). В документации процессы вместо этого называются по навыкам. | Поддерживаемые инструменты |
| Продолжение | Создание следующего артефакта планирования для существующего предложения об изменении. Навык: openspec-continue-change. | Навыки |
| Способ установки | То, как устанавливаются процессы: в виде навыков, команд или и того и другого. | Настройка проекта |
| Дельта-спецификация | Спецификация внутри предложения об изменении, в которой под заголовками ADDED, MODIFIED, REMOVED и RENAMED перечислено только то, что меняется. | Дельта-спецификации |
| Исследование | Проработка идеи с агентом до создания предложения. Код не пишется. Навык: openspec-explore. | Проработка идеи |
| Ускоренное создание | Создание за один проход предложения об изменении со всеми артефактами планирования, готового к реализации. Навык: openspec-ff-change. Не является операцией fast-forward в git. | Навыки |
| Устаревший процесс | Команды /openspec:*, использовавшиеся до OPSX. | |
| Цикл | Цикл, через который проходит предложение об изменении: исследование, создание предложения, рассмотрение, применение, архивирование. | Быстрый старт |
| Основные спецификации | Дерево openspec/specs/: текущее согласованное поведение вашей системы. При архивировании дельты объединяются с ним. Если у возможности ещё нет спецификации, она создаётся на основе её требований ADDED. | Архивирование |
| Корень OpenSpec | Дерево openspec/, которое определяет команда и с которым она работает: в вашем репозитории или в хранилище. | Хранилища |
| OPSX | Текущая система процессов OpenSpec и устанавливаемый ею префикс команд (/opsx:). | |
| Профиль | Какие процессы устанавливает init: core или custom. | Профили |
| Создание предложения | Создание предложения об изменении и генерация всех его артефактов планирования за один шаг. Навык: openspec-propose. | Быстрый старт |
| Реестр | Список зарегистрированных хранилищ на уровне компьютера, находящийся в registry.yaml. Не является реестром пакетов. | CLI |
| Требование | Поведение, которое должна обеспечивать система; записывается с использованием SHALL: ### Requirement: в спецификации. | Дельта-спецификации |
| Сценарий | Проверяемый пример в рамках требования, записанный в форме WHEN/THEN. | Дельта-спецификации |
| Схема | Определение того, какие артефакты создаёт предложение об изменении и в каком порядке. Не JSON Schema. | Схемы |
| Навык | Инструкции процесса, установленные там, где их считывает ваш инструмент ИИ (.agents/skills/, ...). | Навыки |
| Спецификация | Файл по пути openspec/specs/<capability>/spec.md, описывающий текущее поведение одной возможности. | Архивирование |
| spec-driven | Схема по умолчанию: предложение, затем дельта-спецификации, затем дизайн, затем задачи. | spec-driven |
| Хранилище | Автономный репозиторий OpenSpec, зарегистрированный на вашем компьютере, для планирования, охватывающего несколько репозиториев. Не хранилище данных. | Хранилища (бета) |
| Синхронизация | Объединение реализованных дельт с основными спецификациями без архивирования. Навык: openspec-sync-specs. | Навыки |
| Шаблон | Начальное содержимое, которое схема предоставляет каждому артефакту. | Схемы |
| Обновление | В качестве навыка (openspec-update-change): пересмотр артефактов планирования предложения об изменении. В качестве команды CLI (openspec update): обновление установленных файлов OpenSpec. | Обновление изменения, CLI |
| Проверка | Проверка соответствия реализации артефактам предложения об изменении перед архивированием. Навык: openspec-verify-change. | Навыки |
| Процесс | Именованное действие OpenSpec (создание предложения, применение, архивирование, ...), устанавливаемое в ваш инструмент ИИ как навык или команда. | Настройка проекта |
| Рабочий набор | Личная локальная группа папок, открываемых вместе в одном инструменте. Не хранилище, и ничего не используется совместно. | Рабочие наборы (бета) |