Files

12 KiB
Raw Permalink Blame History

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 после проверки всей операции, включая тег и время. Записывай атомарно, сохраняя неизвестные поля; разрешай конфликты записей до вызовов.

Жизненный цикл

  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 заполни значением Application label; в непустое строковое поле допиши , <Application label>, сохранив прежний текст и не дублируя значение. Для хранения тегом вызови manage_issue_tags с точным Application label. При работе через тег не подменяй имя похожим. Если 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 изменения. Если изменения нельзя безопасно отделить, оставь файлы незакоммиченными, сообщи о блокере и не создавай частичный коммит. Сообщение коммита начинай с читаемого ключа связанной задачи 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 задачи, результат и оставшееся действие.