Полная документация ниже — автоматически из репозитория kandler3/yandex-tracker-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

Яндекс Трекер с ИИ — Yandex Tracker Skill

Русский | English

Yandex Tracker Skill — скилл для работы с Яндекс Трекером через ИИ-агентов. Он помогает искать и создавать задачи, менять статусы, работать с комментариями и готовить отчёты по запросу на обычном языке.

Скилл содержит инструкции для агента, который выполняет запросы к API Трекера через Python-пакет yandex_tracker_client. В репозитории есть манифесты для Claude Code, Codex и Gemini CLI; для OpenClaw пакет опубликован в ClawHub.

Например, после подключения можно попросить:

Найди открытые задачи в очереди DEV, сгруппируй их по исполнителям и подготовь краткую сводку.

DEV и другие ключи в примерах нужно заменить на ключи ваших очередей и задач.

Возможности

• Поиск задач с помощью языка запросов Трекера (Tracker Query Language) и фильтров, группировка результатов и подготовка сводок.
• Чтение, создание и редактирование задач, изменение статусов.
• Работа с пользовательскими полями, комментариями, вложениями и связями между задачами.
• Работа с записями о затраченном времени, очередями, пользователями, досками и спринтами.
• Массовое обновление задач, изменение статусов и перенос между очередями в согласованном пользователем объёме.

Как подключить Яндекс Трекер к ИИ

1. Проверьте требования

Вам понадобятся:

• ИИ-агент, который умеет читать скиллы из файловой системы и запускать Python 3.
• Доступ из среды агента к API Яндекс Трекера.
• Аккаунт Яндекса с доступом к нужной организации и очередям Трекера.
• OAuth-токен с необходимыми разрешениями Трекера и идентификатор организации Яндекс 360 или Yandex Cloud.
• Node.js и npm с командой npx, если вы устанавливаете скилл через Agent Skills CLI.

2. Установите скилл

Установите скилл из этого репозитория через Vercel Agent Skills CLI:

npx skills add Kandler3/yandex-tracker-skill

Установщик определит поддерживаемых агентов и предложит выбрать, куда установить скилл. Агента можно указать явно, например для Codex:

npx skills add Kandler3/yandex-tracker-skill --skill yandex-tracker --agent codex

Для OpenClaw используйте опубликованный пакет ClawHub:

clawhub install yandex-tracker

Если среда агента не устанавливает Python-зависимости автоматически, установите клиент в ту среду Python, которую использует агент:

python -m pip install yandex_tracker_client

3. Получите токен

Следуйте официальной инструкции Яндекс Трекера по доступу к API, чтобы создать OAuth-приложение и получить токен.

Выберите разрешения под свои задачи: tracker:read для чтения данных, tracker:write для их изменения. Токен не даёт дополнительных прав в Трекере: действия выполняются с правами аккаунта, которому он принадлежит.

4. Узнайте идентификатор организации

В Трекере откройте Администрирование → Организации и скопируйте идентификатор:

• Яндекс 360: числовой идентификатор, для него используется TRACKER_ORG_ID.
• Yandex Cloud: строковый идентификатор, для него используется TRACKER_CLOUD_ORG_ID.

5. Настройте доступ для агента

Передайте значения через механизм секретов или переменные окружения вашей среды агента. Для организации Яндекс 360 нужны:

TRACKER_TOKEN=your_oauth_token
TRACKER_ORG_ID=12345678

Для организации Yandex Cloud:

TRACKER_TOKEN=your_oauth_token
TRACKER_CLOUD_ORG_ID=your_cloud_org_id

Значения в примерах — заглушки. Укажите ровно одну переменную идентификатора организации: TRACKER_ORG_ID или TRACKER_CLOUD_ORG_ID.

Не вставляйте токены в запросы к ИИ, сгенерированные скрипты или файлы репозитория. Для OpenClaw есть отдельная инструкция по настройке. Подробности подключения, включая вариант с временным IAM-токеном для Yandex Cloud, описаны в справочнике по настройке и авторизации.

6. Проверьте подключение

Попросите агента выполнить запрос на чтение:

Используй скилл yandex-tracker и покажи список доступных мне очередей Яндекс Трекера.

При успешном подключении агент вернёт список очередей. Затем можно выбрать нужную очередь и запросить задачи или сводку по ним.

Если подключение не получилось, проверьте, что агент видит скилл, запускает нужную среду Python с установленным клиентом и получает токен вместе с одним идентификатором организации. Дополнительные сведения — в справочнике по настройке и авторизации.

Примеры запросов к ИИ

Найти свои задачи

Покажи все задачи в очереди DEV, назначенные на меня.

Создать задачу

Создай в очереди BACKEND задачу «Перевести авторизацию на OAuth 2.0» с критическим приоритетом.

Изменить статус и добавить комментарий

Закрой задачу DEV-42 с резолюцией fixed и комментарием «Исправлено в версии 3.1».

Подготовить отчёт

Сгруппируй открытые задачи очереди DEV по исполнителям и покажи количество задач у каждого.

Подготовить массовое изменение

Найди открытые задачи очереди DEV без исполнителя и покажи список для проверки перед массовым назначением.

Агент должен учитывать поля и переходы статусов, доступные в конкретной очереди. После изменения он сообщает ключи затронутых задач и подтверждённый результат. Перед массовой операцией проверяет набор задач и согласованный объём изменений.

Частые вопросы

Что такое скилл для Яндекс Трекера?

Это набор инструкций и справочных материалов, которые ИИ-агент использует для работы с API Трекера. Пользователь описывает задачу обычным языком, а агент обращается к Python-клиенту, обрабатывает данные и возвращает результат.

Нужен ли отдельный MCP-сервер?

Для описанного здесь способа подключения отдельный MCP-сервер не требуется: агент выполняет Python-код с библиотекой yandex_tracker_client. Ему нужны доступ к API, настроенные учётные данные и возможность запускать Python.

Можно ли использовать скилл только для чтения и отчётов?

Да. Используйте OAuth-токен с разрешением tracker:read. Создание и изменение задач требуют соответствующего разрешения токена и прав пользователя в Трекере.

Поддерживается ли Трекер в организации Yandex Cloud?

Да. Укажите TRACKER_CLOUD_ORG_ID вместо TRACKER_ORG_ID. Пример выше использует OAuth-токен; настройка временного IAM-токена описана в справочнике по авторизации.

Структура репозитория

Общие инструкции, ограничения и указатель тем находятся в skills/yandex-tracker/SKILL.md. Подробные справочники лежат рядом в references/, чтобы агент мог загружать только материалы по текущему запросу. Манифесты интеграций находятся в корне репозитория и каталогах .claude-plugin/ и .codex-plugin/.

Сведения об авторе, назначении, зависимостях, известных рисках и проверках релиза собраны в карточке скилла. Инструкции для агента и карточка скилла доступны на английском языке.

Лицензия

Проект распространяется под лицензией MIT.