Jira Skill
netresearch/jira-skillПлагин для Claude Code с полной интеграцией Jira: управление задачами, ворклоги, спринты, переходы статусов. Поддерживает Jira Server/DC и Cloud. Работает без MCP — через Bash-скрипты на Python.
Установка
npx skills add https://github.com/netresearch/jira-skill --skill jira-communicationREADME
Плагин интеграции с Jira для Claude Code
Плагин для Claude Code, обеспечивающий полноценную интеграцию с Jira через два специализированных скилла.
Структура плагина
| Скилл | Назначение |
|---|---|
jira-communication | API-операции через Python CLI-скрипты |
jira-syntax | Wiki-разметка, шаблоны, валидация |
Каждый скилл содержит собственный SKILL.md с условиями активации и инструкциями по использованию. Claude Code автоматически обнаруживает и активирует скиллы на основе контекста.
🔌 Совместимость скиллов
Скиллы этого плагина соответствуют открытому стандарту Agent Skills, разработанному Anthropic и выпущенному для кросс-платформенного использования.
Поддерживаемые платформы:
- ✅ Claude Code (Anthropic)
- ✅ Cursor
- ✅ GitHub Copilot
- ✅ Другие AI-агенты с поддержкой Agent Skills
Скиллы — это переносимые пакеты процедурных знаний, работающие в любом AI-агенте, поддерживающем спецификацию Agent Skills.
Возможности
- Без накладных расходов MCP — скрипты вызываются через Bash, описания инструментов не загружаются
- Быстрое выполнение — не требует запуска Docker-контейнера
- Полное покрытие API — поддерживаются все распространённые операции Jira
- Jira Server/DC + Cloud — работает с обоими типами развёртывания
Установка
Через маркетплейс (рекомендуется)
Добавьте маркетплейс Netresearch один раз, затем просматривайте и устанавливайте скиллы:
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplacenpx (skills.sh)
Установка через любой агент, совместимый с Agent Skills:
npx skills add https://github.com/netresearch/jira-skill --skill jira-communication
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntaxСкачать релиз
Скачайте последний релиз и распакуйте в директорию скиллов вашего агента.
Git Clone
git clone https://github.com/netresearch/jira-skill.git
Composer (PHP-проекты)
composer require netresearch/jira-skill
Требует netresearch/composer-agent-skill-plugin.
Быстрый старт
Примечание: Выполняйте команды из директории
skills/jira-communication/или указывайте пути с префиксомskills/jira-communication/от корня репозитория.
# Поиск задач
uv run scripts/core/jira-search.py query "project = PROJ AND status = 'In Progress'"
# Получить детали задачи
uv run scripts/core/jira-issue.py get PROJ-123
# Добавить ворклог
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Code review"
# Создать задачу
uv run scripts/workflow/jira-create.py issue PROJ "Fix bug" --type Bug --priority HighДоступные скрипты
Основные операции (scripts/core/)
| Скрипт | Команды | Назначение |
|---|---|---|
jira-setup.py | (по умолчанию) | Интерактивная настройка учётных данных |
jira-validate.py | (по умолчанию) | Проверка настройки окружения |
jira-issue.py | get, update | Получение и обновление задач |
jira-search.py | query | JQL-поиск |
jira-worklog.py | add, list | Учёт времени |
jira-attachment.py | download | Скачивание вложений задачи |
Операции рабочего процесса (scripts/workflow/)
| Скрипт | Команды | Назначение |
|---|---|---|
jira-create.py | issue | Создание новых задач |
jira-transition.py | list, do | Изменение статуса задачи |
jira-comment.py | add, list | Комментарии к задачам |
jira-sprint.py | list, issues, current | Операции со спринтами |
jira-board.py | list, issues | Операции с досками |
Вспомогательные операции (scripts/utility/)
| Скрипт | Команды | Назначение |
|---|---|---|
jira-fields.py | search, list | Поиск идентификаторов полей |
jira-user.py | me, get | Информация о пользователях |
jira-link.py | create, list-types | Связывание задач |
Общие параметры
Все скрипты поддерживают:
--json— вывод в формате JSON--quiet/-q— минимальный вывод--env-file PATH— пользовательский файл окружения--debug— отображение подробных ошибок--help— справка по команде
Операции записи также поддерживают:
--dry-run— предварительный просмотр изменений без выполнения
Примеры использования скриптов
Поиск и фильтрация
# Найти открытые баги в проекте
uv run scripts/core/jira-search.py query "project = PROJ AND type = Bug AND status != Done"
# Найти задачи, назначенные на меня
uv run scripts/core/jira-search.py query "assignee = currentUser()"
# Вывод в JSON для обработки
uv run scripts/core/jira-search.py query "project = PROJ" --json --max-results 100Управление задачами
# Получить детали задачи
uv run scripts/core/jira-issue.py get PROJ-123
# Обновить поля задачи (сначала dry-run)
uv run scripts/core/jira-issue.py update PROJ-123 --labels "urgent,backend" --dry-run
# Создать новую задачу
uv run scripts/workflow/jira-create.py issue PROJ "Implement feature X" --type Story --priority MediumУчёт времени
# Записать затраченное время
uv run scripts/core/jira-worklog.py add PROJ-123 "2h 30m" -c "Implemented core logic"
# Просмотреть ворклоги
uv run scripts/core/jira-worklog.py list PROJ-123Переходы рабочего процесса
# Список доступных переходов
uv run scripts/workflow/jira-transition.py list PROJ-123
# Выполнить переход (сначала dry-run)
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
# Выполнить переход
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress"Комментарии
# Добавить комментарий
uv run scripts/workflow/jira-comment.py add PROJ-123 "Investigation complete - root cause identified"
# Список последних комментариев
uv run scripts/workflow/jira-comment.py list PROJ-123 --limit 5