用途：通过 jira CLI 与 MCP 工具（mcp__jira__*）操作 Jira Cloud，包括议题管理、项目查询、JQL 搜索、状态流转、工时记录、计划等。CLI 为完整接口，MCP 只覆盖常用读写操作；未在 MCP 中列出的操作应使用 CLI，命令格式为 jira <resource> <verb> [args] [flags]。
主要能力：资源包括 issues、projects、comments、attachments、worklogs、versions、components、filters、dashboards、issuetypes、statuses、issuelinks、remotelinks、development、plans、users、boards、sprints、fields、goals、screens、automations、auditlog。支持按人类可读名称解析 transition、user、fieldId 及自定义字段值，名称不唯一会报错。
使用方式：先运行 jira config init 生成 ~/.config/jira-cli/config.toml，再用 jira config validate 测试连接；不使用环境变量，可用 --url/--email/--token 一次性覆盖。输出格式有 --format table（默认）、json、jsonl，脚本处理推荐 jsonl。可与 .md 文件双向同步议题描述，支持 YAML frontmatter、附件图片、Mermaid 渲染，并带冲突检测与文件锁。
限制：MCP 默认返回最少字段；204 空响应不代表失败，需用 GET 验证；development 接口需要数字 ID；Goals 字段无法通过 REST 设置（JRACLOUD-97866）；文档链接应使用 remote links 而非附件；goal 命令基于 GraphQL，不在 MCP 中；JQL 搜索须用 POST /rest/api/3/search/jql。详细语法见 references/commands.md。