Jira Metric 是一个专为 Atlassian Jira Cloud 设计的命令行工具集，通过调用 Jira Cloud REST API，为开发者和运维人员提供了一套高效管理 Jira 问题和工时记录的命令行解决方案。该工具无需图形界面即可实现对 Jira 项目的全面操作，适用于需要快速集成到自动化流程或脚本环境中的场景。其核心功能覆盖从问题搜索、状态流转、工时记录到工作量统计等多个方面，显著提升了在终端环境下处理 Jira 事务的效率。所有命令均封装在统一的脚本入口中，便于批量执行与自动化部署。 该工具依赖于常见的命令行工具如 `curl`、`jq`、`bc` 和 `python3`，并通过环境变量配置认证信息，包括 Jira 域名、用户邮箱及 API Token。这种设计既保证了安全性（避免硬编码凭证），又具备良好的可移植性。支持按项目范围限定操作权限，也可全局访问全部项目数据。对于大型团队而言，它还特别优化了工时查询的性能，尽管在处理海量数据时可能略有延迟。 除了基础的问题管理功能外，Jira Metric 更侧重于对工时数据的深度分析与导出。它允许用户按日期范围、指定用户或特定问题维度检索工作日志，并以结构化 JSON 格式输出结果，方便后续导入 BI 系统、生成报表或进行数据分析。这使得项目经理和技术主管能够快速掌握团队投入情况，优化资源分配，而无需频繁切换至 Web 界面手动筛选。
核心功能特点
- 通过命令行直接搜索、创建、更新和链接 Jira 问题
- 支持按用户、日期或问题键精确检索工时记录并导出为 JSON
- 自动验证状态流转合法性，确保符合 Jira 工作流规则
- 批量获取团队成员每日或每周的工作量分布情况
- 灵活的环境变量配置方式，保障 API 密钥安全且不依赖配置文件
适用场景
Jira Metric 特别适合那些习惯使用终端环境进行日常工作的开发者、DevOps 工程师以及敏捷教练。例如，在一个持续集成/持续交付（CI/CD）流水线中，当构建失败时，可以通过 `jira.sh search “build failure”` 快速定位相关任务；随后用 `status` 命令将其推进到修复阶段，并通过 `log` 添加预估耗时，实现故障响应的闭环管理。这种方式避免了打开浏览器、登录页面、导航至目标项目的繁琐步骤，极大缩短了问题处理周期。 对于远程协作团队而言，该工具提供了强大的异步沟通支持。成员可以在本地记录实际花费的时间（如 `jira.sh log ABC-123 2.5`），而项目经理则可通过 `hours-day` 或 `hours-issue` 命令汇总某天的整体进度，了解谁在哪些任务上投入了精力。由于输出为机器可读的 JSON 格式，这些数据可直接被其他工具消费，用于生成周报、燃尽图或成本核算报告，从而提升整个团队的透明度和可追溯性。 此外，在跨部门协调或客户支持场景中，Jira Metric 也表现出色。技术支持人员可以迅速将客户反馈转化为工单（`create` 命令），指派给合适的专家（`assign` 命令），并在解决后添加详细注释。整个过程完全在命令行完成，尤其适合需要通过 SSH 连接服务器执行任务的场景，或者希望将 Jira 操作嵌入自定义监控告警系统的企业用户。