fetch-jira-issue

Fetch JIRA Issue

This skill fetches detailed information about a JIRA issue from the Red Hat JIRA REST API. It retrieves status, assignee, priority, resolution, comments, linked PRs, and classifies the issue's progress as ACTIVE, STALLED, or NEEDS_ATTENTION.

When to Use This Skill

Use this skill when you need to:

• Check the status and progress of a JIRA bug linked to a regression triage
• Determine if a bug is being actively worked on or needs attention
• Extract PR links from JIRA comments
• Get assignee and component information for a JIRA issue
• Analyze recent comment activity on a bug

Prerequisites

1. JIRA API Token: Required for authentication

   • Set environment variable: export JIRA_API_TOKEN="your-token"
   • Set environment variable: export JIRA_USERNAME="your-atlassian-email"
   • Obtain from: https://id.atlassian.com/manage-profile/security/api-tokens
   • Alternatively, pass --token TOKEN and --username USERNAME on the command line

2. Network Access: Must be able to reach redhat.atlassian.net

   • Check: curl -s -o /dev/null -w '%{http_code}' https://redhat.atlassian.net

3. Python 3: Python 3.6 or later

   • Check: python3 --version
   • Uses only standard library (no external dependencies)

Implementation Steps

Step 1: Run the Python Script

# Path to the Python script
script_path="plugins/ci/skills/fetch-jira-issue/fetch_jira_issue.py"

# Fetch issue data in JSON format (default)
python3 "$script_path" OCPBUGS-74401 --format json

# Or fetch as human-readable summary
python3 "$script_path" OCPBUGS-74401 --format summary

# Pass token explicitly instead of using JIRA_API_TOKEN env var
python3 "$script_path" OCPBUGS-74401 --token "your-token" --format json

Step 2: Parse the Output

The script outputs structured JSON data that can be further processed:

# Store result in variable
jira_data=$(python3 "$script_path" OCPBUGS-74401 --format json)

# Extract key fields
status=$(echo "$jira_data" | jq -r '.status')
assignee=$(echo "$jira_data" | jq -r '.assignee.display_name // "Unassigned"')
progress_level=$(echo "$jira_data" | jq -r '.progress.level')
progress_reason=$(echo "$jira_data" | jq -r '.progress.reason')

# Check progress classification
echo "Status: $status"
echo "Assignee: $assignee"
echo "Progress: $progress_level - $progress_reason"