shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

jira-communication

通过Python CLI脚本执行Jira API操作。当用户提到Jira URL（https://jira.*/browse/*, https://*.atlassian.net/browse/*）、问题键（PROJ-123）或询问关于Jira问题时自动触发。在Claude需要执行以下操作时使用：(1) 使用JQL查询搜索问题，(2) 获取或更新问题详情，(3) 创建新问题，(4) 转换问题状态（例如，“待办”→“完成”），(5) 添加评论，(6) 记录工作时间（工作日志），(7) 列出冲刺和冲刺问题，(8) 列出看板和看板问题，(9) 创建或列出问题链接，(10) 发现可用的Jira字段，(11) 获取用户资料信息，(12) 从问题中下载附件。如果身份验证失败，通过jira-setup.py提供交互式凭证设置。支持Jira Cloud和Server/Data Center，并能自动检测认证。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Jira Communication

CLI scripts for Jira operations using uv run. All scripts support --help, --json, --quiet, --debug.

Auto-Trigger

Trigger when user mentions:

  • Jira URLs: https://jira.*/browse/*, https://*.atlassian.net/browse/*
  • Issue keys: PROJ-123, NRS-4167

When triggered by URL → extract issue key → run jira-issue.py get PROJ-123

Auth Failure Handling

When auth fails, offer: uv run scripts/core/jira-setup.py (interactive credential setup)

Scripts

| Script | Purpose | |--------|---------| | scripts/core/jira-setup.py | Interactive credential config | | scripts/core/jira-validate.py | Verify connection | | scripts/core/jira-issue.py | Get/update issue details | | scripts/core/jira-search.py | Search with JQL | | scripts/core/jira-worklog.py | Time tracking | | scripts/core/jira-attachment.py | Download attachments | | scripts/workflow/jira-create.py | Create issues | | scripts/workflow/jira-transition.py | Change status | | scripts/workflow/jira-comment.py | Add comments | | scripts/workflow/jira-sprint.py | List sprints | | scripts/workflow/jira-board.py | List boards | | scripts/utility/jira-user.py | User info | | scripts/utility/jira-fields.py | Search fields | | scripts/utility/jira-link.py | Issue links |

Critical: Flag Ordering

Global flags MUST come before subcommand:

# Correct:  uv run scripts/core/jira-issue.py --json get PROJ-123
# Wrong:    uv run scripts/core/jira-issue.py get PROJ-123 --json

Quick Examples

uv run scripts/core/jira-validate.py --verbose
uv run scripts/core/jira-search.py query "assignee = currentUser()"
uv run scripts/core/jira-issue.py get PROJ-123
uv run scripts/core/jira-worklog.py add PROJ-123 2h --comment "Work done"
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run

Related Skills

jira-syntax: For descriptions/comments. Jira uses wiki markup, NOT Markdown.

References

  • references/jql-quick-reference.md - JQL syntax
  • references/troubleshooting.md - Setup and auth issues

Authentication

Cloud: JIRA_URL + JIRA_USERNAME + JIRA_API_TOKEN Server/DC: JIRA_URL + JIRA_PERSONAL_TOKEN

Config via ~/.env.jira or env vars. Run jira-validate.py --verbose to verify.