AgentSkillsCN

acli

适用于 Jira 和 Confluence Cloud 任务的 Atlassian CLI（`acli`）。

SKILL.md
--- frontmatter
name: acli
description: Use the Atlassian CLI (`acli`) for Jira and Confluence Cloud tasks.

Atlassian CLI (acli)

Overview

Use the Atlassian CLI to manage Jira and Confluence Cloud resources from the command line.

Most Confusing Parts (Read First)

  • •Global vs product auth: acli auth manages global OAuth, while acli jira auth and acli confluence auth manage product-specific accounts.
  • •Jira uses the term "work item" in this CLI; it maps to Jira issues.
  • •Output formats: many commands support --json or --csv for scripting.
  • •Bulk changes are driven by JQL or filter IDs; confirm scope before running write actions.
  • •Rovo Dev commands may require acli rovodev auth login before help output is available.

Workflow (Use to Avoid Mistakes)

  1. •Ask for missing context: product (Jira/Confluence), site, project key, work item key, space key, and JQL/filter if applicable.
  2. •Confirm authentication with acli auth status (or product-specific status commands).
  3. •Run list/view/search commands before create/edit/delete actions.
  4. •For bulk actions, prefer --jql or --filter plus --json and use confirmation flags when available (for example --yes).

Common Tasks -> Commands

Auth

  • •Login: acli auth login
  • •Status: acli auth status
  • •Switch account: acli auth switch
  • •Logout: acli auth logout

Jira Projects

  • •List recent projects: acli jira project list --recent
  • •List all projects: acli jira project list --paginate --json

Jira Work Items (Issues)

  • •Search with JQL: acli jira workitem search --jql "project = TEAM" --fields "key,summary,assignee"
  • •View work item: acli jira workitem view KEY-123 --fields summary,status,assignee
  • •Create work item: acli jira workitem create --summary "New Task" --project "TEAM" --type "Task"
  • •Edit work item: acli jira workitem edit --key "KEY-123" --summary "New Summary" --assignee "@me"
  • •Comment on work item: acli jira workitem comment create --key "KEY-123" --body "This is a comment"

Confluence Spaces

  • •List spaces: acli confluence space list --type global
  • •View space: acli confluence space view --id 123456 --include-all --json

Gov Cloud Config

  • •Status: acli config gov-cloud --status
  • •Enable/disable: acli config gov-cloud --enable=false

Capability Index

  • •Core CLI, auth, admin, completion, config, feedback, rovodev auth: skills/acli/references/acli-core.md.
  • •Jira commands (boards, dashboards, fields, filters, projects, sprints): skills/acli/references/jira.md.
  • •Jira work items (issues), comments, links, attachments, watchers: skills/acli/references/jira-workitem.md.
  • •Confluence commands (auth, spaces): skills/acli/references/confluence.md.

References

  • •Load the smallest relevant reference file first to keep context tight.