用途:在命令行中通过 acli 操作 Atlassian Jira,适合需要批量或脚本化处理 Jira 工作项的场景。
主要能力:涵盖 jira auth(登录、登出、状态、切换)、jira board(列冲刺、搜索)、jira dashboard(搜索)、jira field(创建、删除等)、jira filter(收藏、改所有者、列表、搜索)、jira project(归档、创建、删除、列表、恢复、更新、查看)、jira sprint(列工作项)、jira workitem(归档、分配、附件、克隆、评论、创建、批量创建、删除、编辑、链接、搜索、状态流转、取消归档、查看、关注者)。
使用方式:先确认 acli 已安装,执行 which acli;未安装时提示用户按 https://developer.atlassian.com/cloud/acli/guides/install-acli/ 安装。遇到认证错误可运行 acli jira auth status 检查会话,认证配置见 references/JIRA_AUTH.md。需要在评论或描述中渲染标题、表格、列表或代码块时,须使用 Atlassian Document Format(ADF),可参考 references/JIRA_ADF_FORMATTING.md 中的模式与 Ruby 构建器。
限制:所有 Jira 操作只能使用 acli,不得使用 curl、REST API、Python 脚本等替代方法,即使 acli 命令失败或某参数看似不支持也不行;若 acli 无法完成,应明确告知用户,而不是自行寻找变通方案。