linear

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<br>
```<br>
仓库:https://github.com/linear/linear-mcp-server<br>
或在 `.cursor/mcp.json`:<br>
```json<br>
{<br>
"mcpServers": {<br>
"linear": {<br>
"url": "https://mcp.linear.app/mcp"<br>
}<br>
}<br>
}<br>
```<br>
### 第 2 步:配置认证<br>
按提示粘贴 Personal API Key。<br>
### 第 3 步:用 Skill 跑第一个查询<br>
向 AI 说:<br>
```<br>
用 linear Skill,列出分配给我、未完成、按 priority 排序的所有 issue<br>
```<br>
AI 调 Linear API 返回真实列表,可以直接做后续处理(批量改 due date / 合并到 cycle 等)。<br>
## 常见踩坑<br>
1. **API Key 权限过大**:Personal API Key 默认是"全权限",泄露风险大。要用 limited scope key(只读)+ Server Key(写)。<br>
2. **Rate Limit**:Linear MCP 默认每秒限流,大量操作会被限速。Skill 默认会重试 + 退避,但极端批量要分批。<br>
3. **Cycle 时间跨度混淆**:Linear 的 Cycle 默认是 2 周,跨 Cycle 移动 issue 会改变 velocity 统计,要小心。<br>
4. **Label 命名混乱**:每个团队可能有 50+ labels,过滤查询时容易拼错名字。Skill 支持模糊匹配但建议提供 ID。<br>
5. **误关 issue**:AI 在批量操作时可能"过度热情"地关掉未真正完成的 issue,务必在指令里加"先列出待操作的,等我确认"。<br>
6. **优先级判断错**:Linear 的 priority 是 0-4 数字,0=No priority,1=Urgent,4=Low。AI 容易把 1 当成最低,要显式说明。<br>
## 初级用法<br>
1. **创建 issue**:`给我创建一个 issue,title="修复登录页 token 刷新 bug",priority=1,team=FE`<br>
2. **改 issue 状态**:`把 #ABC 这个 issue 状态从 "In Progress" 改为 "Done"`<br>
3. **查询 cycle 进度**:`当前 Cycle 还有哪些 issue 没开始`<br>
## 高级玩法<br>
1. **自动周报**:用 AI 跑"本周我完成的 issue + 还在 in-progress 的 issue",自动生成 markdown 周报。<br>
2. **智能分流**:扫新进来的 issue,根据关键词(关键词+team 归属)自动 assign 给指定成员。<br>
3. **Roadmap 视图汇总**:把所有 Project 按 status 分类,生成"进行中/计划中/已完成"清单,适合季度 review。<br>
## 小技巧<br>
- 用 Linear 的快捷键 `C` 创建 issue,`Cmd+K` 全局搜索,比鼠标快很多,Skill 只是"更高级"的快捷键。<br>
- Issue 描述里用 markdown 写 Acceptance Criteria,Skill 会主动识别"是否完成"。<br>
- Cycle 结束前让 AI 跑一遍"未完成 issue 自动移到下一个 Cycle",避免 sprint 被打断。<br>
- 用 Linear 的 GraphQL API 自定义视图(比如"所有阻塞超过 3 天的 issue"),AI 帮你生成。<br>
- 给团队配 `webhook`,把 Linear 事件(issue 关闭、PR 合并)推到 Slack,信息流更及时。<br>
- 复杂任务用 Linear 父 issue + 子 issue 拆解,Skill 可以按父子关系批量更新。<br>
## 常见问题 FAQ<br>
**Q1: 这个 Skill 跟 linear 有什么关系?必须装吗?**<br>
A: Skill 是给 AI Agent 用的"技能包",能告诉 Agent 怎么按特定规范工作。**不是必须装**——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。<br>

**Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?**<br>
A: linear 来自 community,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。<br>

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

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

**Q5: 这个 Skill 有许可证吗?能商用吗?**<br>
A: 取决于 linear 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。<br>
## 参考链接<br>
- [Skill 仓库](https://github.com/linear/linear-mcp-server)<br>
- [Linear 官方文档](https://developers.linear.app/)<br>
- [Linear GraphQL API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api)<br>
- [MCP 协议规范](https://modelcontextprotocol.io/)<br>
- [Linear 快捷键速查](https://linear.app/docs/keyboard-shortcuts)<br>
- [Linear 团队管理最佳实践](https://linear.app/blog)<br>
## 实战经验:从零搭建一个 Linear 协作流<br>
下面用一个真实场景演示如何用 linear Skill 把日常 PM 工作全部自动化。<br>
**场景**:某 5 人前端团队,使用 Linear 管理 issue。每天早上 10 点开 15 分钟站会,周五下午写周报。<br>
### 步骤 1:用 Skill 拉取"我的今日待办"<br>
对 AI 说:<br>
```<br>
用 linear Skill,列出今天还没开始、分配给我的所有 issue,按 priority 倒序<br>
```<br>
AI 返回:一个清单,每条带"标题、ID、估计工时、依赖项"。<br>
### 步骤 2:用 Skill 自动分配新 issue<br>
```<br>
用 linear Skill 监听本周期新创建的 issue,<br>
关键词含 "UI" 分配给张同学,"API" 分配给李同学,"测试" 分配给王同学<br>
```<br>
AI 创建 webhook 监听器(需 Linear 团队支持),自动按规则派发。<br>
### 步骤 3:用 Skill 生成周五周报<br>
```<br>
用 linear Skill 统计本周:<br>
1) 我完成的 issue<br>
2) 我 in-progress 的 issue<br>
3) 团队整体完成率<br>
输出为 markdown 周报<br>
```<br>
AI 把"原始数据"组织成可直接发到群里的结构化报告。<br>
这套流程下来,PM 的机械操作时间从 1.5 小时/天压到 10 分钟,人更专注"判断优先级"和"沟通风险"。<br>
## 配合使用的工具链<br>
- **Slack 通知**:Linear 官方集成,把 issue 状态变化推送到 Slack 频道,Skill 不会重复做这件事。<br>
- **GitHub PR 关联**:在 PR 描述里写 `Fix LIN-123`,PR 合并后 Linear 自动关闭对应 issue。<br>
- **Time Tracking**:用 `toggl` 或 `clockify` 跟踪实际耗时,定期让 AI 拉取数据生成"估时 vs 实际"分析。<br>
- **Roadmap 视图**:Linear 自带的 Roadmap 配合 Skill 一起用,适合季度 review 时给非技术 stakeholder 演示。<br>
- **Triage 工作流**:用 Skill + Linear 的 Triage 视图,新 issue 进来后自动按规则分类,人工只在边界 case 介入。<br>
## 和传统 Jira/Asana 的对比<br>
- **Linear**:键盘流、API 友好、MCP 集成度好,适合"开发者友好"的工程团队。<br>
- **Jira**:功能复杂、配置项多,适合大型企业 + 复杂审批流。<br>
- **Asana**:跨部门协作好,但开发场景不深。<br>
- **Trello / Notion**:轻量级,适合小团队或个人。<br>
选择哪个取决于:团队规模、跨部门协作复杂度、是否需要复杂自定义工作流、API 集成需求。