AgentSkillsCN

acli-jira-subcommand-syntax

在查询 Jira 时，acli（Atlassian CLI）工具的正确语法如下：当用户要求搜索 Jira 问题、列出工单、查询工作项，或在 Jira 中使用 acli CLI 时，请采用此语法。acli 工具采用基于子命令的语法格式（acli jira workitem search），而非已弃用的 --action 标志模式。触发关键词包括：acli、jira、workitem、search、tickets、issues、JQL。

SKILL.md
--- frontmatter
name: acli-jira-subcommand-syntax
description: >
  Correct syntax for the acli (Atlassian CLI) tool when querying Jira.
  Use when the user asks to search Jira issues, list tickets, query workitems,
  or use the acli CLI with Jira. The acli tool uses subcommand-based syntax
  (acli jira workitem search) NOT the deprecated --action flag pattern.
  Trigger keywords: acli, jira, workitem, search, tickets, issues, JQL.

acli Jira Subcommand Syntax

The acli CLI tool uses a modern subcommand-based syntax for Jira operations. Do NOT use the deprecated --action flag pattern. This skill prevents the common mistake of using acli jira --action getIssueList and similar flag-based patterns that will fail.

Instructions

  1. •When running any acli command for Jira, always use the subcommand pattern: acli jira <resource> <action> [flags].
  2. •To search for Jira issues, use acli jira workitem search with the --jql flag for the query and --fields flag for output columns.
  3. •Never use --action as a flag with acli. The action is always a positional subcommand.
  4. •If a command fails with "unknown flag: --action", rewrite it using the subcommand pattern described here.

Syntax Reference

The general pattern for acli Jira commands is:

code
acli jira <resource> <action> [--flag value ...]

Searching for Issues

bash
acli jira workitem search --jql "<JQL query>" --fields "<comma-separated fields>"

Common flags for acli jira workitem search:

  • •--jql - JQL query string
  • •--fields - Comma-separated list of fields to display (e.g., "key,summary,priority,status")
  • •--csv - Output in CSV format
  • •--json - Output in JSON format
  • •--limit - Limit number of results
  • •--paginate - Enable pagination
  • •--filter - Use a saved filter
  • •--web - Open results in web browser
  • •--count - Show count only

Examples

Example 1: List unresolved tickets assigned to current user

Input:

code
Show me my open Jira tickets

Command:

bash
acli jira workitem search --jql "assignee = currentUser() AND resolution = Unresolved ORDER BY priority DESC" --fields "key,summary,priority,status"

Example 2: Common mistake to avoid

Incorrect (will fail with "unknown flag: --action"):

bash
acli jira --action getIssueList --jql "assignee = currentUser()"

Correct:

bash
acli jira workitem search --jql "assignee = currentUser()"

Troubleshooting

ProblemCauseFix
Error: unknown flag: --actionUsing deprecated --action flag syntaxRewrite using subcommand pattern: acli jira workitem search instead of acli jira --action getIssueList
Error: unknown commandWrong resource or action nameRun acli jira --help to see available subcommands, then acli jira workitem --help for actions