Jira Automation via Rube MCP
该技能通过 Composio 的 Jira 工具包，经由 Rube MCP 自动化 Jira 操作。
前置条件
- 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
- 已通过 RUBE_MANAGE_CONNECTIONS（toolkit 为 jira）建立有效的 Jira 连接。
- 始终先调用 RUBE_SEARCH_TOOLS 以获取当前工具 schema。
设置
- 获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加端点即可。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，toolkit 为 jira。
- 若连接不是 ACTIVE，按返回的授权链接完成 Jira OAuth。
- 在运行任何工作流前确认连接状态为 ACTIVE。
核心工作流
- 搜索与筛选问题
适用场景：用户想用 JQL 查找问题或浏览项目问题。
工具顺序：
- JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST - 用 JQL 查询搜索 [必需]
- 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 以决定是否继续。
- 创建与编辑问题
适用场景：用户想创建新问题或更新已有问题。
工具顺序：
- JIRA_GET_ALL_PROJECTS - 列出项目以查找项目键 [前置]
- JIRA_GET_FIELDS - 获取可用字段及其 ID [前置]
- JIRA_CREATE_ISSUE - 创建新问题 [必需]
- JIRA_EDIT_ISSUE - 更新已有问题的字段 [可选]
- JIRA_ASSIGN_ISSUE - 将问题指派给用户 [可选]
关键参数：
- project：项目键（例如 'PROJ'）
- issuetype：问题类型名称（例如 'Bug'、'Story'、'Task'）
- summary：问题标题
- description：问题描述（Atlassian Document Format 或纯文本）
- issueIdOrKey：编辑时的问题键
注意事项：
- 问题类型和必填字段因项目而异；用 GET_FIELDS 检查。
- 自定义字段需要精确字段 ID，而非显示名称。
- 描述可能需要 Atlassian Document Format (ADF) 才能包含富内容。
- 管理冲刺与看板
适用场景：用户想操作敏捷看板、冲刺和待办。
工具顺序：
- JIRA_LIST_BOARDS - 列出所有看板 [前置]
- JIRA_LIST_SPRINTS - 列出某看板的冲刺 [必需]
- JIRA_MOVE_ISSUE_TO_SPRINT - 将问题移入冲刺 [可选]
- JIRA_CREATE_SPRINT - 创建新冲刺 [可选]
关键参数：
- boardId：来自 LIST_BOARDS 的看板 ID
- sprintId：移动操作使用的冲刺 ID
- name：创建时的冲刺名称
- startDate/endDate：ISO 格式的冲刺日期
注意事项：
- 看板和冲刺属于 Jira Software（而非 Jira Core）。
- 每个看板同一时间只能有一个活动冲刺。
- 管理评论
适用场景：用户想添加或查看问题评论。
工具顺序：
- JIRA_LIST_ISSUE_COMMENTS - 列出现有评论 [可选]
- JIRA_ADD_COMMENT - 向问题添加评论 [必需]
关键参数：
- issueIdOrKey：问题键，如 'PROJ-123'
- body：评论正文（支持 ADF 富文本）
注意事项：
- 评论支持 ADF（Atlassian Document Format）以进行格式化。
- 提及使用 account ID，而非用户名。
- 管理项目与用户
适用场景：用户想列出项目、查找用户或管理项目角色。
工具顺序：
- JIRA_GET_ALL_PROJECTS - 列出所有项目 [可选]
- JIRA_GET_PROJECT - 获取项目详情 [可选]
- JIRA_FIND_USERS / JIRA_GET_ALL_USERS - 搜索用户 [可选]
- JIRA_GET_PROJECT_ROLES - 列出项目角色 [可选]
- JIRA_ADD_USERS_TO_PROJECT_ROLE - 将用户添加到角色 [可选]
关键参数：
- projectIdOrKey：项目键
- query：FIND_USERS 的搜索文本
- roleId：角色操作使用的角色 ID
注意事项：
- 用户操作使用 account 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 使用 account ID，而非用户名。
- 站点 URL 必须在连接中正确配置。
速查表
任务 / 工具 Slug / 关键参数
- 搜索问题 (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；（无）
- 获取项目：JIRA_GET_PROJECT；projectIdOrKey
- 列出看板：JIRA_LIST_BOARDS；（无）
- 列出冲刺：JIRA_LIST_SPRINTS；boardId
- 移入冲刺：JIRA_MOVE_ISSUE_TO_SPRINT；sprintId、issues
- 创建冲刺：JIRA_CREATE_SPRINT；name、boardId
- 查找用户：JIRA_FIND_USERS；query
- 获取字段：JIRA_GET_FIELDS；（无）
- 列出过滤器：JIRA_LIST_FILTERS；（无）
- 项目角色：JIRA_GET_PROJECT_ROLES；projectIdOrKey
- 项目版本：JIRA_GET_PROJECT_VERSIONS；projectIdOrKey