用途：在终端通过 Jira Cloud REST API v3 完成日常 Jira 操作，包括搜索、查看、创建、评论、计数、列项目与状态流转，并附带 JQL 语言参考。
主要能力：me/projects 验证身份与范围；list 支持 --project、--jql、--max（超过 50 自动分页）；view 查看摘要、状态、经办人与描述（ADF 自动转纯文本）；count 用近似计数端点快速返回匹配总数；create 新建问题（默认 Task，可指定 --type、--priority）；comment 添加评论；transitions 先列出有效流转 ID，再用 transition 按名称或 ID 变更状态，Done 类界面常需 --resolution。
使用方式：在 id.atlassian.com/manage/api-tokens 生成 API Token，设置环境变量 JIRA_EMAIL、JIRA_API_TOKEN、JIRA_SERVER，认证为 HTTP Basic（邮箱+Token，非密码）。写操作需显式 --yes/--force，--dry-run 与 --help 无需凭据。--json 输出可管道给 jq。脚本 scripts/jira 为 CLI 本体，scripts/test_jira.py 为离线测试。
适用场景：终端内任意 Jira Cloud 交互、编写与调试 JQL、冲刺评审、批量状态清理、仪表盘与保存过滤器设计。
限制：仅面向 Jira Cloud REST v3，Data Center 认证方式不同；所用经典搜索端点已被上游弃用，未来需迁移到 /search/jql 令牌分页；富文本创建需手写 ADF JSON；429 不自动重试；不适用于 GitHub/GitLab 问题跟踪、Jira 站点管理、Confluence 或服务端集成开发。JQL 注意：!= 会排除空值、AND 优先级高于 OR、无前导通配符、无聚合函数、相对日期大小写敏感。