Everything Claude Code 的 Jira Integration Skill 是专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的生产级 Jira 集成工具。它支持票据检索、需求分析、状态更新、自动评论、JQL 查询等关键操作，覆盖 MCP Server（推荐）与 REST API 两种集成方式。通过标准化的操作流程和安全配置，极大提升开发团队在需求追踪、开发进度同步、自动化测试与交付反馈等环节的效率和透明度。本文将详解其实际用法、激活条件、输出示例、常见配套 Agent 及与其他 Skill 的协作模式。

Everything Claude Code Jira Integration Skill：Jira 票据检索、状态更新、评论与需求分析

Jira Integration Skill 是 Everything Claude Code 体系中专为开发者和 AI 编程助手设计的 Jira 自动化操作能力。它让 AI 代理能够直接从 Jira 检索票据、分析需求、自动更新状态、添加评论、执行 JQL 查询等，极大简化了需求追踪和开发协作流程。无论你是用 Claude Code、Codex 还是 Cursor，只需配置一次，即可让 AI 参与到实际的项目管理和交付闭环中。

本 Skill 支持两种集成方式：

MCP Server（推荐）：通过 mcp-atlassian 组件，将 Jira 操作工具暴露给 AI Agent，支持更丰富的自动化和安全隔离。
直接 REST API：无需 MCP 时，AI 也可通过标准 Jira REST API 直接操作票据，适合轻量集成或脚本化场景。

想了解 Everything Claude Code 的整体架构和 Skill 体系，建议阅读完全指南和快速上手指南。

1. 典型应用场景与触发条件

Jira Integration Skill 可在以下场景自动激活或被 AI Agent 主动调用：

需求分析：检索 Jira 票据，提取功能描述、验收标准、关键数据、依赖与集成点，为开发/测试做准备。
开发进度同步：自动添加开发进度、分支、PR 链接等评论，确保团队成员实时了解状态。
票据流转：根据开发流程自动将票据状态从「To Do」切换到「In Progress」「In Review」「Done」等。
JQL 查询与筛选：批量检索特定条件下的票据（如：当前 Sprint、某人负责、特定标签）。
需求变更/澄清：AI 可根据票据内容自动识别需求不明确处，生成澄清评论或提醒开发者补充信息。

常见触发方式：

你在 AI 编程助手中输入「帮我分析 PROJ-1234 这个 Jira 票据的验收标准和测试点」
Agent 检测到新分支/PR 创建，自动在对应 Jira 票据下评论并关联
自动化 Hook 检测到 CI 通过，触发票据状态流转

2. 配置与集成流程（Step by Step）

方案一：通过 MCP Server 集成（推荐）

安装依赖
- Python 3.10+
- uvx（通过 uv 安装，详见官方文档）

配置 MCP Server 在 ~/.claude.json 的 mcpServers 字段添加如下配置：

json

{
  "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_API_TOKEN 等机密信息写入代码库或 Skill 文件，建议通过系统环境变量或专用密钥管理器注入。

获取 Jira API Token
- 访问 https://id.atlassian.com/manage-profile/security/api-tokens
- 创建新 token 并安全保存
重启/刷新 AI 编程助手
- 确认 MCP Server 已被加载，Jira 工具可用

方案二：直接 REST API 集成

准备环境变量
- JIRA_URL：Jira 实例地址
- JIRA_EMAIL：你的 Atlassian 邮箱
- JIRA_API_TOKEN：API Token
在 shell 或本地 .env 文件中配置上述变量，确保 .env 已加入 .gitignore。

通过 curl 或脚本调用 Jira API，如：

bash

curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
  -H "Content-Type: application/json" \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234"

也可结合 jq 进行结构化输出。

3. 常用操作与输出示例

a) 检索并分析 Jira 票据

AI 操作流程：

触发 jira_get_issue（MCP）或 REST API 拉取票据详情
自动提取：
- 功能需求、验收标准、测试类型、边界条件、依赖
输出结构化分析报告

输出示例：

Ticket: PROJ-1234
Summary: 用户可通过手机号找回密码
Status: In Progress
Priority: High
Test Types: Unit, Integration, E2E

Requirements:
1. 支持手机号找回密码
2. 校验短信验证码有效性

Acceptance Criteria:
- [ ] 用户输入手机号后可收到验证码
- [ ] 输入正确验证码后可重置密码
- [ ] 验证码错误时有明确提示

Test Scenarios:
- Happy Path: 正确手机号+验证码，重置成功
- Error Case: 验证码错误，重试提示
- Edge Case: 多次错误后锁定

Test Data Needed:
- 有效手机号
- 无效手机号
- 已注册/未注册用户

Dependencies:
- 短信服务 API
- 用户中心数据库

b) 自动添加/更新评论

常见模板：

开始开发时：

Starting implementation for this ticket.
Branch: feat/PROJ-1234-password-recovery

测试完成时：

Automated tests implemented:

Unit Tests:
- passwordUtils.test.ts — 验证手机号格式与验证码生成
Integration Tests:
- resetPasswordAPI.test.ts — 校验 API 端点及异常分支

All tests passing locally. Coverage: 92%

PR 创建后：

Pull request created:
[手机号找回密码实现](https://github.com/org/repo/pull/456)

Ready for review.

c) 状态流转与 JQL 查询

流转票据状态（如从「In Progress」到「Done」）：
1. 先调用 jira_get_transitions 获取可用流转 ID
2. 再用 jira_transition_issue 指定 transition_id 完成状态变更

JQL 查询示例：

bash

curl -s -G -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
  --data-urlencode "jql=project = PROJ AND status = 'In Progress'" \
  "$JIRA_URL/rest/api/3/search"

4. 常见配套 Agent 与 Skill 协作

Doc Updater Agent：开发完成后自动在 Jira 评论中同步文档、README 更新进度，详见自动文档更新代理。
Build Error Resolver/Code Reviewer Agent：遇到构建或代码问题时，AI 可自动在 Jira 票据下添加错误分析和修复建议，参考构建错误修复代理。
Verification Loop Skill：结合 Jira 验收标准，自动驱动端到端测试与反馈闭环，详见验证循环 Skill。
Hooks 自动化：可通过Hooks 体系在 PR 合并、CI 通过等事件自动触发 Jira 状态流转或评论。

5. 安全与最佳实践

API Token 绝不入库，仅用环境变量或密钥管理
每步开发/测试/交付及时更新 Jira，而非事后补录
评论简明扼要，优先链接而非复制内容
遇到权限或网络错误，优先检查 token、URL、VPN

更多安全建议可参考AI 编程助手安全指南。

FAQ

Q: Jira Integration Skill 支持哪些 AI 编程助手？ A: 目前已支持 Claude Code、Codex、Cursor 等主流 AI 编程助手，兼容 MCP Server 或 REST API 调用模式。

Q: 如何保证 Jira API Token 的安全？ A: 强烈建议通过环境变量或专用密钥管理器注入 Token，绝不写入代码库或 Skill 配置文件；如发生泄漏应立即重置。

Q: MCP Server 与 REST API 两种方式如何选择？ A: 推荐优先使用 MCP Server，功能更全且安全隔离好；仅在无法部署 MCP 时再用 REST API 直连脚本。

Everything Claude Code Jira Integration Skill：Jira 票据检索、状态更新、评论与需求分析 ​

1. 典型应用场景与触发条件 ​

2. 配置与集成流程（Step by Step） ​

方案一：通过 MCP Server 集成（推荐） ​

方案二：直接 REST API 集成 ​

3. 常用操作与输出示例 ​

a) 检索并分析 Jira 票据 ​

b) 自动添加/更新评论 ​

c) 状态流转与 JQL 查询 ​

4. 常见配套 Agent 与 Skill 协作 ​

5. 安全与最佳实践 ​

FAQ ​