繁體中文

在 Linear 中使用 Codex

從 Linear 問題執行 Codex 任務

你可以在 Linear 中把問題裡的工作委派給 Codex。將問題分配給 Codex,或在評論中提及 @Codex,Codex 就會建立雲端聊天並回復進度和結果。

Linear 中的 Codex 適用於付費套餐(請參閱定價)。

如果你使用 Enterprise 套餐,請讓 ChatGPT 工作區管理員在工作區設定中啟用 Codex 雲端聊天,並在連接器設定中啟用 Codex for Linear

設定 Linear 整合

  1. Codex 中連線 GitHub,併為要交給 Codex 處理的儲存庫建立一個環境,以設定 Codex 雲端聊天
  2. 前往 Codex 設定,為工作區安裝 Codex for Linear
  3. 在 Linear 問題的評論 thread 中提及 @Codex,以關聯你的 Linear 賬號。

將工作委派給 Codex

你可以通過兩種方式委派工作:

將問題分配給 Codex

安裝整合後,你可以像分配給隊友一樣把問題分配給 Codex。Codex 會開始處理,並把進度更新發布回該問題。

將 Codex 分配給 Linear 問題(淺色模式)

在評論中提及 @Codex

你也可以在評論 thread 中提及 @Codex,以委派工作或提出問題。Codex 回覆後,繼續在同一個 thread 中跟進即可延續該聊天。

在 Linear 問題評論中提及 Codex(淺色模式)

Codex 開始處理問題後,會選擇一個環境和儲存庫來執行工作。 要固定特定的儲存庫,請將其包含在你的評論中,例如:@Codex fix this in openai/codex

跟蹤進度:

  • 開啟該問題的 Activity(活動),檢視進度更新。
  • 開啟聊天連結以瞭解更多詳細資訊。

Codex 完成後,它會發布摘要和已完成聊天的連結,以便你可以建立 pull request。

Codex 如何選擇環境和儲存庫

  • Linear 會根據問題上下文建議儲存庫。Codex 選擇最匹配該建議的環境;如果請求不明確,則回退到你最近使用的環境。
  • 聊天會在該環境儲存庫對映中第一個儲存庫的預設分支上執行。如需不同的預設儲存庫或更多儲存庫,請在 Codex 中更新儲存庫對映。
  • 如果沒有合適的環境或儲存庫可用,Codex 將在 Linear 中回覆,並說明如何在重試之前解決問題。

自動將問題分配給 Codex

你可以使用 Triage rules(分診規則)自動將問題分配給 Codex:

  1. 在 Linear 中前往 Settings(設定)
  2. Your teams(你的團隊) 下選擇團隊。
  3. 在工作流程設定中開啟 Triage(分診),並將其啟用。
  4. Triage rules(分診規則) 中建立規則,選擇 Delegate(委派) > Codex,並按需設定其他屬性。

Linear 自動將進入分類的新問題分配給 Codex。 當你使用分類規則時,Codex 使用問題建立者的帳戶執行聊天。

將所有問題分配給 Codex 並標記為“Triage”狀態的範例分診規則(淺色模式)

資料使用、隱私和安全

當你提及 @Codex 或把問題分配給它時,Codex 會接收問題內容,以理解你的請求並建立聊天。 資料處理遵循 OpenAI 的隱私政策使用條款和其他適用的政策。 有關安全性的更多資訊,請參閱 Codex 安全文件

Codex 使用的大型語言模型可能會出錯。請始終審查答案和 diff。

提示和故障排除

  • 缺少連線:如果 Codex 無法確認你的 Linear 連線,它會在問題中回覆一個連線你帳戶的連結。
  • 意外的環境選擇:在 thread 中回覆你想要的環境(例如 @Codex please run this in openai/codex)。
  • 程式碼的錯誤部分:在問題中新增更多上下文,或在 @Codex 評論中給出明確的說明。
  • 更多幫助:請參閱 OpenAI 幫助中心

連線 Linear 以進行本機工作(MCP)

如果你使用 ChatGPT 桌面應用、Codex CLI 或 IDE 擴充套件,並希望它在本機存取 Linear 問題,請設定 Linear MCP server。

要了解更多資訊,檢視 Linear MCP 文件

無論使用 IDE 擴充套件還是 CLI,MCP server 的設定步驟都相同,因為二者共享同一份設定。

使用 CLI(推薦)

如果你安裝了 CLI,請執行:

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

這會提示你使用 Linear 帳戶登入並將其連線到 Codex。

手動設定

  1. 在編輯器中開啟 ~/.codex/config.toml
  2. 新增以下內容:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. 執行 codex mcp login linear 登入。