Template
Правки процесс работы с task tracker
This commit is contained in:
@@ -1,11 +1,5 @@
|
||||
schema: use-case-driven
|
||||
|
||||
# Проектные настройки YouTrack. Общие правила работы заданы в schema.yaml.
|
||||
# В проектах, скопировавших эту схему, замените значения на свои.
|
||||
context: |
|
||||
YouTrack project key: PL
|
||||
YouTrack application label: openspec-schema
|
||||
|
||||
rules:
|
||||
tasks:
|
||||
- >-
|
||||
@@ -17,13 +11,3 @@ rules:
|
||||
публичный контракт. Начиная с 1.0.0 используй PATCH для исправлений,
|
||||
рефакторинга и документации, MINOR для обратно совместимых возможностей,
|
||||
MAJOR для несовместимых изменений публичного контракта.
|
||||
|
||||
operations:
|
||||
archive:
|
||||
guidance:
|
||||
- >-
|
||||
Перед `openspec archive` внеси в связанную задачу YouTrack оставшееся
|
||||
фактическое время, учитывая только ещё не записанное и используя
|
||||
доступный проекту тип работы. После успешной архивации переведи задачу
|
||||
в конечный статус проекта по доступным полям и значениям; не угадывай
|
||||
статус. Change завершён только после архивации и закрытия задачи.
|
||||
|
||||
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user