SuperAPI AI 工具集

jira-search-jql

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:通过 JQL(JIRA 查询语言)执行查询与发现操作,按状态、经办人、优先级等条件查找问题,适合报表、自动化与监控;不适合单问题操作、批量工作流流转、复杂问题关系及冲刺/看板管理,这些分别由 jira-issue、jira-lifecycle、jira-relationships、jira-agile 等技能处理。

主要能力:执行 JQL 查询(支持排序、分页、字段选择);构建与校验 JQL;创建、更新、删除、共享、收藏筛选器;导出 CSV/JSON(JSON 保留嵌套字段对象);从搜索结果批量更新标签、优先级、经办人;列出可用字段、函数并给出字段值建议。

使用方式:始终使用 jira-as CLI,不直接运行 Python 脚本。需配置环境变量 JIRA_SITE_URL、JIRA_EMAIL、JIRA_API_TOKEN。示例:jira-as search query "assignee = currentUser() AND status != Done";导出 jira-as search export "project = PROJ" -o report.csv;创建筛选器 jira-as search filter create -n "My Bugs" -j "type = Bug AND assignee = currentUser()" -f;批量更新建议先加 --dry-run,例如 jira-as search bulk-update "JQL" --add-labels bug --dry-run。常用选项:--fields、--max-results(查询默认 50、导出默认 1000,超过 100 自动分页)、--output、--format。

限制:查询、校验、导出为只读;创建/更新/共享筛选器可逆但需谨慎;删除筛选器与批量更新属高风险操作,批量更新务必先用 --dry-run。空结果不算错误,导出零匹配仍成功(CSV 仅表头,JSON 为 {"issues": [], "total": 0})。大数据集建议优选 search export 并按日期拆分。退出码:0 成功、1 一般错误、2 用法或认证错误、130 用户中断。具体安装、收费与平台信息暂未提供。