[ PROMPT_NODE_28072 ]
jira-automation
[ SKILL_DOCUMENTATION ]
# 通过 Rube MCP 进行 Jira 自动化
通过 Rube MCP 使用 Composio 的 Jira 工具集自动化 Jira 操作。
## 前置条件
- 必须连接 Rube MCP (提供 `RUBE_SEARCH_TOOLS`)
- 通过 `RUBE_MANAGE_CONNECTIONS` 使用 `jira` 工具集激活 Jira 连接
- 始终先调用 `RUBE_SEARCH_TOOLS` 以获取当前工具架构
## 设置
**获取 Rube MCP**:在客户端配置中添加 `https://rube.app/mcp` 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。
1. 通过确认 `RUBE_SEARCH_TOOLS` 有响应来验证 Rube MCP 是否可用
2. 使用 `jira` 工具集调用 `RUBE_MANAGE_CONNECTIONS`
3. 如果连接不是 ACTIVE,请按照返回的授权链接完成 Jira OAuth
4. 在运行任何工作流之前,确认连接状态显示为 ACTIVE
## 核心工作流
### 1. 搜索和过滤问题
**适用场景**:用户想要使用 JQL 查找问题或浏览项目问题
**工具序列**:
1. `JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST` - 使用 JQL 查询进行搜索 [必需]
2. `JIRA_GET_ISSUE` - 获取特定问题的详细信息 [可选]
**关键参数**:
- `jql`: JQL 查询字符串 (例如 `project = PROJ AND status = "In Progress"`)
- `maxResults`: 每页最大结果数 (默认 50,最大 100)
- `startAt`: 分页偏移量
- `fields`: 要返回的字段名称数组
- `issueIdOrKey`: GET_ISSUE 的问题键,如 'PROJ-123'
**陷阱**:
- JQL 字段名称区分大小写,必须与 Jira 配置匹配
- 自定义字段使用 ID(如 `customfield_10001`),而不是显示名称
- 结果是分页的;检查 `total` 与 `startAt + maxResults` 以继续
### 2. 创建和编辑问题
**适用场景**:用户想要创建新问题或更新现有问题
**工具序列**:
1. `JIRA_GET_ALL_PROJECTS` - 列出项目以查找项目键 [前置条件]
2. `JIRA_GET_FIELDS` - 获取可用字段及其 ID [前置条件]
3. `JIRA_CREATE_ISSUE` - 创建新问题 [必需]
4. `JIRA_EDIT_ISSUE` - 更新现有问题的字段 [可选]
5. `JIRA_ASSIGN_ISSUE` - 将问题分配给用户 [可选]
**关键参数**:
- `project`: 项目键 (例如 'PROJ')
- `issuetype`: 问题类型名称 (例如 'Bug', 'Story', 'Task')
- `summary`: 问题标题
- `description`: 问题描述 (Atlassian 文档格式或纯文本)
- `issueIdOrKey`: 编辑时的问题键
**陷阱**:
- 问题类型和必填字段因项目而异;使用 GET_FIELDS 进行检查
- 自定义字段需要确切的字段 ID,而不是显示名称
- 描述可能需要 Atlassian 文档格式