返回 Skill 列表
extension
分类: 开发与工程无需 API Key

jira-integration

代理技能:通过轻量级Python脚本实现全面的Jira集成。当用户提及像'https://jira.*/browse/*'、'https://*.atlassian.net/browse/*'这样的Jira URL,或像'PROJ-123'这样的问题键时自动触发。可用于搜索问题(JQL)、获取/更新问题详情、创建问题、转换状态、添加评论、记录工作日志、管理冲刺和看板、创建问题链接或格式化Jira Wiki标记。如果认证失败,提供交互式配置凭证选项。支持Jira Cloud以及Server/Data Center,并具备自动认证检测功能。由Netresearch提供。

person作者: jakexiaohubgithub

Jira Integration Skill

Comprehensive Jira integration through lightweight Python CLI scripts.

Note: Run scripts from skills/jira-communication/, or use full paths from repo root.

Auto-Trigger Patterns

AUTOMATICALLY ACTIVATE when user mentions:

  • Jira URLs: https://jira.*/browse/*, https://*.atlassian.net/browse/*
  • Issue keys: Pattern like PROJ-123, NRS-4167, ABC-1
  • Keywords: "Jira issue", "Jira ticket", "search Jira"

Authentication Failure Handling

CRITICAL: When authentication fails, DO NOT just display the error. Instead:

  1. Detect failure - Look for "Missing required variable" or 401/403 responses
  2. Offer help - Ask: "Would you like me to help configure Jira credentials?"
  3. Run interactive setup - uv run skills/jira-communication/scripts/core/jira-setup.py

Sub-Skills

| Skill | Purpose | |-------|---------| | jira-communication | API operations via Python CLI scripts | | jira-syntax | Wiki markup syntax, templates, validation |

Scripts Reference

Core Operations

| Script | Purpose | |--------|---------| | jira-setup.py | Interactive credential setup | | jira-validate.py | Verify connection | | jira-issue.py | Get/update issue details | | jira-search.py | Search with JQL | | jira-worklog.py | Time tracking | | jira-attachment.py | Download attachments |

Workflow Operations

| Script | Purpose | |--------|---------| | jira-create.py | Create issues | | jira-transition.py | Change status | | jira-comment.py | Comments | | jira-link.py | Issue links | | jira-sprint.py | Sprint management | | jira-board.py | Board operations |

Syntax Note

Jira uses wiki markup, NOT Markdown. See skills/jira-syntax/SKILL.md for syntax guide.


Contributing: https://github.com/netresearch/jira-skill