jira-communication

📁 netresearch/jira-skill 📅 10 days ago
12
总安装量
4
周安装量
#26073
全站排名
安装命令
npx skills add https://github.com/netresearch/jira-skill --skill jira-communication

Agent 安装分布

opencode 3
github-copilot 2
claude-code 2
replit 1
amp 1
openclaw 1

Skill 文档

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.