Maslennikov-Anton Yandex Tracker Operations
Используй этот skill, когда задача связана с Yandex Tracker как доменом: очередями, issue workflows, transitions и операционной работой, а не только с одним HTTP endpoint.
Что покрывает этот skill
- Операционные сценарии вокруг очередей, issues и workflow.
- Аутентификацию, проверку доступа и discovery полей.
- Комментарии, вложения, transitions и повторяемые shell/API workflows.
- Разбор типовых API errors и конфликтов данных.
Предпочтительный toolchain
- Локальный helper
scripts/tracker_api.sh. - Повторяемые
curl/shell workflows с явными headers и env vars. - Hand-rolled scripts только если стандартного helper path недостаточно.
Workflow
- Определи точную операцию и целевой объект:
- auth/discovery;
- issue read/search;
- issue create/update;
- comments/attachments;
- transitions/status workflow.
- Если credentials или org context неизвестны, начни с references/auth-and-request-format.md.
- Если credentials или org context неизвестны, проверь доступ через
GET /v3/myself; иначе target read/search может быть достаточным access check. - Перед записью в issue или переходом статуса проверь queue-specific fields и доступные переходы через references/discovery-and-troubleshooting.md.
- Для типовых операций предпочитай готовые формы из references/common-operations.md и references/endpoint-matrix.md.
- Если поведение выглядит нестабильным, сначала локализуй причину через troubleshooting, а не списывай проблему на token или API bug.
Какие references открывать
- Coverage map по областям API: references/api-coverage-map.md
- Auth, headers, pagination и request semantics: references/auth-and-request-format.md
- Типовые операции и адаптируемые примеры: references/common-operations.md
- Endpoint matrix: references/endpoint-matrix.md
- Queue discovery, custom fields и troubleshooting: references/discovery-and-troubleshooting.md
Практические правила
- Не печатай token-ы в ответах.
- До глубокой отладки сначала проверяй auth и org headers.
- Перед update меняй только те поля, которые пользователь явно запросил.
- Для transitions сначала получай список допустимых переходов.
- Для file upload используй multipart form data, а не JSON.
- Явно отмечай, когда вывод основан на docs, а не на live API response.