用 AI 给 IDE 装上 Jira：从零到批量导出工单的完整实战

用 AI 给 IDE 装上 Jira：从零到批量导出工单的完整实战

一、背景与动机

项目进入中后期，Jira 上积累了 450+ 个工单。日常需要做的事很简单：

• 查看自己名下的待办工单
• 按经办人筛选工单，给团队成员分配任务
• 批量导出工单列表做周报/月报

但 Jira 网页端的筛选和导出功能操作繁琐，尤其在内网 Server/DC 版本上，导出中文还容易乱码。能不能直接在 IDE 里用命令行搞定？ 于是我在 AI 编码助手的帮助下，完成了一次从找工具、装工具、踩坑到批量导出的完整实践。

二、工具与方法

核心工具

方法路线

搜索开源方案 → git clone 安装 → 配置 Jira 连接 → 验证连通 → 编写批量脚本 → 输出结果

整个过程由 AI 助手主导执行，我只需要提供 Jira 地址和 Token。

三、实操过程

Step 1：让 AI 帮我找工具

我对 AI 说：

“帮我找一个 skill 可以从 Jira 上获取数据。”

AI 搜索后推荐了 netresearch/jira-skill——一个兼容 Claude Code、Cursor、Qoder 等多种 AI IDE 的开源插件。它的特点是：

• 零 MCP 开销，纯 Python CLI 脚本，通过 uv run 执行
• 全 API 覆盖：搜索、创建、更新、流转、评论、工时、附件、Sprint 全支持
• 同时兼容 Jira Server/DC 和 Cloud

Step 2：安装

git clone https://github.com/netresearch/jira-skill.git <YOUR_WORKSPACE>\jira-skill

然后安装依赖 uv（如果没装的话）：

pip install uv

Step 3：配置连接（踩坑重灾区）

创建 ~/.env.jira（用户主目录下），填入 Jira Server 地址和 PAT：

JIRA_URL=http://<YOUR_JIRA_IP>:<PORT>
JIRA_PERSONAL_TOKEN=<YOUR_TOKEN>

PAT 获取路径：Jira 右上角头像 → 个人配置 → Personal Access Tokens → Create token

🚨 踩坑：PowerShell 的 UTF-8 BOM 陷阱

第一次用 PowerShell 写文件：

# ❌ 错误写法
Set-Content -Path ~/.env.jira -Value