jira-issue

Core CRUD operations for JIRA issues - create, read, update, and delete tickets.

Risk Levels

Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

⚠️ PRIMARY USE CASE: Viewing Issue Details

This skill MUST be invoked when the user wants to see issue information.

CRITICAL: When user asks to view/show/get/see issue details, you MUST:

1. •Load this skill immediately (if not already loaded)
2. •Use the jira-as issue get command to retrieve the issue
3. •Display the full issue information to the user

Common phrases that REQUIRE invoking this skill:

• •"Show me [the issue/bug/task]" → Use jira-as issue get
• •"Get details of [issue]" → Use jira-as issue get
• •"View [the issue we created]" → Use jira-as issue get
• •"What's in [issue key]?" → Use jira-as issue get
• •"Display issue information" → Use jira-as issue get
• •"Look up [issue]" → Use jira-as issue get
• •"See [the bug]" → Use jira-as issue get
• •"Details of the bug/task/issue" → Use jira-as issue get

When to Use This Skill

Triggers: User asks to...

• •View/show/display/get/retrieve/see/check issue details ← Most common use case
• •Create a new JIRA issue (bug, task, story, epic)
• •Look up or examine an issue
• •Update issue fields (summary, description, priority, assignee, labels)
• •Delete an issue

Context awareness: If the user refers to "the issue/bug/task we just created" or uses pronouns like "it", resolve to the most recently created/mentioned issue in the conversation and retrieve its details.

Available Commands

This skill provides the following commands via the jira-as issue CLI:

• •jira-as issue create: Create new issues
• •jira-as issue get: Retrieve issue details
• •jira-as issue update: Modify issue fields
• •jira-as issue delete: Remove issues

All commands support --help for full option documentation.

Global Options

All commands inherit global options from the parent jira-as command:

• •--output, -o: Output format for get and create commands (text, json)

Templates

Pre-configured templates for common issue types:

• •bug_template.json - Bug report template
• •task_template.json - Task template
• •story_template.json - User story template

Use the --template option to apply a template during issue creation:

# Quick bug report using template
jira-as issue create --project PROJ --template bug --summary "Login page error"

# Quick task using template
jira-as issue create --project PROJ --template task --summary "Update documentation"

# Quick story using template
jira-as issue create --project PROJ --template story --summary "User can reset password"

Common Patterns

Create Issues

# Basic issue creation
jira-as issue create --project PROJ --type Bug --summary "Login fails on mobile"

# With description
jira-as issue create --project PROJ --type Bug --summary "Login fails on mobile" \
  --description "Users report 500 error when logging in from mobile browsers. See attached screenshot."

# With assignee (use 'self' for current user)
jira-as issue create --project PROJ --type Task --summary "Review PR #42" \
  --assignee self

# With agile fields
jira-as issue create --project PROJ --type Story --summary "User login" \
  --epic PROJ-100 --story-points 5

# With relationships and time estimate
jira-as issue create --project PROJ --type Task --summary "Setup database" \
  --blocks PROJ-123 --estimate "2d"

# With 'relates to' links
jira-as issue create --project PROJ --type Task --summary "Related feature" \
  --relates-to PROJ-456,PROJ-789

# With labels and components
jira-as issue create --project PROJ --type Task --summary "Setup CI pipeline" \
  --labels "backend,infrastructure" --components "Build,DevOps"

# With custom fields (JSON format)
jira-as issue create --project PROJ --type Bug --summary "Critical bug" \
  --custom-fields '{"customfield_10050": "production"}'

# Assign to sprint
jira-as issue create --project PROJ --type Story --summary "Feature X" \
  --sprint 42

# Create without project context defaults
jira-as issue create --project PROJ --type Bug --summary "Bug" --no-defaults

Retrieve Issues

# Basic retrieval
jira-as issue get PROJ-123

# With full details
jira-as issue get PROJ-123 --detailed --show-links --show-time

# Retrieve specific fields only
jira-as issue get PROJ-123 --fields "summary,status,priority,assignee"

# JSON output for scripting
jira-as issue get PROJ-123 --output json

Note: Using --show-links or --show-time automatically enables detailed view.

Update Issues

# Update priority and assignee
jira-as issue update PROJ-123 --priority Critical --assignee self

# Update description
jira-as issue update PROJ-123 --description "Updated description with **markdown** support"

# Update without notifications
jira-as issue update PROJ-123 --summary "Updated title" --no-notify

# Unassign issue (accepts "none" or "unassigned")
jira-as issue update PROJ-123 --assignee none

# Update labels and components (replaces existing)
jira-as issue update PROJ-123 --labels "urgent,reviewed" --components "API"

# Update custom fields
jira-as issue update PROJ-123 --custom-fields '{"customfield_10050": "staging"}'

Assignee special values:

• •self: Assigns to the current authenticated user
• •none or unassigned: Removes the assignee

Delete Issues

# Delete with confirmation
jira-as issue delete PROJ-456

# Force delete (no prompt)
jira-as issue delete PROJ-456 --force

Example Workflows

Create and View Issue

This is the most common workflow - create an issue, then immediately view its details:

# 1. Create a bug
jira-as issue create --project DEMO --type Bug --summary "Login fails on mobile" --priority High

# Output: Created DEMO-105

# 2. View the details of the bug we just created
jira-as issue get DEMO-105

# Output shows:
# - Issue Key: DEMO-105
# - Type: Bug
# - Summary: Login fails on mobile
# - Priority: High
# - Status: Open (or whatever the initial status is)
# - And all other fields

When user says "Show me the details of the bug we just created", this skill should:

1. •Identify the most recently created issue from context (e.g., DEMO-105)
2. •Execute: jira-as issue get DEMO-105
3. •Display the full issue details including key, type, summary, priority, status, etc.

Shell Completion

To enable shell completion for the jira-as CLI, add the appropriate command to your shell's configuration file (e.g., .bashrc, .zshrc, config.fish).

Bash:

eval "$(_JIRA_AS_COMPLETE=bash_source jira-as)"

Zsh:

eval "$(_JIRA_AS_COMPLETE=zsh_source jira-as)"

Fish:

_JIRA_AS_COMPLETE=fish_source jira-as | source

Exit Codes

Troubleshooting

For credential setup, generate tokens at: https://id.atlassian.com/manage-profile/security/api-tokens

Configuration

Requires JIRA credentials via environment variables (JIRA_SITE_URL, JIRA_EMAIL, JIRA_API_TOKEN).

Related Resources

Resources in the skill directory (skills/jira-issue/):

• •docs/BEST_PRACTICES.md - Issue content and metadata guidance
• •references/field_formats.md - ADF and field format details
• •references/api_reference.md - REST API endpoints

Related Skills

• •jira-lifecycle: Workflow transitions and status changes
• •jira-search: JQL queries for finding issues
• •jira-collaborate: Comments, attachments, watchers
• •jira-agile: Sprint and epic management
• •jira-relationships: Issue linking and dependencies
• •jira-time: Time tracking and worklogs