用途
Linear Automation 用于通过 Rube MCP 自动执行 Linear 中的各项操作。它借助 Composio 提供的 Linear 工具包，让 AI 客户端可以创建、搜索、更新和列出 Linear 的 issue、项目、周期（cycle）、团队、标签与评论，并支持运行自定义 GraphQL 查询。
前提条件
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
- 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Linear 连接，工具包为 linear。
- 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前最新的工具 schema。
安装与连接
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API key，添加端点即可工作。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包使用 linear。
- 如果连接状态不是 ACTIVE，按返回的授权链接完成 Linear OAuth。
- 确认连接状态为 ACTIVE 后再执行工作流。
主要工作流
1. 管理 Issue
适用场景：用户想创建、搜索、更新或列出 Linear issue。 工具顺序：
- LINEAR_GET_ALL_LINEAR_TEAMS 获取团队 ID（前置）
- LINEAR_LIST_LINEAR_STATES 获取某团队的工作流状态（前置）
- LINEAR_CREATE_LINEAR_ISSUE 创建 issue（可选）
- LINEAR_SEARCH_ISSUES / LINEAR_LIST_LINEAR_ISSUES 查找 issue（可选）
- LINEAR_GET_LINEAR_ISSUE 获取 issue 详情（可选）
- LINEAR_UPDATE_ISSUE 更新 issue 属性（可选）
关键参数：
- team_id：团队 ID（创建时必填）
- title：issue 标题
- description：issue 描述（支持 Markdown）
- state_id：工作流状态 ID
- assignee_id：负责人用户 ID
- priority：0（无）、1（紧急）、2（高）、3（中）、4（低）
- label_ids：标签 ID 数组
注意事项：
- 创建 issue 时必须提供团队 ID，先调用 GET_ALL_LINEAR_TEAMS。
- 状态 ID 是团队专属的，需用正确的 team 调用 LIST_LINEAR_STATES。
- 优先级使用 0-4 的整数，不是字符串名称。
2. 管理项目
适用场景：用户想创建或更新 Linear 项目。 工具顺序：
- LINEAR_LIST_LINEAR_PROJECTS 列出已有项目（可选）
- LINEAR_CREATE_LINEAR_PROJECT 创建项目（可选）
- LINEAR_UPDATE_LINEAR_PROJECT 更新项目详情（可选）
关键参数：
- name：项目名称
- description：项目描述
- team_ids：与项目关联的团队 ID 数组
- state：项目状态（如 'planned'、'started'、'completed'）
注意事项：
- 项目可跨团队，能关联多个团队。
3. 管理周期（Cycle）
适用场景：用户想操作 Linear 周期（冲刺）。 工具顺序：
- LINEAR_GET_ALL_LINEAR_TEAMS 获取团队 ID（前置）
- LINEAR_GET_CYCLES_BY_TEAM_ID / LINEAR_LIST_LINEAR_CYCLES 列出周期（必需）
关键参数：
- team_id：周期操作对应的团队 ID
- number：周期编号
注意事项：
- 周期是团队专属的，务必按 team_id 限定范围。
4. 管理标签与评论
适用场景：用户想创建标签或对 issue 发表评论。 工具顺序：
- LINEAR_CREATE_LINEAR_LABEL 创建标签（可选）
- LINEAR_CREATE_LINEAR_COMMENT 对 issue 评论（可选）
- LINEAR_UPDATE_LINEAR_COMMENT 编辑评论（可选）
关键参数：
- name：标签名称
- color：标签颜色（十六进制）
- issue_id：评论所属 issue ID
- body：评论正文（Markdown）
注意事项：
- 标签可以是团队范围或工作区范围。
- 评论正文支持 Markdown 格式。
5. 自定义 GraphQL 查询
适用场景：用户需要标准工具未覆盖的高级查询。 工具顺序：
- LINEAR_RUN_QUERY_OR_MUTATION 执行自定义 GraphQL（必需）
关键参数：
- query：GraphQL 查询或变更字符串
- variables：查询的变量
注意事项：
- 需要了解 Linear 的 GraphQL schema。
- GraphQL 查询会受速率限制。
常见模式
ID 解析
团队名称 -> 团队 ID：
- 调用 LINEAR_GET_ALL_LINEAR_TEAMS
- 在响应中按名称查找团队
- 提取 id 字段
状态名称 -> 状态 ID：
- 用 team_id 调用 LINEAR_LIST_LINEAR_STATES
- 按名称查找状态
- 提取 id 字段
分页
- Linear 工具返回分页结果
- 检查响应中的分页游标
- 将游标传给下一个请求以获取更多页
已知注意事项
- 团队范围：issue、状态和周期均按团队区分；创建 issue 前务必先解析 team_id。
- 优先级取值：0 = 无优先级，1 = 紧急，2 = 高，3 = 中，4 = 低；使用整数值，不是字符串名称。
快速参考
| 任务 | 工具 Slug | 关键参数 |
|---|---|---|
| 列出团队 | LINEAR_GET_ALL_LINEAR_TEAMS | （无） |
| 创建 issue | LINEAR_CREATE_LINEAR_ISSUE | team_id, title, description |
| 搜索 issue | LINEAR_SEARCH_ISSUES | query |
| 列出 issue | LINEAR_LIST_LINEAR_ISSUES | team_id, filters |
| 获取 issue | LINEAR_GET_LINEAR_ISSUE | issue_id |
| 更新 issue | 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 |
适用场景
适合需要在 AI 客户端中自动执行 Linear 项目管理的团队或个人，例如批量创建 issue、按团队查询周期、同步项目状态、添加标签与评论，以及执行自定义 GraphQL 查询。
限制
- 使用前必须连接 Rube MCP 并完成 Linear OAuth 授权。
- 每次需先调用 RUBE_SEARCH_TOOLS 以获取最新 schema。
- 部分操作依赖团队 ID 和状态 ID，需提前解析。
- 自定义 GraphQL 需要了解 Linear 的 schema，且受速率限制。
- 结果分页，需要处理游标。
- 收费、价格、平台支持范围等资料暂未提供。