linear

linear skill 概览

linear skill 帮你通过 Linear MCP server 与 Linear 协作，让 agent 能够读取、创建和更新 issue，而不用去猜工作区结构或工作流约定。它最适合那些需要用 linear 做 Issue Tracking、分诊、项目协同，或让团队工作始终对齐最新 issue 状态的人。

这个 linear skill 用来做什么

当任务依赖准确的 Linear 数据时，就该使用这个 linear skill：查找正确的 issue、更新状态、补充上下文、分配负责人，或者查看项目进度。与通用提示词相比，当你需要 agent 在真实的 Linear 工作区里直接操作，而不是单纯生成一份独立建议时，它更合适。

适合谁安装

如果你已经在用 Linear 做 issue tracking，并希望 agent 帮你处理运营型工作——比如分诊队列、ticket 整理、项目跟进，或跨团队协调——就适合安装 linear。它特别适合重视流程准确性，而不只是生成文本的人。

主要决策因素

关键依赖是访问权限：这个 skill 需要已连接的 Linear MCP server 和 OAuth 登录。如果你的 workspace、team 或 project 有权限限制，在确认权限之前，落地可能会卡住。它最大的价值，是让你能可靠、带上下文地使用 Linear；最大的风险，是在 MCP 还没配置好之前，就误以为它已经能开始执行。

如何使用 linear skill

安装并连接 Linear MCP

要使用 linear，先安装 skill，再连接 MCP server，之后再期待它产生结果：

codex mcp add linear --url https://mcp.linear.app/mcp
codex --enable rmcp_client
codex mcp login linear

如果登录成功，继续之前先重启 Codex。若在 Windows 上遇到连接问题，基于 WSL 的 MCP 传输方式往往是更快的可用路径。

给 skill 合适的任务形状

最好的 linear 使用方式，始于明确的动作，而不是模糊目标。好的输入会直接点明对象和要做的改变：比如“找到登录失败的 bug report，把它移到 In Progress，并总结阻塞因素”，或者“为 onboarding docs 创建一个 Linear issue，包含 owner、priority 和 acceptance criteria”。不要只说“整理 Linear”，除非你同时说明范围、team，以及你希望输出什么。

先读这些文件

先从 SKILL.md 看起，再检查 agents/openai.yaml 里的默认意图和 MCP 依赖。还要查看 LICENSE.txt 了解复用上下文；只有在你确实需要品牌素材时，才去看 asset 文件。最关键的操作细节都在 SKILL.md 里，尤其是 setup 和 clarification 步骤。

能显著提升结果的工作流建议

当你希望模型直接在 Linear 里执行时，要提供 workspace、team、project，以及这次请求是只读还是会修改内容。如果你需要更新 issue，把你想改的字段明确写出来，再加上 priority、due date 或 assignee 之类的限制条件。如果 MCP 连接还没准备好，skill 应该先停下来，帮你完成 setup，再继续往下做。

linear skill 常见问题

linear 只是用来做 issue tracking 吗？

不是。linear 用于 Issue Tracking 是最常见的场景，但这个 skill 同样适合项目更新、团队协同，以及 Linear 内与文档关联的工作流任务。只要事实源在 Linear 里，而且输出需要反映工作区的实时状态，就都可以用它。

linear skill 和普通提示词有什么区别？

普通提示词只能描述应该发生什么；linear skill 则是被设计成在已连接的 Linear 工作区里直接把事情做出来。这一点在你需要真实 issue ID、当前状态、权限检查，或可靠更新，而不是一份纯文本计划时尤其重要。

这个 skill 适合初学者吗？

可以，前提是你能清楚说出任务，而且你已经能访问 Linear。如果你还在纠结到底该改哪个 team、project 或 issue，那它就没那么适合入门，因为最好的 linear 指令输入必须足够具体。

什么时候不该用它？

如果你只需要一个通用的项目管理模板，如果你的 Linear workspace 还没有连接，或者任务本来就不该放在 issue tracker 里，就不要用 linear。它也不适合那种只需要广泛头脑风暴、但不需要任何真实 Linear 操作的场景。

如何改进 linear skill

提供更丰富的 Linear 上下文

最强的 linear 指令输入会包含 workspace、team、project、issue 标题或链接，以及明确的操作。若你想获得更好的分诊结果，就补充症状、优先级线索和相关 issue 引用，这样 agent 才能更快消歧。

说清楚你想要的最终状态

不要只说“帮我处理这个 issue”，而要直接说明这个 Linear issue 在任务完成后应该长什么样：状态已改、负责人已设、描述已重写、acceptance criteria 已补充，或者重复项已合并。明确的终态要求能减少来回确认，也会让 Linear 使用更可预测。

注意 setup 和权限失败

最常见的失败模式通常不是提示词本身，而是缺少 MCP 访问或 workspace 权限不足。如果 skill 连不上，先修好 Linear MCP setup；如果能连接但无法执行操作，再检查相关 team 和 project 的权限，然后重试。

先跑一轮，再用更紧的提示词迭代

如果第一次结果太宽泛，就通过一次只加一个 issue、一个 team 或一个 project 来收窄范围。对于重复性工作，建议复用稳定的提示词模板，把任务类型、范围和成功标准都写进去，这样 linear skill 才能以更少的修改产出更一致的更新。