Jira Integration Plugin
Плагин ведет Jira из терминала агента: поиск по JQL, задачи, спринты, учет времени и проверка вики-разметки
- 90 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Пишет в боевой Jira: создает и меняет задачи, статусы, комментарии и списывает время от вашего имени
- Хранит учетные данные Jira в файле окружения, их читают скрипты агента
Установка
- Работает в
Ручная установка
/plugin install jira-integration@netresearch-claude-code-marketplaceСначала `/plugin marketplace add netresearch/claude-code-marketplace`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Пишет в боевой Jira: создает и меняет задачи, статусы, комментарии и списывает время от вашего имени
- Хранит учетные данные Jira в файле окружения, их читают скрипты агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин содержит два скилла. Скилл `jira-communication` вызывает Python-скрипты для работы с API Jira: поиск задач по JQL (`jira-search.py`), чтение и правка задач (`jira-issue.py`), создание задач, смена статуса, комментарии, спринты, доски, ссылки между задачами, поиск идентификаторов полей и скачивание вложений. Скилл `jira-syntax` знает вики-разметку Jira, шаблоны описаний и проверяет разметку перед отправкой. Скрипты запускаются через Bash командой `uv run`, поэтому описания инструментов не занимают контекст, как у MCP-сервера, и нет контейнера, который надо поднимать. Поддерживаются Jira Server, Data Center и Cloud. У каждого скрипта есть флаги `--json`, `--quiet` и `--env-file`, а у пишущих команд флаг `--dry-run` показывает изменения без выполнения. Скрипт `jira-setup.py` интерактивно настраивает учетные данные, `jira-validate.py` проверяет окружение.
Для кого. Разработчикам и тимлидам на Jira Server, Data Center или Cloud, которые ведут задачи, спринты и учет времени из сессии Claude Code или Cursor.
Подходит, если
- Надо найти все открытые баги проекта и разобрать их в сессии агента
- Задачу нужно создать, перевести в другой статус и прокомментировать, не открывая браузер
- Требуется списать время командой `jira-worklog.py add PROJ-123 "2h 30m"`
- Описание задачи пишется в вики-разметке Jira, и ее надо проверить до отправки
Не подходит, если
- Команда работает в Linear, YouTrack или другом трекере: плагин знает только Jira
- Нужен MCP-сервер с описанными инструментами: плагин сознательно работает через Bash и скрипты
- На машине нет `uv` и Python, а ставить их нельзя
Пример запроса к агенту
Найди мои открытые задачи в спринте проекта PROJ и спиши 2 часа 30 минут на PROJ-123 с комментарием про ревьюОграничения
- Нужны Python 3.11 или новее и `uv`, а также доступ к вашему экземпляру Jira по учетным данным, которые настраивает `jira-setup.py`.
- Скрипты выполняются через Bash агента, поэтому агенту нужно разрешение на запуск команд.
- Установка через `npx skills` ставит только скиллы на основе `SKILL.md` и пропускает хуки, для хуков нужен маркетплейс или каталог скиллов.
- Лицензия двойная, MIT для кода и CC-BY-SA-4.0 для материалов, поле лицензии на GitHub показывает «не определена».
Как отключить. Если ставили из каталога скиллов, удалите папку `~/.claude/skills/jira-integration`. Для маркетплейса выполните `/plugin uninstall jira-integration@netresearch-claude-code-marketplace`.
Частые вопросы
Как поставить плагин Jira в Claude Code?
Из маркетплейса: `/plugin marketplace add netresearch/claude-code-marketplace`, затем `/plugin install jira-integration@netresearch-claude-code-marketplace`. Есть и вариант клонирования в `~/.claude/skills/jira-integration`.
Какие версии Jira поддерживаются?
Jira Server, Data Center и Cloud. Скрипты работают с API, и тип развертывания задается настройкой окружения.
Чем плагин отличается от MCP-сервера для Jira?
Он запускает Python-скрипты через Bash, и описания инструментов не загружаются в контекст. MCP-сервер держит инструменты постоянно подключенными, но тратит на их описания контекст.
Как проверить изменения до отправки в Jira?
Добавьте флаг `--dry-run` к пишущей команде: скрипт покажет, что изменится, и ничего не отправит. Для проверки окружения служит `jira-validate.py`.
Работает ли плагин в Cursor и Copilot?
Да, скиллы следуют открытому формату Agent Skills, поэтому их читают Cursor, GitHub Copilot и другие совместимые агенты. Через `npx skills add` ставятся два скилла отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныJira CLI показывает задачи и спринты в таблице или возвращает данные для скрипта: выборки доступны в терминале рядом с кодом.
Jira MCP на Go: агент ищет задачи по JQL, читает спринты и комментарии, списывает время, видит ветки и пул-реквесты задачи, работает с Cloud и Data Center
MCP-сервер для Jira и Confluence в облаке и на собственных серверах: поиск, создание и правка задач и страниц
Плагин Redmine с ИИ-чатом, сводками задач и MCP-сервером: внешний агент работает с задачами Redmine по ключу API.
Официальный облачный MCP-сервер Atlassian для Jira, Confluence, Jira Service Management, Bitbucket, Compass и Loom со скиллами
Официальный плагин и MCP-сервер Astravue: 87 инструментов для задач, проектов, учета времени и 8 готовых скиллов планирования.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Jira Integration Plugin (эта карточка) | нет | 90 | ||
| Jira MCP | нет | ключ необязателен | 96 | MCP-сервер на Go с постоянно подключенными инструментами, а этот плагин работает через Bash-скрипты без нагрузки на контекст |
| Jira CLI | нет | 6 069 | терминальная утилита для людей с таблицами задач, а этот плагин дает агенту скиллы, скрипты с JSON и проверку разметки |
Коротко о README
В README плагин описан как набор из двух скиллов, затем перечислены совместимые платформы и преимущества: никакого MCP, быстрый запуск и полное покрытие API. Далее идут шесть способов установки, быстрый старт с четырьмя примерами команд и таблицы скриптов по группам. Завершают общие параметры и примеры сценариев.
Бейдж для README
Исходный SKILL.md
---
# SPDX-License-Identifier: CC-BY-SA-4.0
# SPDX-FileCopyrightText: Netresearch DTT GmbH
name: jira-communication
description: "Use when handling Jira issues, sprints, boards, links, fields, worklogs, attachments, or users, or on any Jira intent without a key (\"create/find a ticket\", \"pick a project\"). Auto-triggers on Jira URLs and issue keys (PROJ-123). Also use when MCP Atlassian tools fail or are unavailable for Jira Server/DC."
license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
compatibility: "Requires python 3.11+, uv. Jira Server/DC or Cloud instance with API access."
metadata:
author: Netresearch DTT GmbH
version: "4.3.3"
repository: https://github.com/netresearch/jira-skill
allowed-tools: Bash(uv run ${CLAUDE_SKILL_DIR}/scripts/*) Bash(${CLAUDE_SKILL_DIR}/scripts/*) Read Write
---
# Jira Communication
CLI scripts via `uv run`, all supporting `--help`, `--json`, `--quiet`, `--debug`.
## Auto-Trigger
On Jira URL or issue key (PROJ-123), pick by **intent** — each is one call:
| Intent | Tool |
|---|---|
| triage / work on ticket | `jira-issue.py work KEY` |
| start QA review | `jira-issue.py qa KEY` |
| QA-fail follow-up | `jira-issue.py qa-fail KEY` |
| field-only lookup | `jira-issue.py get KEY --fields ...` |
| change status | `jira-issue.py act KEY` → `jira-transition.py do` |
| audit / sibling discovery / "am I reviewing my own work?" | `jira-qa-gather.py KEY` |
Auth issues → `jira-setup.py`. **Anti-pattern:** `get` + `comment list` — use the matching verb.
**`work` flags a ticket you have not taken:** when it is not assigned to you, or its status says nobody works on it (To Do category, a review status such as QA, or resolved), a `!! CLAIM KEY` notice on stderr (`claim` in `--json`) lists the commands — `jira-issue.py update KEY --assignee me`, then the start or reopen transition from `jira-transition.py list KEY`. Run them before your first comment, measurement or edit. `jira-comment.py add` warns once before posting when the ticket is neither yours nor in a working status; it still posts.
## Scripts
Under `${CLAUDE_SKILL_DIR}/scripts/{core,workflow,utility}/`.
**Core**: `jira-issue.py`, `jira-search.py`, `jira-worklog.py`, `jira-attachment.py`, `jira-setup.py`, `jira-validate.py`
**Workflow**: `jira-create.py`, `jira-transition.py`, `jira-comment.py`, `jira-move.py`, `jira-sprint.py`, `jira-board.py`, `jira-version.py`, `tempo-account.py`
**Utility**: `jira-user.py`, `jira-fields.py`, `jira-link.py`, `jira-weblink.py`, `jira-worklog-query.py`, `jira-watchers.py`, `jira-qa-gather.py`
## Execution Style