--- 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: /`; для старых задач также 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. В описании меняй только блок между `` и ``, содержащий маркер 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: `; `recorded` повторно не отправляй. При ошибке MCP/локальной записи останови синхронизацию, сохрани связь, незавершённые операции и `last_error`. Если archive уже выполнен, проверь архивную связь, состояние задачи и Git status/log; продолжи только незавершённые закрытие или коммит, не повторяя archive и уже выполненный коммит. Перед повтором сверяй внешнее состояние. Неопределённый результат создания запрещает автоматическое повторное создание даже при пустом поиске; `sending` требует сверки work items или ручной проверки, если MCP их не читает. Выполненный archive не откатывай. Сообщи change, ID/URL задачи, результат и оставшееся действие.