Jira 高级查询代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md ,安装 @user_3c6cb52e/jira-advanced-query-agent 到你的 AI 助手。
技能介绍
痛点
Jira 的 JQL(Jira Query Language)功能强大,但实际使用中存在两个常见问题:一是复杂查询的编写门槛高,尤其是在跨项目、跨状态、跨指派人维度组合过滤时,手写 JQL 容易遗漏条件或出现语法错误;二是查询结果往往需要二次加工才能转化为可执行的排期或复盘材料,工程师不得不在 Jira UI 和本地脚本之间反复切换。
能力与工作方式
Jira 高级查询代理 定位于将 Jira 查询流程封装为可由 Agent 调用的技能。其核心职责包括:
- 接收自然语言或半结构化的需求描述,将其拆解为 JQL 查询条件;
- 调用上游
jiraPython 库(PyPI 上的jira项目)执行查询; - 返回结构化的结果集,便于后续由 Agent 做摘要、分类或导出。
典型调用路径为:Agent 解析意图 → 构造查询参数 → 通过 jira 库与 Jira 实例通信 → 汇总返回数据。
边界与注意
当前版本的 SKILL.md 未提供经过验证的安装与使用说明,官方建议在接入敏感业务流程前,先审阅上游项目。需要注意:
- 依赖 PyPI 上的
jira包,其版本、API 兼容性与认证方式需自行确认; - 查询范围受 Jira 实例权限约束,Agent 无法绕过实例的访问控制;
- 本技能聚焦查询代理,不包含看板渲染、CI/CD 联动或工单自动流转等扩展能力。
使用场景
- 跨项目筛选未关闭的高优先级 bug 并整理成清单
- 把『谁在处理 P0 工单』的需求转成 JQL 查询并返回结果
- 从多个 Jira 项目聚合符合条件的工单用于周报汇总
- 根据自然语言需求生成 JQL 并执行查询返回结构化数据
适合人员
- 需要跨项目汇总 Jira 工单的研发主管:想快速获取未关闭 bug 清单
- 负责 Jira 数据整理的运营人员:需要把复杂查询需求转成结构化结果
- 编写 Jira 自动化脚本的开发者:希望用自然语言生成 JQL 并调用 jira 库执行
- 做项目周报的技术 lead:需要从多个项目聚合符合条件的工单数据