jira

# Jira Integration Skill This skill enables direct interaction with Jira Cloud via REST API v3 and JQL queries. ## Prerequisites Set these environment variables (or in `.env` file): ```bash JIRA_DOMAIN=company.atlassian.net JIRA_EMAIL=user@company.com JIRA_API_TOKEN=your-api-token ``` Generate API tokens at: <https://id.atlassian.com/manage-profile/security/api-tokens> ## Core Workflows ### 1. Get Issue Details To retrieve issue information: ```bash python scripts/jira_api.py GET /issue/PROJ-123 ``` With specific fields: ```bash python scripts/jira_api.py GET "/issue/PROJ-123?fields=summary,status,assignee" ``` ### 2. Search with JQL To search issues using JQL: ```bash python scripts/jira_api.py GET /search --query "jql=project=AOP AND status='In Progress'&maxResults=20" ``` Common JQL patterns - see `references/jql-reference.md`: - My open issues: `assignee = currentUser() AND resolution = Unresolved` - Recent updates: `updated >= -1d ORDER BY updated DESC` - Sprint work: `sprint in openSprints() AND assignee = currentUser()` ### 3. Create Issue To create a new issue, use ADF format for description (see `references/adf-format.md`): ```bash python scripts/jira_api.py POST /issue --data '{ "fields": { "project": { "key": "PROJ" }, "issuetype": { "name": "Task" }, "summary": "Issue title", "description": { "type": "doc", "version": 1, "content": [ { "type": "paragraph", "content": [{ "type": "tex...