12 KiB
name, description
| name | description |
|---|---|
| task-tracker | Веди задачу YouTrack при работе с OpenSpec Change, сохраняй связь после archive и учитывай фактическое время. |
Task Tracker
Одна верхнеуровневая задача на change; без подзадач и копирования tasks.md.
Используй YouTrack MCP по текущим контрактам инструментов.
Если пользователь передал ID задачи для начала Explore/Propose или работы над
change, начинай с контекста этой задачи и используй её; новую задачу не создавай.
Переданная задача может иметь любой тип: сохраняй её Type и не отклоняй
задачу из-за его значения.
Настройки и связь
Читай Project key и Application label из применимого AGENTS.md.
Способ хранения метки определяй по схеме полей проекта: используй строковое
custom field Labels, если оно есть; иначе используй точный тег YouTrack.
Не записывай значение одновременно в поле и тег. Отсутствующие значения,
placeholders или конфликт настроек требуют уточнения.
Если в переданной задаче нужной метки нет, добавляй её автоматически без запроса
подтверждения; после записи проверь результат через get_issue.
Храни task-tracker.yaml в каталоге change реального OpenSpec store,
включай в Git: archive переносит файл вместе с change.
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 после проверки всей операции, включая тег и время.
Записывай атомарно, сохраняя неизвестные поля; разрешай конфликты записей до вызовов.
Жизненный цикл
- Найди: приоритет у явно переданного пользователем 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, не разрешает создание замены. - Создай/привяжи: если пользователь передал 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заполни значениемApplication label; в непустое строковое поле допиши, <Application label>, сохранив прежний текст и не дублируя значение. Для хранения тегом вызовиmanage_issue_tagsс точнымApplication label. При работе через тег не подменяй имя похожим. Еслиmanage_issue_tagsвернул ошибку, сохрани полный ответ, включая подсказки, и перечитай задачу на случай частично успешной операции. Сообщение «tag not found or not accessible» не различает отсутствующий тег и тег, скрытый настройками доступа: проверь точное имя; при верном имени попроси владельца/администратора проверить владельца, видимость и права изменения тега. При отказе по задаче проверь права проекта. После устранения причины повтори действие для той же задачи и подтверди черезget_issue; новую задачу из-за ошибки метки не создавай. - Обнови: через
update_issueтолько при содержательных изменениях proposal. В описании меняй только блок между<!-- openspec-task:start -->и<!-- openspec-task:end -->, содержащий маркер change; добавь его старой задаче. Сохраняй чужой текст, поля и теги; конфликт привязки/смену метки согласуй. - Заархивируй, закрой и закоммить: перед archive синхронизируй описание и
время. После подтверждённого переноса каталога читай связь из архива; через
update_issueустанови успешный конечный статус из схемы полей и проверь resolved. Перед изменением сохраняйsync.pending: close; после проверки очисти его иlast_error. Неясный статус уточни. При отмене или ошибке archive задачу не закрывай и коммит не создавай. Уже завершённую задачу не закрывай повторно и не переоткрывай. После успешного archive и синхронизации YouTrack создай Git-коммит со всеми относящимися к change изменениями, включая архив и очищенную связь. Перед коммитом проверьgit statusи diff; не включай несвязанные или чужие staged/working-tree изменения. Если изменения нельзя безопасно отделить, оставь файлы незакоммиченными, сообщи о блокере и не создавай частичный коммит. Сообщение коммита начинай с читаемого ключа связанной задачи YouTrack и пробела, затем кратко опиши фактические изменения по-русски:CON-27 Правка тестов. Ключ бери из данных задачи; не подставляй вместо него непрозрачныйtask_id. Для архивного 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 задачи, результат и оставшееся действие.