diff --git a/openspec/config.yaml b/openspec/config.yaml index 9fb0945..63f2890 100644 --- a/openspec/config.yaml +++ b/openspec/config.yaml @@ -1,5 +1,7 @@ schema: use-case-driven +# При настройке проекта YouTrack добавьте в context строку: +# YouTrack project key: context: | ADR проекта хранятся в `openspec/context/adr/`. Перед проектированием и реализацией прочитай применимые ADR со статусом Accepted и следуй им. Если diff --git a/openspec/schemas/use-case-driven/README.md b/openspec/schemas/use-case-driven/README.md index c739b1f..1c734ba 100644 --- a/openspec/schemas/use-case-driven/README.md +++ b/openspec/schemas/use-case-driven/README.md @@ -147,6 +147,35 @@ Scenario в таких операциях не создаётся. В delta со заголовки FR master spec, на которые ведут автоматически созданные slugs. Для ссылок на неизменённые требования при проверке передай `--base `. +## Учёт change в YouTrack + +Каждый новый change, включая change с `skip_specs: true`, получает ровно одну +задачу типа Task в YouTrack-проекте соответствующего репозитория. Сначала +подготовь содержательный proposal с причиной, scope, capabilities и impact; +затем, до перехода к specs, design и tasks, создай задачу через подключённый +YouTrack MCP. Ключ проекта укажи в `context` файла `openspec/config.yaml`; добавь +строку `YouTrack project key: `. Если строки нет или ключ нельзя однозначно +проверить через MCP, уточни его у пользователя; проект `Default` не является +автоматическим запасным вариантом. Перед созданием прочитай схему обязательных +полей проекта и используй только допустимые значения. Не добавляй произвольное +верхнеуровневое поле `youtrack_project`: оно не входит в контракт OpenSpec. +В задаче укажи slug change и краткую цель, а её ключ и URL сохрани в разделе +`## YouTrack` файла `proposal.md`. При создании задачи также внеси work item с +фактически затраченным временем на подготовку контекста change и proposal. + +При каждом последующем редактировании proposal пересмотри заголовок и описание +задачи. Если изменились причина, scope, capabilities или impact, обнови связанную +задачу через MCP в соответствии с актуальным proposal; не создавай дубликат. +Если MCP недоступен, явно сообщи об этом и уточни дальнейшее действие. + +На всех этапах change — от подготовки proposal до реализации — записывай +фактически затраченное время в YouTrack как work items, используя поддерживаемый +проектом тип работы и не дублируя уже внесённые записи. При архивировании учти +всё оставшееся время, затем выполни `openspec archive`; после успешной архивации +переведи связанную задачу в конечный статус, предусмотренный YouTrack-проектом. +Определи поле и значение статуса по схеме проекта, не угадывай их. Change +завершён только после успешного архивирования и закрытия задачи. + Если смысловые коды или сообщения ещё не выдаются приложением, это явно фиксируется в FR вместе с соответствием текущим outcome, trace-статусам и exit codes. Форматирование спецификации само по себе не реализует этот контракт в приложении. diff --git a/openspec/schemas/use-case-driven/schema.yaml b/openspec/schemas/use-case-driven/schema.yaml index f45f106..3a3092d 100644 --- a/openspec/schemas/use-case-driven/schema.yaml +++ b/openspec/schemas/use-case-driven/schema.yaml @@ -43,6 +43,7 @@ artifacts: Для каждой создай delta spec по точному существующему пути внутри `openspec/specs/`. Оставь список пустым, если требования не меняются. - **Impact**: Затронутые участки кода, API, зависимости и системы. + - **YouTrack**: После создания задачи укажи её ключ и URL. ВАЖНО: раздел Capabilities задаёт связь между этапами proposal и specs. Перед его заполнением изучи существующие спецификации: выполни @@ -63,6 +64,26 @@ artifacts: (с тем же правилом для `--store`). Для каждой перечисленной capability потребуется соответствующий файл спецификации. + После подготовки содержательного первого варианта proposal создай для + каждого нового change, в том числе с `skip_specs: true`, ровно одну задачу + типа Task в YouTrack-проекте этого репозитория через подключённый YouTrack + MCP. Создай задачу до перехода к specs, design и tasks, используя причину, + scope и impact из proposal. Бери ключ проекта из `context` файла + `openspec/config.yaml`; в нём должна быть строка `YouTrack project key: `. + Если строка отсутствует или ключ нельзя однозначно проверить через MCP, + уточни его у пользователя. Проект `Default` не используй как запасной + вариант. Перед созданием проверь схему обязательных полей проекта; не выдумывай значения. + Укажи slug change и краткую цель в задаче, затем + заполни в proposal раздел YouTrack ключом и URL задачи. Добавь work item с + фактически затраченным до этого временем на подготовку контекста change и + proposal. + + При каждом последующем редактировании proposal пересмотри формулировки + заголовка и описания связанной YouTrack-задачи. Если причина, scope, + capabilities или impact изменились, обнови задачу через MCP так, чтобы они + соответствовали актуальному proposal; не создавай новую задачу. Если MCP + недоступен, сообщи об этом и уточни, как продолжить. + В каждом изменении (`change`) должна быть указана хотя бы одна новая или изменяемая capability либо явный отказ от спецификаций: `openspec validate` отклонит изменение без delta-спецификации, если в его `.openspec.yaml` не @@ -334,6 +355,12 @@ artifacts: Связывай задачи с Requirement ID, FR и кодами завершения, если задача затрагивает эти результаты. + YouTrack-задача из proposal сопровождает весь change и не заменяет + чекбоксы реализации в tasks.md. На всех этапах change — от подготовки + proposal до реализации — записывай в YouTrack фактически затраченное время + отдельными work items через MCP, без дублирования уже внесённого времени. + Выбирай только тип работы, поддерживаемый проектом. + Если в design предусмотрен новый или заменяющий ADR, включи в tasks отдельную задачу на его создание в `openspec/context/adr/` со статусом Proposed. При замене принятого решения свяжи новый и прежний ADR через @@ -348,4 +375,11 @@ apply: instruction: | Прочитай файлы контекста, выполняй незавершённые задачи и отмечай их выполненными по мере работы. Остановись, если столкнёшься с препятствием или - потребуется уточнение. + потребуется уточнение. Для change с задачей YouTrack записывай фактически + затраченное во время apply время в её work items через MCP; перед + архивированием проверь, что учтено всё время работы над change. После + успешного `openspec archive` + переведи задачу в конечный статус, предусмотренный проектом YouTrack, + используя доступную схему полей и значений. Не подставляй предполагаемое + название статуса. Считай change завершённым только после успешного + архивирования и закрытия YouTrack-задачи. diff --git a/openspec/schemas/use-case-driven/templates/proposal.md b/openspec/schemas/use-case-driven/templates/proposal.md index febb3fc..02b8155 100644 --- a/openspec/schemas/use-case-driven/templates/proposal.md +++ b/openspec/schemas/use-case-driven/templates/proposal.md @@ -27,3 +27,8 @@ ## Impact + +## YouTrack + + +- Задача: `` —