中文

在 Linear 中使用 Codex

在 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 问题单的评论线程中提及 @Codex,以关联你的 Linear 账户。

将工作委派给 Codex

你可以通过两种方式委派工作:

将问题单分配给 Codex

安装集成后,你可以像将问题单分配给团队成员一样,将其分配给 Codex。Codex 会开始工作,并将进度更新发回问题单。

在评论中提及 @Codex

你也可以在评论线程中提及 @Codex,以委派工作或提出问题。Codex 回复后,可在线程中跟进,以继续同一聊天。

Codex 开始处理问题单后,会选择要使用的环境和仓库。 若要固定使用特定仓库,请在评论中注明,例如:@Codex fix this in openai/codex

若要跟踪进度:

  • 打开问题单中的 Activity(活动),查看进度更新。
  • 打开聊天链接,查看更多详细信息。

Codex 完成后,会发布摘要和已完成聊天的链接,供你创建 PR。

Codex 如何选择环境和仓库

  • Linear 会根据问题单上下文推荐一个仓库。Codex 会选择与该建议最匹配的环境。如果请求含义不明确,则回退到你最近使用的环境。
  • 聊天基于该环境的仓库映射中列出的第一个仓库的默认分支运行。如果需要使用不同的默认仓库或更多仓库,请在 Codex 中更新仓库映射。
  • 如果没有合适的环境或仓库,Codex 会在 Linear 中回复如何解决问题的说明,之后你可以重试。

自动将问题单分配给 Codex

你可以使用分流规则自动将问题单分配给 Codex:

  1. 在 Linear 中,前往 Settings
  2. Your teams 下,选择你的团队。
  3. 在工作流设置中,打开 Triage 并将其启用。
  4. Triage rules 中创建一条规则,然后选择 Delegate > Codex(以及你希望设置的任何其他属性)。

Linear 会自动将进入分流流程的新问题单分配给 Codex。 使用分流规则时,Codex 会使用问题单创建者的账户运行聊天。

数据使用、隐私和安全

当你提及 @Codex 或将问题单分配给它时,Codex 会接收问题单内容,以理解你的请求并创建聊天。 数据处理遵循 OpenAI 的隐私政策使用条款以及其他适用的政策。 有关安全性的更多信息,请参阅 Codex 安全文档

Codex 使用的大语言模型可能会出错。请务必审查回答和差异。

提示和故障排除

  • 缺少连接:如果 Codex 无法确认你的 Linear 连接,它会在问题单中回复一个用于连接账户的链接。
  • 选择了意外的环境:在线程中回复你希望使用的环境(例如 @Codex please run this in openai/codex)。
  • 处理了错误的代码部分:在问题单中添加更多上下文,或在 @Codex 评论中给出明确指令。
  • 获取更多帮助:请参阅 OpenAI 帮助中心

连接 Linear 以执行本地工作(MCP)

如果你使用 ChatGPT 桌面应用、Codex CLI 或 IDE 扩展,并希望其在本地访问 Linear 问题单,请配置 Linear Model Context Protocol(MCP)服务器。

若要了解更多信息,请查看 Linear MCP 文档

无论使用 IDE 扩展还是 CLI,MCP 服务器的设置步骤都相同,因为二者共享同一配置。

使用 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 以登录。