用途：快速读取 Jira 工单数据，优先使用本地缓存，无需网络；缓存缺失时可从 API 获取并写入缓存。触发方式为 jira-read [JIRA-ID]，ID 不区分大小写并自动转大写。
主要能力：支持 --live（跳过缓存从 API 获取并更新缓存）、--force（强制 API 获取并覆盖缓存）、--no-download（仅本地，缺失时提示）、--full（输出含全部评论的完整内容）、--meta（仅输出 YAML front matter）、批量读取多个 ID、--list/-l 列出本地缓存条目。输出解析字段包括 jira_id、title、priority、status、reporter、assignee、created_at、updated_at、downloaded_at、source_url，正文含描述、复现步骤、预期/实际结果与评论历史。
使用方式：先设置缓存目录环境变量 export JIRA_CACHE_DIR="$HOME/.cache/jira"，默认 ~/.cache/jira/。主文件为 $JIRA_CACHE_DIR/{JIRA-ID}.md，字段映射缓存为 .field-mapping.json，首次使用自动调用 jira_search_fields 建立映射。凭证解析顺序：环境变量 JIRA_PERSONAL_TOKEN，其次 JIRA_PAT，再次文件 ~/.config/jira-certs/jira-pat.txt，最后询问用户。附件通过脚本下载到本地磁盘，不读入上下文；可用 node scripts/download_jira_attachments.mjs 或 scripts/download_jira_attachments.sh，需设置 JIRA_URL，PAT 不得出现在命令行。
适用场景：读取内部 Jira 工单、批量查看缓存、下载日志或截图附件并归档到项目目录。
限制：缓存超过 7 天会提示强烈建议更新；凭证缺失时不会实时获取；mcp-atlassian 为可选，缺失不影响使用；TLS 或客户端证书问题需检查证书配置，Windows 下 PEM mTLS 建议使用 node 脚本。具体输出格式示例与下载报告格式见 reference.md。