[ PROMPT_NODE_22514 ]
jira
[ SKILL_DOCUMENTATION ]
# 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`。
---
## 触发器
- "create a jira ticket"
- "show me PROJ-123"
- "list my tickets"
- "move ticket to done"
- "what's in the current sprint"
---
## 问题键检测
问题键遵循模式:`[A-Z]+-[0-9]+` (例如 PROJ-123, ABC-1)。
当用户在对话中提到问题键时:
- **CLI:** `jira issue view KEY` 或 `jira open KEY`
- **MCP:** 使用该键调用 `mcp__atlassian__jira_get_issue`
---
## 工作流