linear-automation

通过 Rube MCP 自动化 Linear

通过 Rube MCP 使用 Composio 的 Linear 工具包自动执行 Linear 操作。

工具包文档：composio.dev/toolkits/linear

前置条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 激活 Linear 连接，并指定工具包 linear
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥，只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 调用 RUBE_MANAGE_CONNECTIONS，并指定工具包 linear
3. 如果连接状态不是 ACTIVE，请访问返回的身份验证链接，完成 Linear OAuth
4. 运行任何工作流前，确认连接状态为 ACTIVE

核心工作流

1. 管理问题

适用场景：用户想要创建、搜索、更新或列出 Linear 问题

工具调用顺序：

1. LINEAR_GET_ALL_LINEAR_TEAMS - 获取团队 ID [前置条件]
2. LINEAR_LIST_LINEAR_STATES - 获取团队的工作流状态 [前置条件]
3. LINEAR_CREATE_LINEAR_ISSUE - 创建新问题 [可选]
4. LINEAR_SEARCH_ISSUES / LINEAR_LIST_LINEAR_ISSUES - 查找问题 [可选]
5. LINEAR_GET_LINEAR_ISSUE - 获取问题详情 [可选]
6. LINEAR_UPDATE_ISSUE - 更新问题属性 [可选]

关键参数：

• team_id：团队 ID（创建时必需）
• title：问题标题
• description：问题描述（支持 Markdown）
• state_id：工作流状态 ID
• assignee_id：受指派用户 ID
• priority：0（无）、1（紧急）、2（高）、3（中）、4（低）
• label_ids：标签 ID 数组

注意事项：

• 创建问题时必须提供团队 ID；请先使用 GET_ALL_LINEAR_TEAMS
• 状态 ID 按团队区分；请使用正确的团队调用 LIST_LINEAR_STATES
• 优先级使用 0-4 的整数值，而非字符串名称

2. 管理项目

适用场景：用户想要创建或更新 Linear 项目

工具调用顺序：

1. LINEAR_LIST_LINEAR_PROJECTS - 列出现有项目 [可选]
2. LINEAR_CREATE_LINEAR_PROJECT - 创建新项目 [可选]
3. LINEAR_UPDATE_LINEAR_PROJECT - 更新项目详情 [可选]

关键参数：

• name：项目名称
• description：项目描述
• team_ids：与项目关联的团队 ID 数组
• state：项目状态（例如，'planned'、'started'、'completed'）

注意事项：

• 项目可跨团队，可关联多个团队

3. 管理周期

适用场景：用户想要处理 Linear 周期（冲刺）

工具调用顺序：

1. LINEAR_GET_ALL_LINEAR_TEAMS - 获取团队 ID [前置条件]
2. LINEAR_GET_CYCLES_BY_TEAM_ID / LINEAR_LIST_LINEAR_CYCLES - 列出周期 [必需]

关键参数：

• team_id：周期操作对应的团队 ID
• number：周期编号

注意事项：

• 周期按团队区分；始终使用 team_id 限定范围

4. 管理标签和评论

适用场景：用户想要创建标签或评论问题

工具调用顺序：

1. LINEAR_CREATE_LINEAR_LABEL - 创建新标签 [可选]
2. LINEAR_CREATE_LINEAR_COMMENT - 评论问题 [可选]
3. LINEAR_UPDATE_LINEAR_COMMENT - 编辑评论 [可选]

关键参数：

• name：标签名称
• color：标签颜色（十六进制）
• issue_id：评论对应的问题 ID
• body：评论正文（Markdown）

注意事项：

• 标签可以限定到团队或工作区
• 评论正文支持 Markdown 格式

5. 自定义 GraphQL 查询

适用场景：用户需要标准工具未涵盖的高级查询

工具调用顺序：

1. LINEAR_RUN_QUERY_OR_MUTATION - 执行自定义 GraphQL [必需]

关键参数：

• query：GraphQL 查询或变更字符串
• variables：查询所用变量

注意事项：

• 需要了解 Linear 的 GraphQL 架构
• GraphQL 查询受速率限制

常见模式

ID 解析

团队名称 -> 团队 ID：

1. Call LINEAR_GET_ALL_LINEAR_TEAMS
2. Find team by name in response
3. Extract id field

状态名称 -> 状态 ID：

1. Call LINEAR_LIST_LINEAR_STATES with team_id
2. Find state by name
3. Extract id field

分页

• Linear 工具会返回分页结果
• 检查响应中的分页游标
• 将游标传递给下一次请求，以获取更多页面

已知问题

团队范围：

• 问题、状态和周期均特定于团队
• 创建问题前，务必先解析 team_id

优先级值：

• 0 = 无优先级，1 = 紧急，2 = 高，3 = 中，4 = 低
• 使用整数值，而非字符串名称

快速参考

任务	工具标识	关键参数
列出团队	LINEAR_GET_ALL_LINEAR_TEAMS	（无）
创建问题	LINEAR_CREATE_LINEAR_ISSUE	team_id, title, description
搜索问题	LINEAR_SEARCH_ISSUES	query
列出问题	LINEAR_LIST_LINEAR_ISSUES	team_id, filters
获取问题	LINEAR_GET_LINEAR_ISSUE	issue_id
更新问题	LINEAR_UPDATE_ISSUE	issue_id, fields
列出状态	LINEAR_LIST_LINEAR_STATES	team_id
列出项目	LINEAR_LIST_LINEAR_PROJECTS	（无）
创建项目	LINEAR_CREATE_LINEAR_PROJECT	name, team_ids
更新项目	LINEAR_UPDATE_LINEAR_PROJECT	project_id, fields
列出周期	LINEAR_LIST_LINEAR_CYCLES	team_id
获取周期	LINEAR_GET_CYCLES_BY_TEAM_ID	team_id
创建标签	LINEAR_CREATE_LINEAR_LABEL	name, color
创建评论	LINEAR_CREATE_LINEAR_COMMENT	issue_id, body
更新评论	LINEAR_UPDATE_LINEAR_COMMENT	comment_id, body
列出用户	LINEAR_LIST_LINEAR_USERS	（无）
当前用户	LINEAR_GET_CURRENT_USER	（无）
运行 GraphQL	LINEAR_RUN_QUERY_OR_MUTATION	query, variables

---

由 Composio 提供支持