用途：acli 是 Atlassian 官方命令行工具，用于操作 Jira Cloud 及 Atlassian 组织管理。本技能为参考指南，二进制文件不随技能打包，需用户自行安装并完成认证。
前置条件：需先安装 acli，安装指引见 https://developer.atlassian.com/cloud/acli/guides/install-acli/ 。可用 acli --help 验证是否可用。
认证：运行命令前先检查状态，如 acli jira auth status、acli admin auth status。未认证时可选三种方式：OAuth 交互登录 acli jira auth login --web；API Token 非交互登录（适合 CI/自动化）echo "$API_TOKEN" | acli jira auth login --site "mysite.atlassian.net" --email "user@atlassian.com" --token；Admin API Key（仅管理命令）echo "$API_KEY" | acli admin auth login --email "admin@atlassian.com" --token。可用 auth switch 切换账号。
主要能力：顶层命令分四组——acli jira（工作项、项目、看板、冲刺、筛选器、仪表盘、字段）、acli admin（组织用户管理与认证）、acli rovodev（Rovo Dev AI 编码代理，Beta）、acli feedback（反馈与缺陷报告）。多数列表/搜索命令支持 --json、--csv 与默认表格输出。批量操作可通过 --key、--jql、--filter、--from-file 指定目标，配合 --ignore-errors、--yes。分页用 --limit、--paginate。创建/编辑命令支持 --generate-json 生成模板与 --from-json 读取模板。
安全与限制：切勿硬编码令牌或密钥，应使用环境变量或文件输入，避免记录或回显令牌，交互场景优先 OAuth。破坏性或不可逆命令（如 workitem delete、project delete、admin user delete/deactivate、field delete）执行前必须获得用户明确确认；批量操作前先用相同查询展示受影响目标，优先 --json 校验。admin 命令影响整个组织，需在当前轮次重新确认，执行前枚举解析后的目标，且不得对 admin user delete/deactivate 使用 --ignore-errors。
适用场景：Jira 工作项批量创建、搜索、编辑、流转、分配与评论，项目与看板/冲刺管理，组织用户管理，以及 CI/自动化中的非交互操作。
限制：本资料未提供 acli 的收费、价格、平台支持范围及具体版本信息；详细命令参数见技能内 references/jira-workitem-commands.md 与 references/other-commands.md。