linear 快速入门

让 AI 直接”听懂”你的 Linear 看板,把项目管理从”切来切去”变成”一句话的事”。

这是什么?解决什么问题?

Linear 是近两年最受欢迎的项目管理工具之一,以”快、键盘流、极简”著称。但工具再好,日常操作依然繁琐:打开网页 → 切到 Inbox → 看 3 个新 issue → 手动 assign → 改 due date → 写进度评论……这些动作每个 10 秒,一天累计 1 小时。

linear Skill 是 Linear 官方维护的 MCP Server,完整暴露了 Linear GraphQL API 的能力:Issue 管理(创建/更新/查询/关闭)、Project(项目状态、里程碑)、Cycle(冲刺/Sprint)、Team(团队配置)、Roadmap(路线图)、Comments、文档。

加载 Skill 后,AI 可以直接帮你:扫”待我处理的 issue”、“自动给过期 issue 改 priority”、“把散落的 idea 收集到 Backlog”、“根据本周完成的 issue 自动生成周报”。它解决了”Linear 用户必须在网页和 IDE 之间反复切换”的问题。

适合:Linear 重度用户、5-50 人研发团队、想把 PM 流程 AI 化的工程经理。

准备工作

1. Linear 账号:https://linear.app/
2. API Key:在 Linear 设置 → API → Personal API keys 生成
3. Claude Code / Cursor:支持 MCP 的 AI 客户端
4. 可选:Linear 团队、Project、Cycle 已配好

3 步快速上手

第 1 步:安装 Skill(MCP 形式)

在 Claude Code 中:

claude mcp add --transport http linear https://mcp.linear.app/mcp

仓库:https://github.com/linear/linear-mcp-server

或在 .cursor/mcp.json:

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

第 2 步:配置认证

按提示粘贴 Personal API Key。

第 3 步:用 Skill 跑第一个查询

向 AI 说:

用 linear Skill,列出分配给我、未完成、按 priority 排序的所有 issue

AI 调 Linear API 返回真实列表,可以直接做后续处理(批量改 due date / 合并到 cycle 等)。

常见踩坑

1. API Key 权限过大:Personal API Key 默认是”全权限”,泄露风险大。要用 limited scope key(只读)+ Server Key(写)。
2. Rate Limit:Linear MCP 默认每秒限流,大量操作会被限速。Skill 默认会重试 + 退避,但极端批量要分批。
3. Cycle 时间跨度混淆:Linear 的 Cycle 默认是 2 周,跨 Cycle 移动 issue 会改变 velocity 统计,要小心。
4. Label 命名混乱:每个团队可能有 50+ labels,过滤查询时容易拼错名字。Skill 支持模糊匹配但建议提供 ID。
5. 误关 issue:AI 在批量操作时可能”过度热情”地关掉未真正完成的 issue,务必在指令里加”先列出待操作的,等我确认”。
6. 优先级判断错:Linear 的 priority 是 0-4 数字,0=No priority,1=Urgent,4=Low。AI 容易把 1 当成最低,要显式说明。

初级用法

1. 创建 issue:给我创建一个 issue,title="修复登录页 token 刷新 bug",priority=1,team=FE
2. 改 issue 状态:把 #ABC 这个 issue 状态从 "In Progress" 改为 "Done"
3. 查询 cycle 进度:当前 Cycle 还有哪些 issue 没开始

高级玩法

1. 自动周报:用 AI 跑”本周我完成的 issue + 还在 in-progress 的 issue”,自动生成 markdown 周报。
2. 智能分流:扫新进来的 issue,根据关键词(关键词+team 归属)自动 assign 给指定成员。
3. Roadmap 视图汇总:把所有 Project 按 status 分类,生成”进行中/计划中/已完成”清单,适合季度 review。

小技巧

• 用 Linear 的快捷键 C 创建 issue,Cmd+K 全局搜索,比鼠标快很多,Skill 只是”更高级”的快捷键。
• Issue 描述里用 markdown 写 Acceptance Criteria,Skill 会主动识别”是否完成”。
• Cycle 结束前让 AI 跑一遍”未完成 issue 自动移到下一个 Cycle”,避免 sprint 被打断。
• 用 Linear 的 GraphQL API 自定义视图(比如”所有阻塞超过 3 天的 issue”),AI 帮你生成。
• 给团队配 webhook,把 Linear 事件(issue 关闭、PR 合并)推到 Slack,信息流更及时。
• 复杂任务用 Linear 父 issue + 子 issue 拆解,Skill 可以按父子关系批量更新。

常见问题 FAQ

Q1: 这个 Skill 跟 linear 有什么关系?必须装吗?

A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?

A: linear 来自 community,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?

A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了?

A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗?

A: 取决于 linear 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

参考链接

• Skill 仓库:https://github.com/linear/linear-mcp-server
• Linear 官方文档:https://developers.linear.app/
• Linear GraphQL API:https://developers.linear.app/docs/graphql/working-with-the-graphql-api
• MCP 协议规范:https://modelcontextprotocol.io/
• Linear 快捷键速查:https://linear.app/docs/keyboard-shortcuts
• Linear 团队管理最佳实践:https://linear.app/blog

实战经验:从零搭建一个 Linear 协作流

下面用一个真实场景演示如何用 linear Skill 把日常 PM 工作全部自动化。

场景:某 5 人前端团队,使用 Linear 管理 issue。每天早上 10 点开 15 分钟站会,周五下午写周报。

步骤 1:用 Skill 拉取”我的今日待办”

对 AI 说:

用 linear Skill,列出今天还没开始、分配给我的所有 issue,按 priority 倒序

AI 返回:一个清单,每条带”标题、ID、估计工时、依赖项”。

步骤 2:用 Skill 自动分配新 issue

用 linear Skill 监听本周期新创建的 issue,
关键词含 "UI" 分配给张同学,"API" 分配给李同学,"测试" 分配给王同学

AI 创建 webhook 监听器(需 Linear 团队支持),自动按规则派发。

步骤 3:用 Skill 生成周五周报

用 linear Skill 统计本周:
1) 我完成的 issue
2) 我 in-progress 的 issue
3) 团队整体完成率
输出为 markdown 周报

AI 把”原始数据”组织成可直接发到群里的结构化报告。

这套流程下来,PM 的机械操作时间从 1.5 小时/天压到 10 分钟,人更专注”判断优先级”和”沟通风险”。

配合使用的工具链

• Slack 通知:Linear 官方集成,把 issue 状态变化推送到 Slack 频道,Skill 不会重复做这件事。
• GitHub PR 关联:在 PR 描述里写 Fix LIN-123,PR 合并后 Linear 自动关闭对应 issue。
• Time Tracking:用 toggl 或 clockify 跟踪实际耗时,定期让 AI 拉取数据生成”估时 vs 实际”分析。
• Roadmap 视图:Linear 自带的 Roadmap 配合 Skill 一起用,适合季度 review 时给非技术 stakeholder 演示。
• Triage 工作流:用 Skill + Linear 的 Triage 视图,新 issue 进来后自动按规则分类,人工只在边界 case 介入。

和传统 Jira/Asana 的对比

• Linear:键盘流、API 友好、MCP 集成度好,适合”开发者友好”的工程团队。
• Jira:功能复杂、配置项多,适合大型企业 + 复杂审批流。
• Asana:跨部门协作好,但开发场景不深。
• Trello / Notion:轻量级,适合小团队或个人。

选择哪个取决于:团队规模、跨部门协作复杂度、是否需要复杂自定义工作流、API 集成需求。

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。