pi-kit/skills/jira-workflow/SKILL.md

name, description

name	description
jira-workflow	Используй, когда нужно работать с корпоративным трекером задач (Jira) — прочитать тикет по ключу, создать/обновить задачу, добавить комментарий, перевести по статусам, найти по JQL, приложить ссылку на MR. Применяй при упоминании ключей задач, «тикет», «задача в трекере», «переведи в статус», а также в командах /bugfix и /feature.

Работа с трекером задач (Jira)

Jira работает через нативные инструменты pi (регистрируют extensions/jira-tools.ts). Никаких bash-скриптов и MCP — вызывай инструменты напрямую.

Откуда адрес и токен

• Адрес трекера — из trackerUrl в config/company.json (в контекст сессии инжектит company-context). Можно переопределить TRACKER_URL.
• Токен — JIRA_TOKEN (personal access token) из ~/.config/pi-kit/env.sh.
• Токен не подставляй в команды и не логируй — инструменты читают его сами.

Инструменты

• jira_issue_get(key) — получить тикет (summary, status, description).
• jira_issue_create(projectKey, summary, issuetype, ...) — создать задачу.
• jira_issue_update(key, {summary?, description?, status?, ...}) — обновить поля, status переводит по доступным переходам.
• jira_issue_comment(key, text) — добавить комментарий.
• jira_issue_transition(key, target) — перевести в статус (To Do / In Progress / Review / Done, поддерживаются русские синонимы).
• jira_search(jql, maxResults?) — поиск по JQL.
• jira_link_mr(key, mrUrl, title?) — привязать ссылку на MR (комментарием).

Типовой поток багфикса (/bugfix)

1. jira_issue_get <KEY> — прочитать постановку.
2. jira_issue_transition <KEY> "In Progress" — при старте работы.
3. Создать ветку/фикс (языковые стандарты — в профильном скилле).
4. Перед мержем — gitlab_mr_create (см. скилл gitlab) и jira_link_mr <KEY> <url-MR> — привязать MR к тикету.
5. jira_issue_transition <KEY> "Review" — после выставления MR.
6. jira_issue_transition <KEY> "Done" — после мержа.

Соглашения

• Формат ключей: PROJ-123 (префикс проекта + номер).
• Статусы: To Do → In Progress → Review → Done.
• Переходы: при старте — In Progress; при готовности MR — Review (с ссылкой на MR); после мержа — Done.
• Если jira_issue_update со status не смог найти переход — инструмент вернёт список доступных статусов; уточни нужный.

Полезное

• jira_search удобен для «что в работе у меня»: jira_search('assignee = currentUser() AND status != Done').
• Токен лежит в ~/.config/pi-kit/env.sh (chmod 600).