Template
Правки процесс работы с task tracker
This commit is contained in:
@@ -20,3 +20,28 @@
|
||||
обновляй `openspec/context/index.md`.
|
||||
- Не принимай Proposed ADR самостоятельно. При конфликте запроса с принятым ADR
|
||||
явно сообщи о нём и запроси решение владельца.
|
||||
|
||||
## Task Management
|
||||
|
||||
Для всех OpenSpec Changes используй скилл `task-tracker`.
|
||||
|
||||
Task tracker configuration:
|
||||
|
||||
- Project key: <KEY>
|
||||
- Application label: <APP-NAME>
|
||||
|
||||
Lifecycle:
|
||||
|
||||
- Если пользователь передал ID задачи YouTrack для начала Explore/Propose или
|
||||
change, используй эту задачу как контекст; новую задачу не создавай.
|
||||
- При создании change без переданного ID создай или привяжи задачу после
|
||||
содержательного proposal.
|
||||
- При существенном изменении change синхронизируй существующую задачу.
|
||||
- После каждого рабочего сеанса Apply синхронизируй фактическое время.
|
||||
- Перед archive выполни финальную синхронизацию; после успешной архивации
|
||||
закрой связанную задачу и создай коммит с изменениями change и русским
|
||||
описанием в 4–7 слов. При ошибке archive задачу не закрывай и коммит не создавай.
|
||||
- При повторном запросе или незавершённой синхронизации возобнови работу
|
||||
с существующей связью, включая архивные changes.
|
||||
|
||||
Все операции управления задачами выполняй через скилл `task-tracker`.
|
||||
|
||||
@@ -8,7 +8,8 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
|
||||
|
||||
В комплект входят:
|
||||
|
||||
- `AGENTS.md` — навигация по проектному контексту и правила OpenSpec;
|
||||
- `AGENTS.md` — навигация по контексту, правила OpenSpec и вызовы `task-tracker`;
|
||||
- `openspec/config.yaml` — выбор схемы и начальный контекст OpenSpec;
|
||||
- `openspec/context/index.md` — карта постоянных документов проекта;
|
||||
- `openspec/context/adr/README.md` — правила ведения ADR;
|
||||
- `openspec/context/adr/ADR-template.md` — заготовка нового решения.
|
||||
@@ -22,20 +23,29 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
|
||||
`openspec/schemas/use-case-driven/templates/adr.md` в этом репозитории. При
|
||||
изменении исходного шаблона обновляйте его копию здесь.
|
||||
|
||||
После `openspec init` настройте в `openspec/config.yaml` проектные параметры
|
||||
интеграции YouTrack в существующем блоке `context`, сохранив остальной контекст:
|
||||
После `openspec init` объедините заготовку `openspec/config.yaml` с конфигурацией
|
||||
проекта, сохранив существующие настройки. Выберите `schema: use-case-driven`
|
||||
и дополните предметный контекст. Настройки задач заполняйте в `AGENTS.md`:
|
||||
|
||||
```yaml
|
||||
context: |
|
||||
YouTrack project key: <KEY>
|
||||
YouTrack application label: <APP-NAME>
|
||||
```markdown
|
||||
Task tracker configuration:
|
||||
|
||||
- Project key: <KEY>
|
||||
- Application label: <APP-NAME>
|
||||
```
|
||||
|
||||
Укажите ключ проекта и имя приложения, которое должно записываться в тег каждой
|
||||
задачи. Общие правила создания задачи, учёта времени и архивации берутся из
|
||||
схемы `use-case-driven`. Добавьте также `operations.archive.guidance` из раздела
|
||||
«Настройка YouTrack» в README схемы: OpenSpec загружает эту подсказку отдельно
|
||||
при вызове `openspec instructions archive`.
|
||||
Укажите ключ проекта и имя приложения, которым маркируется каждая задача. Скилл
|
||||
сохраняет его в строковое поле `Labels`, если оно есть в проекте, иначе — как
|
||||
точный тег YouTrack. Если
|
||||
пользователь начинает Explore/Propose с переданным ID задачи, используйте эту
|
||||
задачу и не создавайте новую.
|
||||
Подключите общий скилл `task-tracker` по
|
||||
[инструкции корневого README](../../README.md#подключение-из-домашней-директории).
|
||||
Создание или привязка, содержательные обновления, учёт времени, закрытие задачи
|
||||
и коммит после успешного archive выполняются по Lifecycle из `AGENTS.md`.
|
||||
Сообщение коммита должно быть на русском языке и состоять из 4–7 слов. Эти правила не нужно
|
||||
добавлять в схему или `config.yaml`. Запуск OpenSpec CLI вне Codex не вызывает
|
||||
скилл; для завершения внешней синхронизации обратитесь к агенту.
|
||||
|
||||
Заготовка не содержит готовых решений или описания бизнес-домена. ADR создаются
|
||||
в проекте только для конкретных долгосрочных архитектурных решений.
|
||||
|
||||
@@ -0,0 +1,5 @@
|
||||
schema: use-case-driven
|
||||
|
||||
# Дополните предметной областью и ограничениями конкретного проекта.
|
||||
context: |
|
||||
Постоянный контекст проекта: openspec/context/index.md.
|
||||
Reference in New Issue
Block a user