Template
Добавлена связь с проектом в таск трекере
This commit is contained in:
@@ -147,6 +147,35 @@ Scenario в таких операциях не создаётся. В delta со
|
||||
заголовки FR master spec, на которые ведут автоматически созданные slugs. Для
|
||||
ссылок на неизменённые требования при проверке передай `--base <master-spec>`.
|
||||
|
||||
## Учёт 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: <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.
|
||||
Форматирование спецификации само по себе не реализует этот контракт в приложении.
|
||||
|
||||
@@ -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: <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-задачи.
|
||||
|
||||
@@ -27,3 +27,8 @@
|
||||
## Impact
|
||||
|
||||
<!-- Затронутые код, API, зависимости и системы -->
|
||||
|
||||
## YouTrack
|
||||
|
||||
<!-- Заполни после подготовки proposal и создания задачи. -->
|
||||
- Задача: `<PROJECT-123>` — <issue URL>
|
||||
|
||||
Reference in New Issue
Block a user