JIRA Developer Integration Skill

Developer workflow integration for JIRA including Git, CI/CD, and release automation.

Risk Levels

Operation	Risk	Notes
Generate branch name	-	Read-only, local output
Parse commits	-	Read-only, local analysis
Get commits	-	Read-only
Generate PR description	-	Read-only, local output
Link commit	-	Adds metadata, easily removed
Link PR	-	Adds metadata, easily removed

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

Quick Start: Get started in 10 minutes

When to Use This Skill

Use this skill when you need to:

Starting Development:

• Generate standardized Git branch names from JIRA issues
• Create feature, bugfix, or hotfix branches with consistent naming

During Development:

• Extract JIRA issue keys from commit messages
• Link Git commits to JIRA issues via comments
• Log time and transition issues from commits (Smart Commits)

Code Review:

• Generate PR descriptions from JIRA issue details
• Link Pull Requests (GitHub, GitLab, Bitbucket) to JIRA issues

CI/CD Integration:

• Track builds and deployments in JIRA
• Auto-transition issues based on PR/deployment events
• Generate release notes from JIRA versions

Troubleshooting:

• Debug why Development Panel shows empty
• Fix Smart Commits not working
• Resolve PR linking issues

IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.

Available Commands

All commands support --help for full documentation.

Command	Description
jira-as dev branch-name	Generate consistent branch names from issues
jira-as dev parse-commits	Extract issue keys from commit messages
jira-as dev link-commit	Link commits to JIRA issues
jira-as dev get-commits	Retrieve development information
jira-as dev link-pr	Automatically link PRs to JIRA
jira-as dev pr-description	Generate PR descriptions from issues

Recommended Starting Points

Role	Start With
Developer	jira-as dev branch-name PROJ-123
Git Administrator	Branch names, then PR integration
DevOps Engineer	CI/CD integration with link-pr and link-commit
Release Manager	Deployment tracking with link-pr

Advanced: See CI/CD Integration Guide for pipeline setup.

Quick Examples

# Generate branch name with default prefix (feature)
jira-as dev branch-name PROJ-123

# Generate branch name with explicit prefix (-p is short for --prefix)
jira-as dev branch-name PROJ-123 -p bugfix
jira-as dev branch-name PROJ-123 --prefix bugfix

# Auto-detect prefix from issue type (Bug -> bugfix, Story -> feature, etc.)
jira-as dev branch-name PROJ-123 --auto-prefix

# Output git checkout command directly (-o is short for --output)
jira-as dev branch-name PROJ-123 -o git

# Extract issues from a single commit message
jira-as dev parse-commits "feat(PROJ-123): add login"

# Extract issues from git log via pipe
git log --oneline -10 | jira-as dev parse-commits --from-stdin

# Filter to specific project (-p is short for --project)
jira-as dev parse-commits "Fix PROJ-123 and OTHER-456" -p PROJ

# Generate PR description with testing checklist (-c is short for --include-checklist)
jira-as dev pr-description PROJ-123 -c
jira-as dev pr-description PROJ-123 --include-checklist

# Generate PR description with labels (-l is short for --include-labels)
jira-as dev pr-description PROJ-123 -l --include-components

# Generate PR description and copy to clipboard
jira-as dev pr-description PROJ-123 --copy

# Link PR to issue (-p is short for --pr)
jira-as dev link-pr PROJ-123 -p https://github.com/org/repo/pull/456

# Link PR with title (-t is short for --title)
jira-as dev link-pr PROJ-123 -p https://github.com/org/repo/pull/456 -t "Fix authentication bug"

# Link PR with status and author (-s, -a are short forms)
jira-as dev link-pr PROJ-123 -p https://github.com/org/repo/pull/456 -s merged -a "Jane Doe"

# Link commit to issue (-c is short for --commit, -m for --message, -r for --repo)
jira-as dev link-commit PROJ-123 -c abc123def -m "feat: add login" -r https://github.com/org/repo

# Link commit with additional metadata (-a for --author, -b for --branch)
jira-as dev link-commit PROJ-123 -c abc123def -a "John Doe" -b feature/login

# Get commits linked to issue
jira-as dev get-commits PROJ-123

# Get commits with detailed information
jira-as dev get-commits PROJ-123 --detailed

# Get commits filtered by repository (-o is short for --output)
jira-as dev get-commits PROJ-123 --repo "org/repo" -o table

Configuration

Requires JIRA credentials via environment variables:

Setting	Description
JIRA_SITE_URL	Your JIRA instance URL
JIRA_EMAIL	Your JIRA email
JIRA_API_TOKEN	Your JIRA API token

Common Options

Option	Description
--output, -o	Output format varies by command (see below)
--help	Show detailed help and examples

Output Formats by Command

Command	Available Formats
branch-name	text, json, git
parse-commits	text, json, csv
pr-description	text, json
link-commit	text, json
link-pr	text, json
get-commits	text, json, table

Exit Codes

Code	Meaning
0	Success
1	Error (validation, API, config)
2	Invalid arguments

Troubleshooting

See Common Pitfalls Guide for solutions to:

• Development Panel showing empty
• Smart Commits not working
• PR linking issues
• Branch name problems

Advanced Topics

Topic	Guide
Branch naming conventions	Branch Naming
Commit message formats	Commit Messages
Smart Commits	Smart Commits
PR workflows	PR Workflows
Development Panel	Development Panel
CI/CD integration	CI/CD Integration
Automation rules	Automation Rules
Deployment tracking	Deployment Tracking
Release notes	Release Notes

For comprehensive guidance, see Best Practices Guide.

Related Skills

Skill	Relationship
jira-issue	Get issue details for branch names
jira-lifecycle	Auto-transition on PR merge
jira-collaborate	Commit linking uses comments
jira-search	Find issues for bulk operations
jira-bulk	Process multiple issues from commits