From ce62ddc70432e9b5768f21112738b578e64965f3 Mon Sep 17 00:00:00 2001 From: zosimovaa Date: Mon, 12 Oct 2026 09:45:21 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D1=8F?= =?UTF-8?q?=20=D0=BF=D0=BE=D0=B4=D0=BA=D0=BB=D1=8E=D1=87=D0=B5=D0=BD=D0=B8?= =?UTF-8?q?=D1=8F=20=D0=B4=D0=BB=D1=8F=20=D0=BD=D0=B5=D1=81=D0=BA=D0=BE?= =?UTF-8?q?=D0=BB=D1=8C=D0=BA=D0=B8=D1=85=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA?= =?UTF-8?q?=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/README.md b/README.md index b55cd9c..6d42772 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,7 @@ поведения; подробные правила схемы находятся в [README схемы](openspec/schemas/use-case-driven/README.md). + ## Чем отличается от `spec-driven` - В базовой схеме сценарии оформляются краткими шагами Gherkin `WHEN` / `THEN`. @@ -19,6 +20,70 @@ - Инструкции и пояснительный текст ориентированы на русский язык; технические идентификаторы и синтаксис OpenSpec сохраняются. +## Подключение схемы в проектах + +Схему можно подключить один раз для всех проектов пользователя. OpenSpec ищет +пользовательские схемы в `~/.local/share/openspec/schemas` на macOS и Linux, +а в `%LOCALAPPDATA%\openspec\schemas` на Windows. Если задана переменная +`XDG_DATA_HOME`, OpenSpec использует `$XDG_DATA_HOME/openspec/schemas` вместо +стандартного пути. + +1. Клонируйте этот репозиторий в удобную папку. Путь к клону можно выбрать + самостоятельно. +2. В пользовательской папке схем создайте ссылку с именем `use-case-driven`, + ведущую на `openspec/schemas/use-case-driven` внутри клона. + +### macOS и Linux + +Команды учитывают `XDG_DATA_HOME`, если он задан. Замените путь в `ln -s` на +путь к своему клону: + +```sh +schemas_dir="${XDG_DATA_HOME:-$HOME/.local/share}/openspec/schemas" +mkdir -p "$schemas_dir" +ln -s "/path/to/openspec-schema/openspec/schemas/use-case-driven" \ + "$schemas_dir/use-case-driven" +``` + +### Windows PowerShell + +Замените путь в `$schemaSource` на путь к своему клону. Junction создаёт ссылку +на папку без копирования файлов: + +```powershell +$schemasDir = if ($env:XDG_DATA_HOME) { + Join-Path $env:XDG_DATA_HOME 'openspec\schemas' +} else { + Join-Path $env:LOCALAPPDATA 'openspec\schemas' +} +$schemaSource = 'D:\path\to\openspec-schema\openspec\schemas\use-case-driven' +New-Item -ItemType Directory -Force -Path $schemasDir +New-Item -ItemType Junction -Path (Join-Path $schemasDir 'use-case-driven') -Target $schemaSource +``` + +После этого изменения схемы в клоне сразу доступны всем проектам, в которых +указано `schema: use-case-driven`. Проверьте подключение из каталога проекта: + +```sh +openspec schema which use-case-driven +openspec schema validate use-case-driven +``` + +Если в проекте есть собственная схема `openspec/schemas/use-case-driven`, она +имеет приоритет над пользовательской. + +Команды создания ссылки предполагают, что путь назначения ещё не занят. Если +там уже есть папка или ссылка `use-case-driven`, сначала проверьте её содержимое +и источник, прежде чем заменять. + +В текущей схеме инструкции также ссылаются на дополнительные файлы по путям +относительно проекта, например +`openspec/schemas/use-case-driven/validate_format.py` и `patterns/`. Одна +пользовательская ссылка делает схему и шаблоны доступными OpenSpec, но не +создаёт эти пути внутри каждого проекта. Для таких файлов потребуется отдельная +проектная ссылка либо адаптация инструкций к расположению активной схемы. + + ## Статус Схема находится в стадии доработки. Описаны ещё не все типы функциональных