linear

linear 技能概覽

linear 技能可透過 Linear MCP server 讓你直接操作 Linear，讓 agent 能夠讀取、建立與更新 issues，而不必猜測 workspace 結構或工作流程慣例。它特別適合需要 linear 做 Issue Tracking、分流（triage）、專案協調，或維持團隊工作與即時 issue 狀態一致的人。

這個 linear 技能適合做什麼

當任務依賴準確的 Linear 資料時，就該使用這個 linear 技能：例如找出正確的 issue、更新狀態、補充脈絡、指派負責人，或查看專案進度。和一般提示詞相比，當你需要 agent 在真實的 Linear workspace 裡操作，而不是只產出一份獨立建議時，它會更合適。

誰應該安裝它

如果你已經用 Linear 做 issue tracking，並希望 agent 協助處理營運性工作，就安裝 linear：例如分流佇列、ticket 整理、專案追蹤，或跨團隊協調。對重視工作流程正確性，而不只是產文案的人來說，它很合適。

主要判斷因素

關鍵依賴是存取權：這個技能需要已連接的 Linear MCP server 與 OAuth 登入。如果你的 workspace、teams 或 projects 有權限限制，在確認權限前，導入可能會卡住。它最大的價值，是能穩定、具脈絡地使用 Linear；最大的風險，則是尚未完成 MCP 設定就先假設技能已經能動作。

如何使用 linear 技能

安裝並連接 Linear MCP

要安裝 linear，請先加入技能並連接 MCP server，再期待它有實際成果：

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

如果登入成功，請先重新啟動 Codex，再繼續後續操作。若在 Windows 上遇到連線問題，改用以 WSL 為基礎的 MCP 傳輸路徑，可能會更快建立可用環境。

給這個技能正確的任務形狀

好的 linear 使用方式，從具體動作開始，而不是模糊目標。輸入內容最好直接寫出對象與要改成什麼樣子，例如：「找出登入失敗的 bug report，把它移到 In Progress，並整理阻礙項目」，或「建立一則 Linear issue，內容是 onboarding 文件，包含 owner、priority 與 acceptance criteria。」不要只下「整理 Linear」這類提示，除非你同時也指定範圍、team，以及你要的輸出結果。

先讀這些檔案

先從 SKILL.md 開始，再查看 agents/openai.yaml，了解預設意圖與 MCP 依賴。若需要知道重用脈絡，也可查看 LICENSE.txt；至於資產檔，只有在你需要品牌素材時才需要看。最重要的操作細節在 SKILL.md 規定的工作流程，尤其是設定與澄清步驟。

能提升成效的工作流程建議

當你希望模型直接在 Linear 裡執行時，請提供 workspace、team、project，以及這次請求是只讀還是會修改資料。若需要更新 issue，請明確寫出你要變更的欄位，並附上 priority、due date、assignee 等限制條件。如果 MCP 連線尚未就緒，技能應該先停下來，協助你完成設定，再繼續往下做。

linear 技能 FAQ

linear 只適合做 issue tracking 嗎？

不是。linear 用於 Issue Tracking 是最常見的情境，但這個技能同樣適合專案更新、團隊協調，以及 Linear 內與文件相連的工作流程任務。只要事實來源在 Linear，而且輸出需要反映即時的 workspace 狀態，就很適合用它。

linear 技能和一般提示詞有什麼差別？

一般提示詞只能描述應該發生什麼事；linear 技能則是設計來連到實際的 Linear workspace 去執行。當你需要真實的 issue ID、最新狀態、權限，或可靠的更新結果，而不只是文字版計畫時，這個差別就很重要。

這個技能適合新手嗎？

可以，前提是你能清楚說出任務，而且你本來就有 Linear 存取權。如果你還在猶豫該改哪個 team、project 或 issue，這個技能就沒那麼適合新手，因為最好的 linear 指令輸入本來就需要具體。

什麼情況下不該使用它？

如果你只是需要一個通用的專案管理範本、你的 Linear workspace 尚未連線，或任務不該放在 issue tracker 裡，就不要用 linear。當你只需要發想，而不需要任何即時的 Linear 動作時，它也不是合適選擇。

如何改進 linear 技能

提供更完整的 Linear 脈絡

最強的 linear 指令輸入，會包含 workspace、team、project、issue 標題或連結，以及要執行的確切操作。如果你希望分流結果更準，請補上症狀、優先度線索，以及任何相關 issue 參照，讓 agent 能更快消除歧義。

明確說出你要的最終狀態

與其問「幫我處理這個 issue」，不如直接說明這則 Linear issue 在任務完成後應該長什麼樣子：狀態要改掉、owner 要設定、描述要改寫、要補上 acceptance criteria，或要合併重複項目。清楚的最終狀態指示可以減少來回確認，讓 Linear 使用更可預測。

注意設定與權限失敗

最常見的失敗，不是提示詞本身，而是缺少 MCP 存取權或 workspace 權限不足。如果技能無法連線，先修好 Linear MCP 設定；如果可以連線但無法執行動作，請先確認相關 team 與 project 的權限，再重新嘗試。

先試一次，再用更精準的提示詞迭代

如果第一次結果太廣泛，就把範圍縮小成一次只處理一個 issue、一個 team 或一個 project。若是重複性工作，建議沿用穩定的提示詞格式，把任務類型、範圍與成功標準都寫進去，這樣 linear 技能就能產出更一致的更新，後續也比較少需要人工修改。