jira-automation

通过 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 服务。请确认实际的 MCP 身份验证以及 Jira 站点／账户的授权范围；仅配置端点并不能建立访问权限。

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 配置一致
• 自定义字段使用 customfield_10001 这样的 ID，而非显示名称
• 结果采用分页形式；请检查 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 文档格式（ADF）

3. 管理冲刺和看板

适用场景：用户希望使用敏捷看板、冲刺和待办事项列表

工具调用顺序：

1. JIRA_LIST_BOARDS - 列出所有看板【前置条件】
2. JIRA_LIST_SPRINTS - 列出某个看板的冲刺【必需】
3. JIRA_MOVE_ISSUE_TO_SPRINT - 将问题移至冲刺【可选】
4. JIRA_CREATE_SPRINT - 创建新冲刺【可选】

关键参数：

• boardId：来自 LIST_BOARDS 的看板 ID
• sprintId：用于移动操作的冲刺 ID
• name：创建冲刺时使用的冲刺名称
• startDate/endDate：ISO 格式的冲刺日期

注意事项：

• 看板和冲刺仅适用于 Jira Software（不适用于 Jira Core）
• 每个看板同一时间只能有一个处于活动状态的冲刺

4. 管理评论

使用时机：用户希望在问题中添加或查看评论

工具调用顺序：

1. JIRA_LIST_ISSUE_COMMENTS - 列出现有评论［可选］
2. JIRA_ADD_COMMENT - 为问题添加评论［必需］

关键参数：

• issueIdOrKey：问题键，例如 'PROJ-123'
• body：评论正文（支持用于富文本的 ADF）

注意事项：

• 评论支持使用 ADF（Atlassian 文档格式）进行排版
• 提及用户时使用账户 ID，而不是用户名

5. 管理项目和用户

使用时机：用户希望列出项目、查找用户或管理项目角色

工具调用顺序：

1. JIRA_GET_ALL_PROJECTS - 列出所有项目［可选］
2. JIRA_GET_PROJECT - 获取项目详情［可选］
3. JIRA_FIND_USERS / JIRA_GET_ALL_USERS - 搜索用户［可选］
4. JIRA_GET_PROJECT_ROLES - 列出项目角色［可选］
5. JIRA_ADD_USERS_TO_PROJECT_ROLE - 将用户添加到角色［可选］

关键参数：

• projectIdOrKey：项目键
• query：用于 FIND_USERS 的搜索文本
• roleId：角色操作所用的角色 ID

注意事项：

• 用户操作使用账户 ID（而非电子邮件或显示名称）
• 项目角色与全局权限不同

常见模式

JQL 语法

常用运算符：

• project = "PROJ" - 按项目筛选
• status = "In Progress" - 按状态筛选
• assignee = currentUser() - 当前用户的问题
• created >= -7d - 筛选最近 7 天创建的问题
• labels = "bug" - 按标签筛选
• priority = High - 按优先级筛选
• ORDER BY created DESC - 对结果排序

组合运算符：

• AND - 同时满足两个条件
• OR - 满足任一条件
• NOT - 否定条件

分页

• 使用 startAt 和 maxResults 参数
• 查看响应中的 total，以确定剩余页数
• 持续获取，直到 startAt + maxResults >= total

已知注意事项

字段名称：

• 自定义字段使用类似 customfield_10001 的 ID
• 使用 JIRA_GET_FIELDS 查找字段 ID 和名称
• JQL 中的字段名称可能与 API 字段名称不同

身份验证：

• Jira Cloud 使用账户 ID，而不是用户名
• 必须在连接中正确配置站点 URL

快速参考

任务	工具标识	关键参数
搜索问题（JQL）	JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST	jql, maxResults
获取问题	JIRA_GET_ISSUE	issueIdOrKey
创建问题	JIRA_CREATE_ISSUE	project, issuetype, summary
编辑问题	JIRA_EDIT_ISSUE	issueIdOrKey, fields
分配问题	JIRA_ASSIGN_ISSUE	issueIdOrKey, accountId
添加评论	JIRA_ADD_COMMENT	issueIdOrKey, body
列出评论	JIRA_LIST_ISSUE_COMMENTS	issueIdOrKey
列出项目	JIRA_GET_ALL_PROJECTS	(none)
获取项目	JIRA_GET_PROJECT	projectIdOrKey
列出看板	JIRA_LIST_BOARDS	(none)
列出冲刺	JIRA_LIST_SPRINTS	boardId
移至冲刺	JIRA_MOVE_ISSUE_TO_SPRINT	sprintId, issues
创建冲刺	JIRA_CREATE_SPRINT	name, boardId
查找用户	JIRA_FIND_USERS	query
获取字段	JIRA_GET_FIELDS	(none)
列出筛选器	JIRA_LIST_FILTERS	(none)
项目角色	JIRA_GET_PROJECT_ROLES	projectIdOrKey
项目版本	JIRA_GET_PROJECT_VERSIONS	projectIdOrKey

使用时机

此技能适用于执行概览中描述的工作流或操作。

示例

用户请求：

通过 Rube MCP（Composio）自动执行 Jira 任务：问题、项目、冲刺、看板、评论、用户。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境进行验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。