Правки процесс работы с 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
+25
View File
@@ -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`.
+22 -12
View File
@@ -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.