d48cda4081
CI / Test (ubuntu-latest, Node 18.x, bun) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, npm) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, pnpm) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 18.x, yarn) (push) Failing after 15m1s
CI / Test (ubuntu-latest, Node 20.x, bun) (push) Failing after 17m13s
CI / Test (ubuntu-latest, Node 20.x, npm) (push) Failing after 18m42s
CI / Test (ubuntu-latest, Node 20.x, pnpm) (push) Failing after 15m0s
CI / Test (ubuntu-latest, Node 20.x, yarn) (push) Failing after 49m44s
CI / Test (ubuntu-latest, Node 22.x, bun) (push) Failing after 51m55s
CI / Test (ubuntu-latest, Node 22.x, pnpm) (push) Failing after 21m57s
CI / Test (ubuntu-latest, Node 22.x, npm) (push) Failing after 37m39s
CI / Test (ubuntu-latest, Node 22.x, yarn) (push) Failing after 34m7s
CI / Validate Components (push) Failing after 37m15s
CI / Python Tests (push) Failing after 10m1s
CI / Security Scan (push) Failing after 10m1s
CI / Lint (push) Failing after 17m12s
CI / Coverage (push) Failing after 20m19s
CI / Test (macos-latest, Node 18.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, yarn) (push) Has been cancelled
107 lines
3.0 KiB
Markdown
107 lines
3.0 KiB
Markdown
---
|
|
description: Retrieve a Jira ticket, analyze requirements, update status, or add comments. Uses the jira-integration skill and MCP or REST API.
|
|
---
|
|
|
|
# Jira Command
|
|
|
|
Interact with Jira tickets directly from your workflow — fetch tickets, analyze requirements, add comments, and transition status.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/jira get <TICKET-KEY> # Fetch and analyze a ticket
|
|
/jira comment <TICKET-KEY> # Add a progress comment
|
|
/jira transition <TICKET-KEY> # Change ticket status
|
|
/jira search <JQL> # Search issues with JQL
|
|
```
|
|
|
|
## What This Command Does
|
|
|
|
1. **Get & Analyze** — Fetch a Jira ticket and extract requirements, acceptance criteria, test scenarios, and dependencies
|
|
2. **Comment** — Add structured progress updates to a ticket
|
|
3. **Transition** — Move a ticket through workflow states (To Do → In Progress → Done)
|
|
4. **Search** — Find issues using JQL queries
|
|
|
|
## How It Works
|
|
|
|
### `/jira get <TICKET-KEY>`
|
|
|
|
1. Fetch the ticket from Jira (via MCP `jira_get_issue` or REST API)
|
|
2. Extract all fields: summary, description, acceptance criteria, priority, labels, linked issues
|
|
3. Optionally fetch comments for additional context
|
|
4. Produce a structured analysis:
|
|
|
|
```
|
|
Ticket: PROJ-1234
|
|
Summary: [title]
|
|
Status: [status]
|
|
Priority: [priority]
|
|
Type: [Story/Bug/Task]
|
|
|
|
Requirements:
|
|
1. [extracted requirement]
|
|
2. [extracted requirement]
|
|
|
|
Acceptance Criteria:
|
|
- [ ] [criterion from ticket]
|
|
|
|
Test Scenarios:
|
|
- Happy Path: [description]
|
|
- Error Case: [description]
|
|
- Edge Case: [description]
|
|
|
|
Dependencies:
|
|
- [linked issues, APIs, services]
|
|
|
|
Recommended Next Steps:
|
|
- /plan to create implementation plan
|
|
- `tdd-workflow` skill to implement with tests first
|
|
```
|
|
|
|
### `/jira comment <TICKET-KEY>`
|
|
|
|
1. Summarize current session progress (what was built, tested, committed)
|
|
2. Format as a structured comment
|
|
3. Post to the Jira ticket
|
|
|
|
### `/jira transition <TICKET-KEY>`
|
|
|
|
1. Fetch available transitions for the ticket
|
|
2. Show options to user
|
|
3. Execute the selected transition
|
|
|
|
### `/jira search <JQL>`
|
|
|
|
1. Execute the JQL query against Jira
|
|
2. Return a summary table of matching issues
|
|
|
|
## Prerequisites
|
|
|
|
This command requires Jira credentials. Choose one:
|
|
|
|
**Option A — MCP Server (recommended):**
|
|
Add `jira` to your `mcpServers` config (see `mcp-configs/mcp-servers.json` for the template).
|
|
|
|
**Option B — Environment variables:**
|
|
```bash
|
|
export JIRA_URL="https://yourorg.atlassian.net"
|
|
export JIRA_EMAIL="your.email@example.com"
|
|
export JIRA_API_TOKEN="your-api-token"
|
|
```
|
|
|
|
If credentials are missing, stop and direct the user to set them up.
|
|
|
|
## Integration with Other Commands
|
|
|
|
After analyzing a ticket:
|
|
- Use `/plan` to create an implementation plan from the requirements
|
|
- Use the `tdd-workflow` skill to implement with test-driven development
|
|
- Use `/code-review` after implementation
|
|
- Use `/jira comment` to post progress back to the ticket
|
|
- Use `/jira transition` to move the ticket when work is complete
|
|
|
|
## Related
|
|
|
|
- **Skill:** `skills/jira-integration/`
|
|
- **MCP config:** `mcp-configs/mcp-servers.json` → `jira`
|