Agent Skills
返回列表
🏢

Jira

企业运营 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/softaworks-agent-toolkit-jira。

技能介绍

要解决的问题

在 IDE 或对话里处理 Jira,往往要先切到浏览器、记 JQL,或背一整套 jira 子命令。工单状态、经办人、可用流转名因项目而异,没先拉取现场数据就改票,轻则静默失败,重则误通知大量关注人。本技能把「说清楚意图 → 选对后端 → 先读后写」收成一套可重复的流程。

技能如何工作

后端探测是第一步:本机有 jira 命令走 CLI(见 references/commands.md);环境里有 Atlassian MCP 工具走 MCP(见 references/mcp.md);两者都没有则引导安装 CLI,而不是硬猜接口。

常见意图有对照表:CLI 下如 jira issue view ISSUE-KEY、jira issue list -a$(jira me)、建票、流转、指派、jira sprint list --state active;MCP 下对应 mcp__atlassian__searchJiraIssuesUsingJql、getJiraIssue、createJiraIssue、transitionJiraIssue 等。对话里出现 PROJ-123 这类 [A-Z]+-[0-9]+ 工单号时,应自动用 jira issue view 或 MCP getJiraIssue 打开详情。

建票:结合用户提到的代码/关联工单/PR 补上下文 → 起草摘要与描述 → 与用户确认 → 用当前后端创建。改票:先 view/拉详情 → 核对是否在办 → 对比「当前 vs 拟改」→ 获批后再改,并用评论说明变更。执行前应自问:当前状态是否已核实、关注人/关联史诗会否被波及、流转是否可逆、MCP 指派是否已有 account ID(不能靠显示名)。

适用边界与注意点

  • 流转:必须先取当前状态与可用 transitions;「To Do → Done」可能因缺少中间态而失败。
  • MCP 指派:先 lookupJiraAccountId,否则指派会静默失败。
  • 改描述:Jira 无撤销,须展示原文再改;CLI 非交互创建要填满必填字段,避免 --no-input 神秘报错。
  • 批量操作:每张票变更都会通知关注人,须逐项明确批准。
  • 复杂字段、长描述、JQL、关联工单等应加载 references;单纯查看、列「我的工单」、浏览器打开可用速查表即可。

操作前展示将要执行的命令/工具调用,修改前征求同意,改后验证结果;鉴权问题要明确抛出,便于用户自行处理。

使用场景

  • 站会前用自然语言执行 `jira sprint list --state active`,核对当前迭代里尚未关闭的工单
  • 对话里出现 PROJ-123 时自动 `jira issue view` 或 MCP 拉详情,避免手抄 JQL 再开浏览器
  • 准备提测时按项目必填字段起草工单,经确认后用 CLI 或 MCP 创建并留下可追溯描述
  • 要把多张票移到 Done 前先拉可用 transitions,逐项展示拟改状态并获批准后再执行 transition

适合人员

  • 负责迭代排期的 Scrum Master,需要在不离开对话的前提下查看「我的进行中」与当前 Sprint 工单
  • 后端工程师在 PR 讨论中引用工单号,希望助手先拉现场状态再建议是否要建关联 Jira 票
  • 用 Atlassian MCP 的平台工程师,要为指派与评论走 account ID 流程,避免静默失败
  • 值班/on-call 需要在 CLI 环境快速 `jira issue comment add` 记录事故处理进展并核对经办人