Jira 集成技能

直接从 AI 编码工作流中检索、分析和更新 Jira 工单。支持 基于 MCP（推荐）和 直接 REST API 两种方式。

何时激活

• 获取 Jira 工单以理解需求
• 从工单中提取可测试的验收标准
• 向 Jira 问题添加进度评论
• 转换工单状态（待办 → 进行中 → 完成）
• 将合并请求或分支链接到 Jira 问题
• 通过 JQL 查询搜索问题

前提条件

选项 A：MCP 服务器（推荐）

安装 mcp-atlassian MCP 服务器。这将向您的 AI 代理直接暴露 Jira 工具。

要求：

• Python 3.10+
• uvx（来自 uv），通过您的包管理器或官方 uv 安装文档进行安装

添加到您的 MCP 配置（例如，~/.claude.json → mcpServers）：

{
  "jira": {
    "command": "uvx",
    "args": ["mcp-atlassian==0.21.0"],
    "env": {
      "JIRA_URL": "https://YOUR_ORG.atlassian.net",
      "JIRA_EMAIL": "your.email@example.com",
      "JIRA_API_TOKEN": "your-api-token"
    },
    "description": "Jira issue tracking — search, create, update, comment, transition"
  }
}

安全： 切勿在源代码中硬编码密钥。建议在系统环境（或密钥管理器）中设置 JIRA_URL、JIRA_EMAIL 和 JIRA_API_TOKEN。仅对本地未提交的配置文件使用 MCP env 块。

获取 Jira API 令牌：

1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 创建 API 令牌
3. 复制令牌 — 将其存储在您的环境中，切勿存储在源代码中

选项 B：直接 REST API

如果 MCP 不可用，可通过 curl 或辅助脚本直接使用 Jira REST API v3。

所需的环境变量：

变量	描述
JIRA_URL	您的 Jira 实例 URL（例如，`https://yourorg.atlassian.ne…