53 lines
3.6 KiB
Markdown
53 lines
3.6 KiB
Markdown
---
|
|
name: jira-workflow
|
|
description: Используй, когда нужно работать с корпоративным трекером задач (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).
|