用途:通过 Atlassian REST API 管理 Jira 的工作项(issue)、项目(project)与看板。适合在自动化流程或智能体脚本中查询和处理 Jira 数据。
主要能力:按 JQL 搜索问题、获取问题详情、创建问题、流转问题状态、添加评论、列出项目。
配置:需设置环境变量 JIRA_BASE_URL(实例地址,如 https://yourorg.atlassian.net)、JIRA_EMAIL(Atlassian 账号邮箱)、JIRA_API_TOKEN(在 https://id.atlassian.com/manage-profile/security/api-tokens 生成)。所有请求使用 Basic 认证,例如 JIRA_AUTH=$(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)。
典型用法:用 curl 配合 Authorization: Basic 头调用 /rest/api/3 下的接口。搜索用 /rest/api/3/search?jql=...;取详情用 /rest/api/3/issue/DEV-123;创建用 POST /rest/api/3/issue;流转前先 GET /rest/api/3/issue/DEV-123/transitions 获取可用流转,再 POST transitions;评论用 POST /rest/api/3/issue/DEV-123/comment;项目用 GET /rest/api/3/project。
限制与注意事项:Jira Cloud 使用 API v3,描述与评论采用 ADF(Atlassian Document Format);Jira Server/Data Center 可能使用 API v2 与纯文本或 wiki 标记。存在速率限制,可查看响应头 X-RateLimit-Remaining。创建、流转或删除问题前应始终先确认。