Agent Skills
返回列表
Jira PAT 工单管理

Jira PAT 工单管理

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/jira-pat-skill。

技能介绍

问题背景

不少团队跑的是自托管 Jira 或带 SSO/SAML 的企业版。在这种环境里,常见的 jira-cli 或 Basic Auth(邮箱 + API Token) 往往直接 401;Agent 里挂的通用 Jira 技能也常假定 Atlassian Cloud。你仍然需要查工单、跑 JQL、流转状态、补评论——但认证方式得换成 Personal Access Token(PAT),并以 Authorization: Bearer 调用 REST API。

技能如何工作

本技能把操作写成可由 Agent 执行的 Markdown 指令,底层用 curl + jq 访问 Jira REST,不依赖专用 SDK。

  • 前置配置:在 Jira 个人资料里创建 PAT,写入环境变量 JIRA_PAT;实例地址写入 JIRA_URL。
  • 读工单:按 issue key 拉全量或指定字段详情。
  • 搜工单:用 JQL(如 parent=EPIC-123、assignee=currentUser()、updated >= -7d)做检索并解析结果。
  • 改状态:先查可用 transitions,再带合法 transition ID 执行流转;可顺带关闭并附评论。
  • 写数据:添加评论、更新字段、创建新 issue;文档里还提供常用 jq 过滤写法。
  • 排错:对照 401/404/400 等典型错误(令牌、权限、非法 transition)做排查。

适用边界

  • 适用:自托管 / 企业 Jira,且 PAT + Bearer 可用。
  • 不适用:Atlassian Cloud 且习惯用邮箱 + API Token 的场景——应改用实现 Basic Auth 的 jira-skill。
  • Agent 需具备 exec 能力以执行 curl/jq;PAT 只走环境变量,勿写进对话或仓库。

使用场景

  • Red Hat 等内网 Jira 上,用 JQL 查出某 Epic 下未关闭子工单并汇总字段
  • SSO 企业 Jira 里,流转工单前让 Agent 先拉可用 transitions 再执行关闭
  • 值班时根据 issue key 拉详情并追加评论,无需打开浏览器登录 SAML
  • 新建缺陷单时按项目与字段模板创建 issue,并校验 REST 返回

适合人员

  • 维护企业 Jira 集成的平台工程师,需要在 SSO 下用 PAT 代替 Basic Auth 做 API 调试
  • Scrum Master 负责 Red Hat/自建实例,要经常用 JQL 查指派给自己的未结工单
  • SRE 在 incident 中需要快速查工单状态、关单并留评论,且 CLI 因 SAML 不可用
  • 安全团队用 `labels=security` 等 JQL 定期筛工单,希望在 Agent 对话里完成查询