用途:把 Jira 问题按条件批量导出,并做状态分布、工作量、停留时长等分析,也可为 Excel、Tableau、Power BI 等外部工具准备数据。
主要能力:支持按项目、状态、优先级、经办人、类型、创建时间等过滤,也可用自定义 JQL 查询;可导出 CSV(表格)、JSON(完整结构)、JSONL(适合万级大数据流式处理)、Table(仅控制台查看)。通过 --expand changelog 获取状态变更历史,--expand transitions 获取可用流转,两者会显著增大文件体积。用 --all 自动分页抓取全部结果,--limit 限制条数。导出后可用 jq、Python 过滤、转换、聚合。
用法示例: uv run jira-tool export --format csv -o tickets.csv uv run jira-tool search "project = PROJ AND created >= -30d" --expand changelog --format jsonl -o recent.jsonl uv run jira-tool analyze state-durations issues_with_history.json -o durations.csv --business-hours
环境要求:Jira Cloud REST API v3、Python 3.10+,需设置 JIRA_BASE_URL、JIRA_USERNAME、JIRA_API_TOKEN;jq、pandas 为可选项。
限制:Jira API 默认每次请求约 100 条,需分页处理;展开字段会使单条体积增至约 20–50KB,建议先用过滤缩小范围;状态分析必须带 changelog。具体配额、收费与速率上限资料未提供。