mcpField
L
linear

linear

github.com/openai生产力28.4k10.6k 次安装18 周前更新
代码仓库

关于 linear

linear 是通过已连接的 Linear MCP 服务管理 Linear 问题、项目与团队协作的工作流技能。它从明确范围、读取上下文到执行更改并总结结果，提供结构化流程。

主要功能

  1. 01管理问题与项目
  2. 02搜索文档和评论
  3. 03规划周期与团队工作流
  4. 04批量执行相关 MCP 操作
  5. 05总结结果与阻碍

适用场景

  1. 01分流并排序错误
  2. 02规划冲刺或发布
  3. 03审查文档缺漏
  4. 04平衡团队工作量

MCP 相关

它需要通过 OAuth 连接 Linear MCP 服务，并使用其中的工具读取和管理问题、项目、团队、文档及协作数据。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openai/skills --skill linear

安装后在 Claude Code 中输入/linear确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE.txt
agents/
openai.yaml
assets/
linear-small.svg

详细介绍

Linear

概述

本技能提供了一套结构化工作流，用于在 Linear 中管理议题、项目和团队工作流。它确保与 Linear MCP 服务保持一致集成，该服务为议题、项目、文档和团队协作提供自然语言项目管理能力。

前提条件

  • 必须已连接 Linear MCP 服务，并可通过 OAuth 访问
  • 确认可访问相关的 Linear 工作区、团队和项目

必需工作流

请按顺序执行以下步骤。不要跳过任何步骤。

步骤 0：设置 Linear MCP（如果尚未配置）

如果任何 MCP 调用因 Linear MCP 未连接而失败，请暂停并完成设置：

  1. 添加 Linear MCP：
    • codex mcp add linear --url https://mcp.linear.app/mcp
  2. 启用远程 MCP 客户端：
    • 在 config.toml 中设置 [features] rmcp_client = true 或运行 codex --enable rmcp_client
  3. 使用 OAuth 登录：
    • codex mcp login linear

登录成功后，用户需要重启 codex。你应当结束回答并告知用户，当他们再次尝试时可以从步骤 1 继续。

Windows/WSL 注意事项： 如果你在 Windows 上遇到连接错误，请尝试将 Linear MCP 配置为通过 WSL 运行：

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}
步骤 1

明确用户的目标和范围（例如：议题分类、冲刺规划、文档审计、工作负载平衡）。按需确认团队/项目、优先级、标签、周期和截止日期。

步骤 2

选择合适的工作流（见下方实用工作流），并确定你将需要的 Linear MCP 工具。在调用工具前，确认所需的标识符（议题 ID、项目 ID、团队键）。

步骤 3

按逻辑批次执行 Linear MCP 工具调用：

  • 先读取（list/get/search）以构建上下文。
  • 接着创建或更新（议题、项目、标签、评论），并填写所有必填字段。
  • 对于批量操作，在应用更改前先说明分组逻辑。
步骤 4

总结结果，指出剩余的缺口或阻塞项，并提出后续行动（新增议题、标签变更、分配或后续评论）。

可用工具

议题管理：list_issues、get_issue、create_issue、update_issue、list_my_issues、list_issue_statuses、list_issue_labels、create_issue_label

项目与团队：list_projects、get_project、create_project、update_project、list_teams、get_team、list_users

文档与协作：list_documents、get_document、search_documentation、list_comments、create_comment、list_cycles

实用工作流

  • 冲刺规划：查看目标团队的未关闭议题，按优先级挑选最重要的条目，并创建一个新周期（例如 "Q1 Performance Sprint"）及相应分配。
  • Bug 分类：列出严重/高优先级 Bug，按用户影响排序，并将最重要的条目移至 "In Progress"。
  • 文档审计：搜索文档（例如 API 认证），然后为缺口或过时部分创建带有 "documentation" 标签的议题，并附上详细修复方案。
  • 团队工作负载平衡：按负责人对活跃议题进行分组，标记负载过高的人员，并建议或应用重新分配。
  • 发布规划：创建一个项目（例如 "v2.0 Release"）及里程碑（功能冻结、beta、文档、发布），并生成带估算的议题。
  • 跨项目依赖：找出所有 "blocked" 议题，识别阻塞项，并在缺失时创建关联议题。
  • 自动化状态更新：找出你那些更新停滞的议题，并根据当前状态/阻塞项添加状态评论。
  • 智能标签：分析未标记的议题，建议/应用标签，并创建缺失的标签类别。
  • 冲刺回顾：为最近完成的周期生成报告，记录已完成与推迟的工作，并针对模式创建讨论议题。

最大化生产力的技巧

  • 对相关更改进行批量操作；考虑为重复出现的问题结构使用智能模板。
  • 尽可能使用自然查询（“给我看看 John 这周在做什么”）。
  • 善用上下文：在新请求中引用之前的问题。
  • 将大型更新拆分为较小的批次以避免速率限制；频繁列出时缓存或复用筛选条件。

故障排查

  • 身份验证：清除浏览器 Cookie，重新运行 OAuth，验证工作区权限，确保已启用 API 访问。
  • 工具调用错误：确认模型支持多个工具调用，提供所有必填字段，并拆分复杂请求。
  • 数据缺失：刷新令牌，验证工作区访问权限，检查是否有已归档项目，并确认团队选择正确。
  • 性能：记住 Linear API 的速率限制；批量执行批量操作，使用特定筛选条件，或缓存频繁查询。

评论

支持 Markdown