Skip to content

Обзор ​

Варианты настройки OpenSpec.

OpenSpec поддерживает несколько вариантов настройки. На этой странице показано, что изменяет каждый из них и когда его использовать.

Что можно настроить ​

ПараметрЧто изменяетКогда использовать
ПрофилиКакие рабочие процессы установлены и в каком виде: как навыки, команды или и то, и другоеВы хотите добавить дополнительные рабочие процессы и шаблоны работы или удалить ненужные рабочие процессы
Конфигурация проектаИнструкции, добавляемые в каждый запуск рабочего процесса: контекст, правила и руководство по операциям (config.yaml)Вы хотите, чтобы изменения планировались по-вашему, например, чтобы задачи всегда включали тесты Playwright
СхемыЧто создаёт OpenSpec: артефакты, их порядок и шаблоныИзменения должны создавать другие файлы планирования, разделы или форматы

Не уверены, что использовать? ​

Конфигурация и схемы — это два уровня настройки. Выбирайте в зависимости от того, насколько глубоко вы хотите вмешаться:

  • Начните с конфигурации проекта: она проще, и для большинства проектов этого достаточно. Вы сохраняете стандартные артефакты и добавляете поверх свой контекст и правила.
  • Создайте ответвление схемы, когда добавления недостаточно: конфигурация только дополняет основной рабочий процесс. Она может добавить правило вроде «задачи всегда включают тесты», но не может удалить документ проектирования или переименовать файл. Это территория схем. Создание ответвления даёт вам собственную копию для редактирования.

Здесь «ответвление» означает команду openspec schema fork, а не создание ответвления репозитория git. Подробности см. в разделе Схемы.

flowchart LR
    a["Рабочие процессы должны знать мой стек и соглашения"] --> config
    b["Одному артефакту нужно дополнительное правило, например задачи всегда включают тесты"] --> config
    c["Другие артефакты, имена файлов или структура документов"] --> schema
    d["Встроенные инструкции описывают то, что моя команда делает по-другому"] --> schema
    config["Конфигурация проекта<br/>(config.yaml)"]
    schema["Создание ответвления схемы<br/>(openspec schema fork)"]