SuperAPI AI 工具集

jira

通用与其它

查看项目

更新于 10-15 20:12

技能介绍

用途:通过 Atlassian CLI(acli)管理 Jira 工作项,支持查看、搜索、筛选、创建和更新。触发场景包括用户提到 Jira、JQL,或出现 ABC-123 形式的工作项键。

前置依赖:使用前需确认 acli 与 mdadf 均可用,分别运行 acli --version 和 mdadf --version 检查;缺失时按 references/prerequisites.md 安装,若无法安装则告知用户所需命令并停止。

主要能力与用法:支持 Bug、Task、Story、Epic 类型。用户给出工作项键时直接使用,不必写 JQL;搜索或筛选多个工作项时使用 --jql。富文本先在 Markdown 中起草,再用 mdadf --compact 转为 ADF,例如:acli jira workitem create --summary "Fix the login page" --project "MYPROJECT" --type "Bug" --description-file <(mdadf --compact <<'MD' ... MD)。

项目解析:每次请求都重新解析项目键,不缓存。优先取工作项键前缀或用户明确指定的项目键;否则从当前目录向上查找 .jira-skill.json,再回退到 ~/.config/jira-skill/config.json;均无则停止并询问项目与保存位置,不得猜测。配置格式为 {"defaultProject": "YOUR_PROJECT_KEY"}。

限制与安全规则:项目本身只读,仅可增删改项目内工作项;变更操作须用户明确要求,含糊时先澄清。转换状态前必须先查看当前状态;批量修改须用户批准;替换描述前须展示原文;不得假设状态名称通用;新建工单不得设置 Priority、Technical Impact 或 Business Urgency。创建、编辑、转换、评论、指派后须附上 Jira 直链,搜索结果用表格呈现。