Jira Integration Plugin

Плагин ведет Jira из терминала агента: поиск по JQL, задачи, спринты, учет времени и проверка вики-разметки

  • 90 ★ репозитория
  • Последний коммит
Плагин

Широкий доступ

Почему такой уровень

  • Пишет в боевой Jira: создает и меняет задачи, статусы, комментарии и списывает время от вашего имени
  • Хранит учетные данные Jira в файле окружения, их читают скрипты агента
Все причины и проверки

netresearch/jira-skill

Установка

Ручная установка

/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 показывает задачи и спринты в таблице или возвращает данные для скрипта: выборки доступны в терминале рядом с кодом.

CLIРасширенный доступ6,1 тыс.Звезды репозитория

Jira MCP на Go: агент ищет задачи по JQL, читает спринты и комментарии, списывает время, видит ветки и пул-реквесты задачи, работает с Cloud и Data Center

MCP-серверШирокий доступ96Звезды репозитория
Выбор редакции

MCP-сервер для Jira и Confluence в облаке и на собственных серверах: поиск, создание и правка задач и страниц

MCP-серверШирокий доступ6,1 тыс.Звезды репозитория

Плагин Redmine с ИИ-чатом, сводками задач и MCP-сервером: внешний агент работает с задачами Redmine по ключу API.

ПлагинРасширенный доступ107Звезды репозитория
Официальный

Официальный облачный MCP-сервер Atlassian для Jira, Confluence, Jira Service Management, Bitbucket, Compass и Loom со скиллами

MCP-серверШирокий доступ1,2 тыс.Звезды репозитория
Официальный

Официальный плагин и MCP-сервер Astravue: 87 инструментов для задач, проектов, учета времени и 8 готовых скиллов планирования.

ПлагинШирокий доступ12Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Jira Integration Plugin (эта карточка)нет90
Jira MCPнетключ необязателен96MCP-сервер на 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

Сообщить о проблеме