Правки процесс работы с task tracker

This commit is contained in:
2026-10-16 21:39:10 +03:00
parent a0fe47d4d3
commit e2e2d0bcc2
10 changed files with 481 additions and 149 deletions
@@ -5,37 +5,6 @@
формат требований определён в `schema.yaml` и шаблонах. Существующие changes
с явно указанной `schema: spec-driven` продолжают использовать свою схему.
## Настройка YouTrack
Правила YouTrack входят в `schema.yaml`. Для каждого проекта укажи в блоке
`context` файла `openspec/config.yaml` ключ проекта и имя приложения. Добавь
строки в существующий блок, сохранив остальной проектный контекст:
```yaml
context: |
YouTrack project key: <KEY>
YouTrack application label: <APP-NAME>
```
Схема создаёт одну задачу `Task` на change, добавляет к ней тег с указанным
именем приложения и учитывает фактическое время от Explore до архивации. В
YouTrack этот механизм называется тегом; настройка `application label` задаёт
точное имя этого тега. Если интеграция или тег недоступны, workflow останавливается
и сообщает о проблеме, а не создаёт задачу без метки приложения.
Завершающие действия YouTrack для команды `openspec archive` настраиваются отдельно
от схемы — в `operations.archive.guidance` файла `openspec/config.yaml`:
```yaml
operations:
archive:
guidance:
- >-
Перед openspec archive внеси в связанную задачу YouTrack оставшееся
фактическое время, учитывая только ещё не записанное. После успешной
архивации переведи задачу в конечный статус проекта по доступным полям;
не угадывай статус. Change завершён после архивации и закрытия задачи.
```
## Уровни спецификации
- Capability — отдельная бизнес-функция или понятный результат в иерархии доменов.
@@ -62,25 +62,6 @@ artifacts:
Specs в Context. Отсутствующий индекс включай в scope только при введении
постоянных документов контекста или принятии проектом этой навигационной модели.
YouTrack:
В `context` файла `openspec/config.yaml` обязательны строки
`YouTrack project key: <KEY>` и `YouTrack application label: <APP-NAME>`.
До создания задачи проверь через YouTrack MCP проект, тип `Task`, обязательные
поля и доступность/применимость тега `<APP-NAME>`. При отсутствии настройки,
тега, невозможности проверки или недоступности MCP остановись, сообщи о проблеме
и уточни конфигурацию либо дальнейшее действие. Не используй проект `Default`.
После содержательного proposal, до specs/design/tasks, создай ровно одну
задачу `Task` на change, включая `skip_specs: true`. Заголовок и описание
сформируй по причине и scope proposal, добавь slug change и тег с точным
именем из `YouTrack application label`; ключ и URL внеси в YouTrack раздел
`proposal.md`. При изменении причины, scope, capabilities или impact в proposal
обновляй связанную задачу без дубликатов. Тег приложения сохраняй до изменения настройки.
Учитывай фактическое время всей работы от Explore и подготовки proposal:
при создании задачи внеси уже затраченное; после каждого сеанса Apply добавляй
только неучтённое время отдельным work item с доступным проекту типом работы.
Финальную синхронизацию времени и статуса выполняй по `openspec instructions archive`.
requires: []
- id: specs
@@ -285,7 +266,4 @@ apply:
контекста и его индекса. Если индекс существует или его создание входит в
tasks.md, проверь, что он соответствует фактическому набору документов.
Убедись, что требования Specs не продублированы в Context.
Для связанной задачи YouTrack после каждого рабочего сеанса запиши только
ещё не учтённое фактическое время через MCP, используя доступный тип работы.
Перед архивацией change проверь, что учтено всё время начиная с Explore.
Остановись, если столкнёшься с препятствием или потребуется уточнение.
@@ -33,7 +33,3 @@
<!-- Оцени постоянный контекст проекта: укажи документы и ADR, которые нужно
создать или обновить. Если обновления не нужны, напиши это явно.
Не переноси сюда функциональные требования из OpenSpec Specs. -->
## YouTrack
- Задача: `<PROJECT-123>` — <issue URL>