Jira集成引擎(免费版)

Jira问题跟踪与项目管理集成引擎（免费版），通过REST API操作Jira实例. 覆盖问题管理、Sprint规划、看板操作与工作流自动化。核心能力： - 问题管理（创建/更新/查询/批量操作） - Sprint与看板管理（Sprint规划/看板配置） - 工作流与状态流转（转码/分配/评论） - JQL高级查询与筛选器管理

Jira问题跟踪与项目管理集成引擎，通过REST API操作Jira实例，覆盖问题管理、Sprint规划与工作流自动化.

输入格式

参数名	类型	必填	说明
input	string	是	Jira集成引擎(免费版)处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

如需调用外部API，请参考环境配置章节设置对应密钥

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

1. 问题管理

通过Jira REST API v3管理问题：

bash

# 创建问题
curl -X POST "https://your-domain.atlassian.net/rest/api/3/issue" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "project": {"key": "PROJ"},
      "summary": "实现用户登录功能",
      "description": {"type": "doc","version": 1,"content": [{"type": "paragraph","content": [{"type": "text","text": "需要实现OAuth登录"}]}]},
      "issuetype": {"name": "Story"},
      "priority": {"name": "High"},
      "assignee": {"accountId": "user-account-id"}
    }
  }'
# ...
# 查询问题
curl -X GET "https://your-domain.atlassian.net/rest/api/3/issue/PROJ-123" \
  -u "[e-mail]:API_TOKEN"
# ...
# 更新问题
curl -X PUT "https://your-domain.atlassian.net/rest/api/3/issue/PROJ-123" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"summary": "更新后的标题"}}'

2. JQL高级查询

bash

# JQL查询
atlassian.net/rest/api/3/search" \
  -u "[e-mail]:API_TOKEN" \
  --data-urlencode 'jql=project = PROJ AND sprint in openSprints() AND status != Done ORDER BY priority DESC' \
  -G

常用JQL模式：

• 当前Sprint未完成：sprint in openSprints() AND status != Done
• 某人待办：assignee = "[e-mail]" AND statusCategory != Done
• 高优先级缺陷：issuetype = Bug AND priority in (Highest, High) AND status = Open
• 过期问题：duedate < now() AND statusCategory != Done

3. Sprint与看板管理

bash

# 获取活跃Sprint
atlassian.net/rest/agile/1.0/board/1/sprint?state=active" \
  -u "[e-mail]:API_TOKEN"
# ...
# 将问题移入Sprint
atlassian.net/rest/agile/1.0/sprint/1/issue" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"issues": ["PROJ-1", "PROJ-2"]}'
# ...
# 创建Sprint
atlassian.net/rest/agile/1.0/sprint" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sprint 15", "startDate": "2026-08-01", "endDate": "2026-08-14", "originBoardId": 1}'

• 异常时参考错误处理章节进行恢复
• 关键参数: sprint与看板管理 选项

4. 工作流与状态流转

bash

# 获取可用状态流转
atlassian.net/rest/api/3/issue/PROJ-123/transitions" \
  -u "[e-mail]:API_TOKEN"
# ...
# 执行状态流转
atlassian.net/rest/api/3/issue/PROJ-123/transitions" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"transition": {"id": "21"}}'
# ...
# 添加评论
atlassian.net/rest/api/3/issue/PROJ-123/comment" \
  -u "[e-mail]:API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body": {"type": "doc","version": 1,"content": [{"type": "paragraph","content": [{"type": "text","text": "已修复，请验证"}]}]}}'

• 异常时参考错误处理章节进行恢复
• 关键参数: 工作流与状态流转 选项

快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

适用场景

场景	输入	输出
批量创建问题	需求列表+项目Key	批量创建API调用+结果汇总
Sprint报告	Sprint ID	Sprint进度+问题状态分布
缺陷追踪	项目Key+时间范围	缺陷列表+优先级分布+趋势
工作流自动化	触发条件+动作	状态流转+评论+分配脚本

不适用于：Jira插件开发、Jira管理员配置、Jira Server/Data Center安装部署.

使用流程

1. 配置认证（邮箱+API Token）
2. 确定Jira实例URL和项目Key
3. 选择操作类型（创建/查询/更新/流转）
4. 构造并发送REST API请求
5. 解析响应并格式化输出

示例

示例1：查询当前Sprint问题

bash

curl -s -X GET "https://your-domain.atlassian.net/rest/api/3/search" \
  -u "[e-mail]:API_TOKEN" \
  --data-urlencode 'jql=project = PROJ AND sprint in openSprints() ORDER BY priority DESC' \
  -G | jq '.issues[] | {key: .key, summary: .fields.summary, status: .fields.status.name, assignee: .fields.assignee.displayName}'

输出：当前Sprint所有问题的Key、标题、状态和负责人列表.

错误处理

错误场景	原因	处理方式
401 Unauthorized	API Token无效或邮箱错误	在Atlassian账户设置中重新生成API Token，确认邮箱与账户一致，使用 -u "email:token" 格式
404 Not Found	问题Key或API路径错误	确认问题Key存在（如PROJ-123），检查API版本路径（/rest/api/3/ vs /rest/api/2/）
400 Bad Request "field is required"	创建问题时缺少必填字段	先GET一个同类型问题查看必填字段，确保project/summary/issuetype字段完整
403 Forbidden	API Token权限不足	确认Token关联的账户在目标项目中有对应权限（Browse Projects/Create Issues），联系Jira管理员调整权限

常见问题

Q1: 如何获取Jira API Token？

登录Atlassian账户（https://id.atlassian.com/manage-profile/security/api-tokens），点击"Create API token"，输入标签名后复制Token。使用时配合注册邮箱：-u "[e-mail]:YOUR_API_TOKEN"。注意Token只显示一次，需妥善保存。Server/Data Center版本使用用户名+密码或Personal Access Token（PAT）.

Q2: Jira Cloud和Server/Data Center的API有什么区别？

Cloud使用https://your-domain.atlassian.net/rest/api/3/，认证用邮箱+API Token。Server/DC使用https://your-jira-server/rest/api/2/，认证用用户名+密码或PAT。API v3支持Atlassian Document Format（ADF）富文本，v2使用纯文本。如果不需要富文本，v2的API在Cloud上仍可用，但建议迁移到v3。部分敏捷API路径Cloud为/rest/agile/1.0/，Server一致.

Q3: JQL查询结果如何分页？

默认返回50条，最多100条。使用startAt和maxResults参数分页：?jql=...&startAt=0&maxResults=100。遍历所有结果时，循环请求直到total <= startAt + maxResults。大批量查询建议使用fields参数限制返回字段减少响应体积：&fields=key,summary,status,assignee。导出全量数据可考虑Jira的CSV导出功能或/rest/api/3/search的expand参数.

已知限制

• 需要Jira实例的网络访问权限
• API Token权限受账户角色限制
• API速率限制：Cloud每分钟每用户约40请求

升级提示

本免费版提供基础功能。升级到完整版 jira 获取全部能力和高级特性.

输出格式

json

{
  "success": true,
  "data": {
    "result": "Jira集成引擎(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "jira"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}