用途:acli 是 Atlassian 官方命令行工具,覆盖 Jira Cloud、Confluence Cloud 与组织管理操作,替代过去需要直接调用 REST 的终端自动化,并用统一的二进制入口与分产品凭据存储。
主要能力:Jira 侧支持工作项(workitem)的 create、create-bulk、edit、clone、delete、archive、transition、assign、link、comment、attachment、search、view、watcher 等;还包括 project、board、sprint、filter、dashboard、field(仅自定义字段定义);Confluence 支持 space 完整 CRUD、blog 与 page 查看;admin 支持 API key 认证与用户生命周期(activate、deactivate、delete 等)。所有列表/搜索/查看命令支持默认表格、--json、--csv 三种输出。
使用方式:命令结构为 acli <product> [<feature>] <action> [flags]。先认证,例如:echo "$ATLASSIAN_API_TOKEN" | acli jira auth login --site "<your-site>.atlassian.net" --email "you@example.com" --token,再用 acli jira auth status 验证。变更类命令多用选择器 --key、--jql、--filter 或 --from-file 指定目标;批量操作需 --yes 跳过交互确认(CI 必需),并可用 --ignore-errors。搜索务必显式加 --paginate 或 --limit,因为分页是可选且截断无提示。富文本需用 ADF JSON,先写 Markdown,再用 scripts/md-to-adf.ts 转换后传入。
适用场景:终端一次性操作、批量变更、脚本化流水线、CI 任务;批量与大规模结果集场景比 MCP 更省 token。
限制:认证按产品独立(jira、confluence、admin、global 各自会话),过期会导致批量半途失败;未知子命令会回退父级帮助并 exit 0,不代表命令存在;acli 无法列出自定义字段、编辑已有工作项的自定义字段值、管理工作流/问题类型/版本/组件、上传附件、添加关注者、把条目加入冲刺,这些需走 REST 或可选的 Atlassian MCP;workitem edit 不接受自定义字段与 components;issue link 的 --out/--in 与 Jira 语义实测相反;不要把自定义字段 id 硬编码,也不要用环境变量读取 Atlassian 主机;建议脚本场景用 API token 认证,生产流水线固定二进制版本。更多细节暂未提供。