CI/CD 与团队集成

25.1 Codex 在 CI/CD 中的角色

Codex 不只是本地开发工具,也可以接入 CI/CD 流水线,典型场景:

代码提交时自动优化
自动生成测试
自动更新文档
PR 提交后自动 review

25.2 codex exec 用于非交互场景

codex exec 是 CI/CD 的关键命令——非交互执行,执行完退出:

# CI 里跑测试
codex exec "跑通 pytest,失败时给出修复建议"

# CI 里生成文档
codex exec "根据 src/ 下的代码更新 README.md"

25.3 GitHub Actions 集成

在 GitHub Actions workflow 里调用 Codex:

name: Codex Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: npm install -g @openai/codex
      - run: codex exec "审查本 PR 的修改,给出改进建议"
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

⚠️ 实际集成以官方 GitHub 集成文档为准,这里给出的是示意结构。

25.4 GitHub Cloud 自动 PR Review

更推荐的方式是直接用 GitHub Cloud 集成,而不是自己写 Actions:

自动 review:每次提 PR 自动触发 Codex review
响应式 review:用 @Codex 召唤

OpenAI 官方实践:Codex reviews 100% of PRs。在 OpenAI 内部,所有 PR 都由 Codex 先 review 一遍。

25.5 团队 Onboarding 三件套

新成员加入团队时,通过三件套让 Codex 快速“懂”项目:

工具	作用
AGENTS.md	项目说明书,自动加载
Skills	团队工作流,check-in 到仓库
code_review.md	review 规则,从 AGENTS.md 引用

新成员 clone 仓库后:

Codex 自动读取 AGENTS.md,了解项目
团队 Skills 自动可用
提 PR 时按 code_review.md 规则 review

效果:新成员第一天就能产出符合团队规范的代码。

25.6 多人协作上下文一致性

团队场景的上下文一致性靠:

共享 AGENTS.md:所有成员和 Codex 用同一份规则
共享 Skills:工作流统一
共享 config.toml(项目级):.codex/config.toml check-in 到仓库
MCP 统一接入:issue/文档/监控来源一致

25.7 团队工作流示例

场景:新功能开发

1. 在 GitHub 建 issue 描述需求
2. 创建分支,本地用 Codex 开发
   - Codex 读 AGENTS.md 了解约定
   - 用 $xxx Skill 调用团队工作流
3. 提交前 /review 审查
4. 推送分支,提 PR
5. Codex 自动 review PR(基于 code_review.md)
6. 人工 review 合并
7. CI 跑测试,Codex 监控失败

场景:bug 修复

1. 在 GitHub issue 报告 bug
2. Codex Cloud 接管:读 issue,定位,生成修复 PR
3. 人工 review PR
4. 合并

25.8 复刻 OpenAI 100% PR Review 实践

OpenAI 内部所有 PR 都由 Codex review。团队想复刻:

配置 GitHub Cloud 集成
写一份 code_review.md,从 AGENTS.md 引用
开启自动 review(或用 @Codex 召唤)
逐步让 Codex review 覆盖所有 PR
收集 Codex review 误报,持续优化 code_review.md

25.9 CI 环境的 Profile

为 CI 单独建一个 Profile(见第 8 章):

model = "gpt-5.4-mini"
approval_policy = "never"
hide_agent_reasoning = true

CI 环境用:

codex --profile ci exec "..."

CI 环境特点:

approval_policy = "never"(无人值守)
用更小的模型节省成本
隐藏 agent reasoning 减少日志噪音

资料来源

OpenAI 官方 Codex best practices——GitHub 集成、100% PR review
官方 GitHub 集成文档
头条《Codex CLI 接入企业前端项目实战》——三件套结构化接入
掘金《Codex 接哪个模型效果最好》——CI Profile 配置
CSDN《Codex 完整指南(四)》——codex exec 非交互执行