Jira PAT 工单管理
将以下提示词粘贴到你的 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 对话里完成查询