| name | project-jira |
| description | Jira issue tracking and incident management. Use when creating, searching, or updating Jira issues. Supports JQL queries for incident ticket analysis and alert fatigue tracking. |
| allowed-tools | Bash(python *) |
Jira Integration
Authentication
IMPORTANT: Credentials are injected automatically by a proxy layer. Do NOT check for JIRA_API_TOKEN or JIRA_EMAIL in environment variables - they won't be visible to you. Just run the scripts directly; authentication is handled transparently.
Configuration environment variables you CAN check (non-secret):
JIRA_URL - Jira instance URL (e.g., https://your-company.atlassian.net)
Available Scripts
All scripts are in .claude/skills/project-jira/scripts/
search_issues.py - Search with JQL
Powerful search using Jira Query Language. Best for finding incident tickets, patterns, action items.
python .claude/skills/project-jira/scripts/search_issues.py --jql "JQL_QUERY" [--max-results N]
python .claude/skills/project-jira/scripts/search_issues.py --jql "type = Bug AND status != Done AND created >= -7d"
python .claude/skills/project-jira/scripts/search_issues.py --jql "labels = incident AND created >= -30d" --max-results 50
get_issue.py - Get Issue Details
python .claude/skills/project-jira/scripts/get_issue.py --issue-key PROJ-123
create_issue.py - Create New Issue
python .claude/skills/project-jira/scripts/create_issue.py --project PROJ --summary "Title" --description "Details" [--type Bug] [--priority High] [--labels "incident,p1"]
update_issue.py - Update Existing Issue
python .claude/skills/project-jira/scripts/update_issue.py --issue-key PROJ-123 [--summary "New title"] [--status "In Progress"] [--priority High]
add_comment.py - Add Comment
python .claude/skills/project-jira/scripts/add_comment.py --issue-key PROJ-123 --comment "Investigation findings..."
list_issues.py - List Project Issues
python .claude/skills/project-jira/scripts/list_issues.py --project PROJ [--max-results 20]
JQL Quick Reference
Common Patterns
# Recent bugs
type = Bug AND created >= -7d ORDER BY created DESC
# Open incidents
type = Incident AND status != Done
# By label
labels IN ("incident", "p1", "alert-tuning")
# Text search
summary ~ "high CPU" OR description ~ "timeout"
# Stale issues
updated <= -90d AND status != Done
Operators
| Operator | Meaning | Example |
|---|
| = | Equals | status = Done |
| != | Not equals | status != Done |
| ~ | Contains text | summary ~ "error" |
| IN | In list | status IN ("Open", "In Progress") |
| >= | Greater/equal | created >= -7d |
| ORDER BY | Sort | ORDER BY created DESC |
Investigation Workflow
Incident Ticket Analysis
1. Search for related incidents:
search_issues.py --jql "type = Incident AND created >= -30d"
2. Get details of specific incident:
get_issue.py --issue-key INC-456
3. Add investigation findings:
add_comment.py --issue-key INC-456 --comment "Root cause: ..."
4. Update status:
update_issue.py --issue-key INC-456 --status "Resolved"
