核心功能与用法
jira-cli 是由 Ankit Pokhrel 开发的 Jira 官方命令行工具，封装了 Jira REST API，允许开发者直接在终端完成日常项目管理操作。核心用法围绕 issue、sprint、board、epic、project 五大资源展开：
- 工单管理：完整生命周期支持，包括创建（
issue create）、编辑（issue edit）、指派（issue assign）、状态流转（issue move）、评论（issue comment add）及 JQL 高级搜索（issue list -q） - 敏捷开发支持：冲刺列表（
sprint list）、看板浏览（board list）、史诗管理（epic list/view） - 输出控制：
--plain纯文本输出便于脚本解析，--columns自定义字段，--no-truncate完整内容展示
配置流程
需一次性完成：生成 Atlassian API Token → 环境变量导出（JIRA_API_TOKEN）→ 执行 jira init 绑定 Cloud 实例。
显著优势
1. 效率提升：无需切换浏览器，终端内完成批量工单操作，配合脚本实现自动化
2. JQL 原生支持：复杂查询如 assignee = currentUser() AND status != Done 直接可用
3. 输出友好：TOML/YAML 配置持久化，纯文本输出便于与 awk、jq 等工具链集成
4. 开源可信：GitHub 公开维护，社区活跃，非第三方闭源方案
局限性与潜在缺点
- 学习成本：需熟悉 Jira 数据模型（project key、issue type、transition name）
- Token 管理：API Token 明文存储于环境变量或配置文件，存在泄露风险
- Cloud 优先：主要面向 Atlassian Cloud，Server/Data Center 版本支持有限
- 批量操作风险：
issue edit等命令无内置确认机制，需人工二次确认（文档已建议）
适合人群
- 高频使用 Jira 的 开发工程师、Tech Lead、Scrum Master
- 需要批量处理工单的 DevOps、SRE、项目管理自动化脚本编写者
- 偏好终端工作流的 效率型用户
常规风险提醒
- 凭证安全：API Token 具备完整 Jira 操作权限，勿提交至 Git 仓库，建议配合 1Password/Bitwarden 等密码管理器注入
- 误操作不可逆：状态流转和字段编辑即时生效，建议在关键操作前执行
--dry-run或先本地验证 JQL - 速率限制：频繁调用可能触发 Atlassian API 限流，批量操作建议添加延迟
---
总体评价：Jira 生态中功能最完整的 CLI 方案，适合终端原生用户，但需建立规范的 Token 管理和操作确认机制。