AgentSkillsCN

jira-cli

一款专为 Atlassian Jira 设计的交互式命令行工具。当用户希望与 Jira 问题、史诗、冲刺进行交互，或在提及 Jira 工作流、问题管理，又或是需要协助使用 jira-cli 命令与工作流时，可使用此技能。

SKILL.md
--- frontmatter
name: jira-cli
description: Interactive command-line tool for Atlassian Jira. This skill should be used when users want to interact with Jira issues, epics, sprints, or when they mention Jira workflows, issue management, or need help with jira-cli commands and workflows.
model: sonnet

Jira CLI

Interactive command-line tool for Atlassian Jira that minimizes reliance on the web interface while maintaining essential functionality for daily Jira operations.

Overview

JiraCLI (jira-cli) is a command line tool for managing Jira issues, epics, and sprints. Supports both Jira Cloud and on-premise installations with multiple authentication methods.

For AI use, always add --plain flag to get plain text output suitable for parsing.

When to Use This Skill

Use this skill when:

  • •Managing Jira issues from the command line
  • •Creating, editing, or viewing Jira tickets
  • •Working with epics and sprints
  • •Automating Jira workflows
  • •Users mention "jira", "ticket", "issue", "epic", or "sprint"
  • •Writing scripts for Jira automation

Essential Commands

bash
# List recent issues (always use --plain for AI)
jira issue list --plain

# View issue details
jira issue view ISSUE-1 --plain

# Create an issue
jira issue create -tBug -s"Bug title" -yHigh -b"Description"

# Assign issue to yourself
jira issue assign ISSUE-1 $(jira me)

# Move issue to "In Progress"
jira issue move ISSUE-1 "In Progress"

# Add comment
jira issue comment add ISSUE-1 --comment "My comment"

# Add worklog
jira issue worklog add ISSUE-1 "2h" --comment "Implementation work"

How to Use This Skill

For detailed command reference and examples, load the appropriate reference file:

1. Comprehensive Commands Reference

Load: references/commands.md

Use this file when you need:

  • •Detailed command syntax and options
  • •All available flags and parameters
  • •Issue management operations (list, create, edit, assign, move, view, link, clone, delete)
  • •Epic management (list, create, add/remove issues)
  • •Sprint management (list, add issues)
  • •Release management
  • •Output format options
  • •Non-interactive command patterns

2. Common Workflow Examples

Load: references/workflows.md

Use this file when you need:

  • •Daily standup preparation workflows
  • •Sprint planning commands
  • •Code review workflow integration
  • •Bug triage procedures
  • •Team collaboration patterns
  • •Best practices for different scenarios

3. Scripting and Automation

Load: references/scripting.md

Use this file when you need:

  • •Bash automation scripts
  • •Data extraction and reporting
  • •Integration with CI/CD pipelines
  • •Metrics and analytics examples
  • •Bulk operations

Quick Reference

Powerful List Filters

bash
# Combine flags for precise queries (always add --plain)
jira issue list --plain -a$(jira me) -yHigh -s"To Do" --created -7d -lbackend

# Use tilde (~) as NOT operator
jira issue list --plain -s~Done --created-before -24w

# Filter by multiple criteria
jira issue list --plain -yHigh,Critical -s"In Progress" -lbug

# List issues I'm watching
jira issue list --plain -w

# List issues assigned to no one created this week
jira issue list --plain -ax --created week

# List issues created within an hour
jira issue list --plain --created -1h

# List issues from history (recently viewed)
jira issue list --plain --history

Sprint Management

bash
# List current active sprint issues
jira sprint list --plain --current

# List current sprint issues assigned to me
jira sprint list --plain --current -a$(jira me)

# List previous sprint issues
jira sprint list --plain --prev

# List next planned sprint issues
jira sprint list --plain --next

# List future and active sprints
jira sprint list --plain --state future,active

# List issues in a specific sprint (use sprint ID)
jira sprint list --plain SPRINT_ID

# Add issues to a sprint
jira sprint add SPRINT_ID ISSUE-1 ISSUE-2

Epic Management

bash
# List epics in table view
jira epic list --plain --table

# List issues in an epic
jira epic list --plain KEY-1

# List unassigned high priority issues in an epic
jira epic list --plain KEY-1 -ax -yHigh

# Add issues to an epic (up to 50 at once)
jira epic add EPIC-KEY ISSUE-1 ISSUE-2

# Remove issues from an epic
jira epic remove ISSUE-1 ISSUE-2

Useful Scripts

bash
# Get ticket count per sprint
sprints=$(jira sprint list --table --plain --columns id,name --no-headers)
echo "${sprints}" | while read -r id name; do
  count=$(jira sprint list "${id}" --plain --no-headers 2>/dev/null | wc -l)
  printf "%s: %d\n" "${name}" "${count}"
done

# List tickets created today
jira issue list --plain --created -1d

# List high priority bugs assigned to me
jira issue list --plain -a$(jira me) -tBug -yHigh

# Get issues by date range
jira issue list --plain --created week
jira issue list --plain --created month
jira issue list --plain --created -7d
jira issue list --plain --updated -30m

Resources