jira

用途

该技能用于通过自然语言与 Jira 交互，帮助用户在对话中查看、创建和更新 Jira 工单，检查冲刺状态，以及管理 Jira 相关事务。它支持多种后端，并根据环境自动选择。

后端检测

首次使用前需运行检测以确定使用哪个后端：

1. 检查 jira CLI 是否可用：运行 which jira。若找到，则使用 CLI 后端。
2. 若无 CLI，则检查是否存在 Atlassian MCP：查找 mcp__atlassian__* 工具。若可用，则使用 MCP 后端。
3. 若两者都不可用，则引导用户进行安装配置。

后端	使用场景	参考
CLI	jira 命令可用	references/commands.md
MCP	Atlassian MCP 工具可用	references/mcp.md
无	两者都不可用	引导安装 CLI

主要能力

CLI 快速参考

使用 MCP 后端时可跳过此节。

意图	命令
查看议题	jira issue view ISSUE-KEY
列出我的议题	jira issue list -a$(jira me)
我的进行中议题	jira issue list -a$(jira me) -s"In Progress"
创建议题	jira issue create -tType -s"Summary" -b"Description"
移动/流转	jira issue move ISSUE-KEY "State"
分配给我	jira issue assign ISSUE-KEY $(jira me)
取消分配	jira issue assign ISSUE-KEY x
添加评论	jira issue comment add ISSUE-KEY -b"Comment text"
浏览器中打开	jira open ISSUE-KEY
当前冲刺	jira sprint list --state active
我是谁	jira me

MCP 快速参考

使用 CLI 后端时可跳过此节。

意图	MCP 工具
搜索议题	mcp__atlassian__searchJiraIssuesUsingJql
查看议题	mcp__atlassian__getJiraIssue
创建议题	mcp__atlassian__createJiraIssue
更新议题	mcp__atlassian__editJiraIssue
获取可用流转	mcp__atlassian__getTransitionsForJiraIssue
执行流转	mcp__atlassian__transitionJiraIssue
添加评论	mcp__atlassian__addCommentToJiraIssue
用户查询	mcp__atlassian__lookupJiraAccountId
列出项目	mcp__atlassian__getVisibleJiraProjects

完整 MCP 模式见 references/mcp.md。

触发场景

• “创建一个 jira 工单”
• “显示 PROJ-123”
• “列出我的工单”
• “把工单移到完成”
• “当前冲刺里有什么”

议题键检测

议题键遵循格式：[A-Z]+-[0-9]+（例如 PROJ-123、ABC-1）。

当用户在对话中提及议题键时：

• CLI：jira issue view KEY 或 jira open KEY
• MCP：使用该键调用 mcp__atlassian__jira_get_issue

使用方式与工作流

创建工单：

1. 若用户引用了代码/工单/PR，先研究上下文
2. 起草工单内容
3. 与用户确认
4. 使用合适的后端创建

更新工单：

1. 先获取议题详情
2. 检查状态（进行中的工单需谨慎）
3. 展示当前值与建议变更
4. 获得批准后再更新
5. 添加评论说明变更

操作前检查

在任何操作前，先问自己：

1. 当前状态是什么？ — 始终先获取议题。不要假设状态、经办人或字段与用户所想一致。
2. 还有谁受影响？ — 检查关注者、关联议题、父级史诗。一个“简单的编辑”可能通知 10 个人。
3. 是否可逆？ — 流转可能设有单向门槛。某些工作流需要中间状态。描述编辑无法撤销。
4. 标识符是否正确？ — 议题键、流转 ID、账户 ID。显示名无法用于 MCP 分配。

限制与禁止事项

• 禁止在不获取当前状态的情况下执行流转 — 工作流可能需要中间状态。若必须先经过“进行中”，“待办” → “完成”可能静默失败。
• 禁止使用显示名进行分配（MCP） — 只有账户 ID 有效。必须先调用 lookupJiraAccountId，否则分配会静默失败。
• 禁止在未展示原文的情况下编辑描述 — Jira 没有撤销功能。用户必须看到他们正在替换的内容。
• 禁止在缺少必填字段时使用 --no-input（CLI） — 会以晦涩的错误静默失败。先检查项目的必填字段。
• 禁止假设流转名称通用 — “Done”“Closed”“Complete” 因项目而异。始终先获取可用流转。
• 禁止未经明确批准进行批量修改 — 每个工单变更都会通知关注者。10 次编辑 = 10 波通知。

安全准则

• 运行前始终展示命令/工具调用
• 修改工单前始终获得批准
• 编辑时保留原始信息
• 应用后验证更新
• 始终清晰呈现认证问题，便于用户解决

无可用后端时

若 CLI 和 MCP 都不可用，需引导用户。使用 Jira 需要以下之一：

jira CLI（推荐）： https://github.com/ankitpokhrel/jira-cli

安装：brew install ankitpokhrel/jira-cli/jira-cli 初始化：jira init

Atlassian MCP： 在 MCP 设置中使用 Atlassian 凭据进行配置。

深入参考

何时加载参考：

• 创建带复杂字段或多行内容的议题时
• 构建超出简单过滤器的 JQL 查询时
• 排查错误或认证问题时
• 处理流转、关联或冲刺时

何时不加载参考：

• 简单的查看/列出操作（上方快速参考已足够）
• 基本状态检查（jira issue view KEY）
• 在浏览器中打开议题

任务	是否加载参考？
查看单个议题	否
列出我的工单	否
带描述创建	是 — CLI 需要 /tmp 模式
流转议题	是 — 需要流转 ID 工作流
JQL 搜索	是 — 用于复杂查询
关联议题	是 — MCP 限制，需要脚本

参考文件：

• CLI 模式：references/commands.md
• MCP 模式：references/mcp.md