Jira
将以下提示词粘贴到你的 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` 记录事故处理进展并核对经办人