用途:用 Atlassian CLI(acli)根据用户指令创建 JIRA 工单,尽量复用当前分支所属项目,并在创建前让用户确认。
主要能力与流程:
- 校验 acli:运行 acli auth status;未安装提示 brew tap atlassian/acli && brew install acli;未认证提示 acli auth login,两者均停止。
- 确定项目:运行 git branch --show-current,从分支名匹配 [A-Z][A-Z0-9]+-[0-9]+(不区分大小写)取前缀作项目键;否则运行 acli jira project list --json 让用户选择。
- 解析指令:从参数推断摘要、类型(fix/broken→Bug,add/implement→Story/Task)、描述、优先级、标签、Figma URL 等。
- 列出史诗:acli jira workitem search --jql "project = <PROJECT-KEY> AND issuetype = Epic" --json --limit 50,收集 key、summary、状态。
- 推荐史诗并给出理由;用户指定则以指定项为准。
- 强制预览:展示项目、类型、摘要、推荐史诗与理由、描述要点、Figma URL,并让用户选择创建、换史诗、不带父级、编辑或取消。
- 创建:生成 ADF 描述 JSON 后运行 acli jira workitem create --from-json <temp-file.json> --json;可含 parent(史诗)。若被拒,查看 --generate-json 后重试一次,仍失败则提示在 Jira UI 设置。
- Figma:通过 issue entity properties 附加,使用 acli auth token 与 REST 调用;失败则回退到描述中并告知。
限制:JIRA 不渲染 Markdown,描述须为 ADF 对象;创建前必须确认;必填自定义字段缺失时会失败需补充。安装命令与 URL 依资料保留。