Codex如何与Jira联动？项目管理自动化配置【教程】

设想这样一个场景：你正在调试一个紧急Bug，却还要手动打开Jira去更新任务状态、填写备注、甚至新建子任务——这种切来切去的操作，不仅打断思路，还浪费时间。如果能直接在代码编辑器里，用一句话让Codex替你处理好这一切，该多省心？

这正是Codex与Jira联动的价值所在。下面这套配置完成后，你可以在聊天框里用自然语言直接操作Jira：读取任务、更新状态、创建子任务，都不用离开编辑器。

前置准备：获取Jira API权限

第一步，先拿到Jira的“钥匙”。登录你的Jira账户，进入个人设置，点击“API令牌”，选择“创建API令牌”。输入一个名称，比如 codex-prod，然后点击生成。

：令牌生成后，页面关闭就无法再查看了，所以务必。这一步绕不过去，Jira不接受密码直连，只认API令牌，否则后续所有联动都会因为认证失败而中断。

配置GitHub Secrets环境变量

拿到令牌后，把它和Jira的地址、邮箱等信息一起，安全地存到GitHub仓库的Secrets里。操作路径：打开你的GitHub仓库 → Settings → Secrets and variables → Actions → New repository secret。

依次添加下面4项：

1. JIRA_BASE_URL
   ：你的Jira实例地址，比如 https://your-company.atlassian.net

2. JIRA_API_TOKEN
   ：上一步复制下来的API令牌

3. JIRA_USER_EMAIL
   ：你登录Jira所用的邮箱（必须是项目成员）

4. JIRA_PROJECT_KEY
   ：目标项目的Key，例如 PROJ 或 TEAM。这个Key可以在Jira项目概览页的URL末尾或项目设置中找到

安装Jira技能模块

环境变量配好后，下一步是让Codex学会使用Jira。有两种安装方式。

打开终端，执行这条命令：

python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path jira

用 git clone https://github.com/ComposioHQ/awesome-codex-skills.git 克隆仓库，然后进入 awesome-codex-skills/skills/jira 目录，把整个 jira 文件夹复制到 ~/.codex/skills/ 目录下。完成后重启Codex桌面客户端。

：路径必须准确，Codex只读取 $CODEX_HOME/skills/ 下的直接子文件夹，不会扫描子目录，放错了位置会导致模块不生效。

触发Jira联动的三种典型操作

配置和安装都完成后，就可以在Codex聊天框里用自然语言驱动Jira了。以下是几个高频场景：

在Codex聊天框中输入：“列出我名下所有状态为‘To Do’或‘In Progress’的Jira任务，按优先级排序。” 它会自动读取Jira的数据并展示给你。

当你在GitHub上创建PR时，如果标题中包含类似 PROJ-123 这样的Jira Issue编号，Codex会自动识别它。在PR打开、更新或合并时，它会同步更新对应Jira任务的状态字段，并在评论区留下操作记录。

比如你发现了一个SSO跳转异常的Bug，可以直接输入：“在PROJ项目下新建一个高优先级任务，标题是‘修复用户登录页SSO跳转异常’，描述写清楚复现路径：1. 访问/login 2. 点击Google图标 3. 跳转至404页面，附件附上截图。” Codex会调用Jira REST API完成创建，整个流程不需要你打开浏览器。

这套配置完成后，你可以把日常的任务管理工作交给Codex，把精力更多地放在代码本身。