Files
openspec-schema/skills/task-tracker/SKILL.md
T

119 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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 задачи, результат и оставшееся действие.