前言¶

很多團隊已經把 Linear 當作日常項目管理的主戰場：Bug 在這裏流轉，Sprint 在這裏排期，Release 里程碑也在這裏對齊。但當你把同樣的問題交給 AI 編程助手——「幫我把這個 Bug 標成 In Progress 並加一條進展評論」——它往往只能寫好代碼片段，卻無法真正動你的工單系統。

OpenAI 在官方技能庫 openai/skills 裏維護了一個名爲 linear 的精選 Skill。它把「讀 Issue、建項目、更新狀態、寫評論」這類操作，整理成 Agent 可遵循的標準工作流，底層對接 Linear 官方 MCP 服務器。對工程師團隊來說，這意味着 AI 不再只是代碼編輯器裏的助手，也可以成爲項目管理鏈路裏的一環。

這是什麼¶

linear 是一個基於通用 SKILL.md 格式的 Agent Skill，由 OpenAI 維護，源碼位於 openai/skills/skills/.curated/linear。

它的定位很直接：通過 Linear MCP 服務器，用自然語言管理 Linear 中的 Issue、項目、文檔與團隊協作流程。Skill 本身的 description 寫明瞭觸發場景——當用戶需要讀取、創建或更新 Linear 中的 ticket 時使用。

與「讓模型憑記憶猜工單內容」不同，這個 Skill 要求 Agent 按固定步驟調用 MCP 工具：先讀再寫、批量操作時說明分組邏輯、完成後彙總結果並提示後續動作。前提條件是 Linear MCP 服務器已通過 OAuth 連接，且當前賬號能訪問對應 workspace、團隊和項目。

核心功能與亮點¶

1. 覆蓋 Issue 全生命週期¶

Skill 文檔列出了 Issue 相關 MCP 工具，包括：

• 查詢：list_issues、get_issue、list_my_issues、list_issue_statuses、list_issue_labels
• 寫入：create_issue、update_issue、create_issue_label

Agent 可以先拉取上下文，再按需創建或更新，避免「還沒看清現狀就亂改」。

2. 項目與團隊維度¶

除單條 Issue 外，還支持：

• 項目：list_projects、get_project、create_project、update_project
• 團隊與用戶：list_teams、get_team、list_users
• 週期：list_cycles

適合 Sprint 規劃、Release 立項、按團隊查看負載等場景。

3. 文檔與協作¶

• 文檔：list_documents、get_document、search_documentation
• 評論：list_comments、create_comment

Standup 紀要同步到 Issue、文檔缺口排查後自動開 ticket，都可以走同一套流程。

4. 內置九種實用工作流模板¶

官方 Skill 預置了可直接套用的場景，例如：

• Sprint Planning：按優先級篩選待辦，創建新 Cycle 並分配任務
• Bug Triage：列出高優先級 Bug，按影響排序並推進狀態
• Documentation Audit：搜索文檔、爲缺失或過時的章節創建 Issue
• Team Workload Balance：按負責人聚合活躍 Issue，識別過載並建議重分配
• Release Planning：創建版本項目、里程碑，並批量生成帶估時的 Issue
• Cross-Project Dependencies：查找 blocked Issue，補建關聯關係
• Automated Status Updates：爲長期未更新的 Issue 補充進展評論
• Smart Labeling：分析未打標籤的 Issue 並建議/應用標籤
• Sprint Retrospectives：彙總上一 Cycle 完成情況，生成覆盤 Issue

這些不是空泛描述，而是 Skill 要求 Agent 逐步執行的 workflow 指引。

安裝與啓用¶

使用該 Skill 分兩層：安裝 Skill 本身，以及 配置 Linear MCP 連接。兩層都就緒後，Agent 才能實際讀寫 Linear 數據。

1. 安裝 linear Skill¶

在 Codex CLI 或 IDE 擴展中，OpenAI 提供了精選 Skill 安裝器：

$skill-installer linear

也可以從 GitHub 倉庫手動複製 skills/.curated/linear/ 目錄到本地 Skill 路徑。Codex 會從以下位置掃描 Skill（含 .agents/skills 等）；安裝後若未立即生效，重啓 Codex 即可。

在 Cursor 中，可將該目錄放入項目的 .cursor/skills/ 或 .agents/skills/，通過 $linear 或 /skills 顯式調用；任務描述匹配時也可能被隱式選中。

ChatGPT 桌面端可在側邊欄 Skills 中瀏覽已安裝技能，輸入 @ 選擇 Skill 顯式調用。

2. 配置 Linear MCP（Codex）¶

Skill 文檔要求：若 MCP 調用失敗，需先完成 Linear MCP 配置。Codex 側官方步驟如下：

第一步：添加 MCP 服務器

codex mcp add linear --url https://mcp.linear.app/mcp

Linear 官方 MCP 使用 Streamable HTTP 協議，讀寫默認端點爲 https://mcp.linear.app/mcp；只讀場景可改用 https://mcp.linear.app/mcp/readonly。

第二步：啓用遠程 MCP 客戶端

首次在 Codex 中使用 MCP 時，需在 ~/.codex/config.toml 中開啓相關特性。Linear 官方文檔示例爲：

[features]
experimental_use_rmcp_client = true

Skill 文檔中也提到需設置 rmcp_client 相關配置，或通過 codex --enable rmcp_client 啓用。以你當前 Codex 版本文檔爲準；修改配置後需重啓 Codex。

第三步：OAuth 登錄

codex mcp login linear

登錄成功後重啓 Codex，再進入 Skill 工作流的 Step 1。

3. 配置 Linear MCP（Cursor）¶

Cursor 用戶可在 MCP 工具目錄 搜索 Linear 一鍵安裝，或使用 Linear 官方提供的 deeplink 完成配置。連接方式同樣是 OAuth 2.1，服務端點 https://mcp.linear.app/mcp。

4. Windows / WSL 注意事項¶

Skill 文檔提到：若在 Windows 上遇到連接錯誤，可嘗試通過 WSL 運行 MCP Remote，並使用 SSE 備用端點：

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

Linear 官方文檔說明 /sse 爲舊版客戶端的兼容路徑，新環境優先使用 /mcp。

典型用法示例¶

Skill 規定了四步主流程：澄清目標 → 選擇 workflow → 分批調用 MCP 工具 → 彙總結果。下面兩個例子來自官方資料，可直接改編使用。

示例一：Bug 分診¶

在 Codex 或 Cursor 中顯式調用 Skill 後，可以這樣描述任務：

$linear

列出我們團隊所有 Critical / High 優先級的 open Bug，
按用戶影響排序，把前 3 條推進到 In Progress，
併爲每條 Issue 寫一條說明當前處理方向的評論。

Agent 應先用 list_issues 等讀接口構建上下文，確認 Issue ID 與團隊 key，再調用 update_issue 和 create_comment。

示例二：Standup 紀要同步到 Issue¶

Linear 官方 MCP 文檔提供了類似 prompt，Skill 的「Automated Status Updates」workflow 與之對應：

$linear

以下是今天的 Standup 紀要：
[paste notes here]

請匹配提到的 Linear Issue（按 ID、標題或負責人），
爲每條高置信度匹配的 Issue 添加簡潔進展評論；
無法確定的條目單獨列出，不要猜測創建新 Issue。

示例三：Release 規劃¶

$linear

爲 v2.0 版本創建一個 Linear 項目，
里程碑包括：feature freeze、beta、docs、launch。
根據以下需求列表生成帶估時的 Issue，並分配到對應里程碑：
[paste requirements]

Agent 會依次調用 create_project、create_issue，必要時 update_project 補充里程碑信息。

適用場景與注意事項¶

適合誰用¶

• 已用 Linear 管理研發流程的工程團隊
• 希望 AI 參與工單分診、Sprint 規劃、Standup 同步的 Tech Lead / EM
• 在 Codex CLI、Cursor 或 ChatGPT 桌面端使用 Agent Skill 的開發者

使用限制¶

1. 必須先連上 Linear MCP。Skill 只是工作流說明書，真正讀寫數據靠 MCP；未 OAuth 時會停在 Step 0。
2. 寫操作有權限邊界。Agent 只能操作當前 OAuth 賬號有權訪問的 workspace；多 workspace 需分別認證。
3. 注意 API 速率限制。Skill 建議批量操作時拆分批次、複用過濾條件，避免短時間大量 list/update。
4. 複雜請求要拆步。工具調用需補全必填字段；一次塞太多變更，模型可能漏字段或觸發錯誤。
5. 認證異常時。可清除本地 MCP 認證緩存（如 rm -rf ~/.mcp-auth）後重新登錄；Windows/WSL 環境優先檢查 transport 配置。

與其他工具的關係¶

• Linear MCP：提供底層 API 能力（find / create / update Issue、Project、Comment 等）
• linear Skill：規定 Agent 何時讀、何時寫、如何分批、如何彙報，減少「亂調工具」
• 二者缺一不可：只裝 Skill 不連 MCP，Agent 有流程卻無數據通道；只連 MCP 不用 Skill，則缺少場景化 playbook

小結¶

對已經把 Linear 當作項目中樞的團隊來說，linear Skill 的價值在於：把「查工單、改狀態、寫評論、排 Sprint」從人工切換上下文，變成 Agent 可重複執行的標準流程。它不改變 Linear 本身，而是讓 AI 編程工具真正接入現有項目管理棧。

官方 Skill 倉庫：github.com/openai/skills/tree/main/skills/.curated/linear

Codex Skills 文檔：developers.openai.com/codex/skills

Linear MCP 文檔：linear.app/docs/mcp