Template
119 lines
11 KiB
Markdown
119 lines
11 KiB
Markdown
---
|
||
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 задачи, результат и оставшееся действие.
|