Template
Правки процесс работы с task tracker
This commit is contained in:
@@ -0,0 +1,118 @@
|
||||
---
|
||||
name: task-tracker
|
||||
description: Веди задачу YouTrack при работе с OpenSpec Change, сохраняй связь после archive и учитывай фактическое время.
|
||||
---
|
||||
|
||||
# Task Tracker
|
||||
|
||||
Одна верхнеуровневая задача на change; без подзадач и копирования `tasks.md`.
|
||||
Используй YouTrack MCP по текущим контрактам инструментов.
|
||||
Если пользователь передал ID задачи для начала Explore/Propose или работы над
|
||||
change, начинай с контекста этой задачи и используй её; новую задачу не создавай.
|
||||
|
||||
## Настройки и связь
|
||||
|
||||
Читай `Project key` и `Application label` из применимого `AGENTS.md`.
|
||||
Способ хранения метки определяй по схеме полей проекта: используй строковое
|
||||
custom field `Labels`, если оно есть; иначе используй точный тег YouTrack.
|
||||
Не записывай значение одновременно в поле и тег. Отсутствующие значения,
|
||||
placeholders или конфликт настроек требуют уточнения.
|
||||
|
||||
Храни `task-tracker.yaml` в каталоге change реального OpenSpec store,
|
||||
включай в Git: archive переносит файл вместе с change.
|
||||
|
||||
```yaml
|
||||
version: 1
|
||||
change_id: improve-validation
|
||||
project_key: EXAMPLE
|
||||
application_label: order-service
|
||||
task_id: null
|
||||
task_url: null
|
||||
sync: {pending: null, last_error: null}
|
||||
worklog:
|
||||
- {id: session-1, date: '2026-10-14', minutes: 25, description: Explore, status: pending}
|
||||
```
|
||||
|
||||
`change_id` сохраняет исходный ID, `task_id` непрозрачен, URL берётся из ответа.
|
||||
Перед изменениями YouTrack сохраняй `sync.pending`: `create`, `update` или `close`;
|
||||
очищай вместе с `last_error` после проверки всей операции, включая тег и время.
|
||||
Записывай атомарно, сохраняя неизвестные поля; разрешай конфликты записей до вызовов.
|
||||
|
||||
## Жизненный цикл
|
||||
|
||||
1. **Найди:** приоритет у явно переданного пользователем ID, затем у связи
|
||||
в активном каталоге/архиве по точному `change_id`, старых ссылок proposal
|
||||
и результатов поиска. Для переданного ID сразу вызови `get_issue`; проверь
|
||||
существование задачи, проект, тип и отсутствие `subtask of`. Используй её
|
||||
как авторитетную связь для этого запроса, даже если локальная связь отсутствует
|
||||
или содержит прежний ID; прежнюю задачу не обновляй. Если ID не существует
|
||||
или не подходит по проекту/типу, остановись и сообщи об этом — замену не создавай.
|
||||
Для остальных найденных задач через `get_issue` проверь принадлежность change,
|
||||
проект и отсутствие `subtask of`.
|
||||
Без ID ищи `search_issues` по проекту и маркеру
|
||||
`OpenSpec Change: <application-label>/<change-id>`; для старых задач также slug.
|
||||
Проверь кандидатов, все страницы, открытые и закрытые задачи.
|
||||
Неоднозначность требует уточнения; ошибка чтения/поиска, включая 404,
|
||||
не разрешает создание замены.
|
||||
2. **Создай/привяжи:** если пользователь передал ID, привяжи эту задачу до
|
||||
Explore/Propose и используй её описание как исходный контекст; `create_issue`
|
||||
запрещён для этого запроса. Иначе, после содержательного proposal и до
|
||||
specs/design/tasks (включая `skip_specs`), привяжи найденную задачу или создай
|
||||
новую только для активного change после полного поиска без результатов и
|
||||
незавершённых попыток.
|
||||
Через `get_project` и `get_issue_fields_schema` проверь проект,
|
||||
`Type: Task` и обязательные поля. Сверь схему проекта с правилом выбора
|
||||
способа хранения в разделе «Настройки и связь».
|
||||
`create_issue`: русский заголовок по proposal и блок описания из шага 3,
|
||||
без родителя. Если найдено строковое поле `Labels`, передай в `customFields`
|
||||
точное значение `Application label`; если поля нет, добавь точный тег через
|
||||
`manage_issue_tags`. Сразу сохрани ID/URL и проверь через `get_issue`, что
|
||||
метка записана выбранным способом.
|
||||
Для существующей задачи сначала прочитай поле/теги через `get_issue`.
|
||||
Если метка уже есть — не меняй её. Если поле `Labels` непустое и содержит
|
||||
другое значение, не перезаписывай его и уточни, как сохранить оба значения.
|
||||
При работе через тег не подменяй имя похожим. Если `manage_issue_tags` вернул
|
||||
ошибку, сохрани полный ответ, включая подсказки, и перечитай задачу на случай
|
||||
частично успешной операции. Сообщение «tag not found or not accessible» не
|
||||
различает отсутствующий тег и тег, скрытый настройками доступа: проверь точное
|
||||
имя; при верном имени попроси владельца/администратора проверить владельца,
|
||||
видимость и права изменения тега. При отказе по задаче проверь права проекта.
|
||||
После устранения причины повтори действие для той же задачи и подтверди через
|
||||
`get_issue`; новую задачу из-за ошибки метки не создавай.
|
||||
3. **Обнови:** через `update_issue` только при содержательных изменениях proposal.
|
||||
В описании меняй только блок между `<!-- openspec-task:start -->`
|
||||
и `<!-- openspec-task:end -->`, содержащий маркер change; добавь его старой задаче.
|
||||
Сохраняй чужой текст, поля и теги; конфликт привязки/смену метки согласуй.
|
||||
4. **Заархивируй, закрой и закоммить:** перед archive синхронизируй описание и
|
||||
время. После подтверждённого переноса каталога читай связь из архива; через
|
||||
`update_issue` установи успешный конечный статус из схемы полей и проверь
|
||||
resolved. Перед изменением сохраняй `sync.pending: close`; после проверки
|
||||
очисти его и `last_error`. Неясный статус уточни. При отмене или ошибке archive
|
||||
задачу не закрывай и коммит не создавай. Уже завершённую задачу не закрывай
|
||||
повторно и не переоткрывай.
|
||||
После успешного archive и синхронизации YouTrack создай Git-коммит со всеми
|
||||
относящимися к change изменениями, включая архив и очищенную связь. Перед
|
||||
коммитом проверь `git status` и diff; не включай несвязанные или чужие
|
||||
staged/working-tree изменения. Если изменения нельзя безопасно отделить,
|
||||
оставь файлы незакоммиченными, сообщи о блокере и не создавай частичный коммит.
|
||||
Сообщение коммита должно быть на русском, описывать фактические изменения и
|
||||
содержать 4–7 слов, считая слова по пробелам. Для архивного change продолжай
|
||||
только незавершённые шаги и не запускай archive повторно.
|
||||
|
||||
## Время и восстановление
|
||||
|
||||
Измеряй время от Explore/proposal, без ожиданий и перерывов; синхронизируй
|
||||
после сеансов Apply и перед archive. Старую длительность не выдумывай.
|
||||
У каждого интервала уникальный неизменный ID: перед `log_work` сохраняй `sending`,
|
||||
после подтверждения — `recorded`. Передавай локальную дату, положительные минуты, доступный проекту
|
||||
`workType` и описание с `OpenSpec Worklog: <id>`; `recorded` повторно не отправляй.
|
||||
|
||||
При ошибке MCP/локальной записи останови синхронизацию, сохрани связь,
|
||||
незавершённые операции и `last_error`. Если archive уже выполнен, проверь
|
||||
архивную связь, состояние задачи и Git status/log; продолжи только незавершённые
|
||||
закрытие или коммит, не повторяя archive и уже выполненный коммит. Перед повтором
|
||||
сверяй внешнее состояние.
|
||||
Неопределённый результат создания запрещает автоматическое повторное создание
|
||||
даже при пустом поиске; `sending` требует сверки work items или ручной проверки,
|
||||
если MCP их не читает. Выполненный archive не откатывай.
|
||||
Сообщи change, ID/URL задачи, результат и оставшееся действие.
|
||||
Reference in New Issue
Block a user