codex exec 完整指南：非交互模式、退出码与 CI 自动化

codex exec [options] "<task>"

# 最简单：仅指定任务
$ codex exec "为 src/utils.ts 中所有 public 方法添加 JSDoc 注释"

# 指定模型 + 静默模式（CI 友好）
$ codex exec --model gpt-4.1-mini --quiet \
    "根据 git log --oneline -20 输出更新 CHANGELOG.md"

# 全自动模式（CI 中推荐加上 --quiet）
$ codex exec --full-auto --quiet \
    "运行 npm test，如果有测试失败则修复 src/ 下相关文件"

# 完全不受限模式（生产环境慎用）
$ codex exec --dangerously-auto-approve-everything \
    "安装依赖、构建项目并运行端到端测试"

# 默认 suggest 模式：输出代码审查报告，不修改任何文件
$ codex exec "审查 src/ 目录下的代码，指出潜在的性能问题"

# 等价写法（明确指定）
$ codex exec --approval-mode suggest \
    "审查 src/ 目录下的代码，指出潜在的性能问题"

# auto-edit：自动修改文件，适合格式化、添加注释等任务
$ codex exec --approval-mode auto-edit \
    "将 src/ 下所有 .ts 文件的 console.log 替换为 logger.debug"

# full-auto：在沙箱内完全自动，适合大多数 CI 任务
$ codex exec --full-auto --quiet \
    "运行 npm run lint，修复所有可自动修复的 ESLint 错误"

# 等价写法
$ codex exec --approval-mode full-auto --quiet \
    "运行 npm run lint，修复所有可自动修复的 ESLint 错误"

#!/bin/bash
set -e  # 任意命令失败时立即退出脚本

# 运行任务
codex exec --full-auto --quiet "更新 CHANGELOG.md"

# 手动检查退出码
if codex exec --full-auto "运行测试并修复失败的用例"; then
  echo "任务成功，准备提交"
  git add -A && git commit -m "chore: AI 自动修复测试"
else
  EXIT_CODE=$?
  echo "任务失败，退出码: $EXIT_CODE"
  exit $EXIT_CODE
fi

name: AI Code Review & Changelog

on:
  pull_request:
    branches: [main, develop]
    paths:
      - 'src/**'
      - 'lib/**'
      - '!**/*.md'

permissions:
  contents: write
  pull-requests: write

jobs:
  ai-review:
    runs-on: ubuntu-latest
    timeout-minutes: 15

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 拉取完整历史，支持 git diff
          token: ${{ secrets.GITHUB_TOKEN }}

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'

      - name: Install project dependencies
        working-directory: .
        run: npm ci

      - name: Install Codex CLI
        run: npm install -g @openai/codex

      - name: Run AI code review
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        working-directory: .
        run: |
          codex exec \
            --model gpt-4.1-mini \
            --full-auto \
            --quiet \
            "审查本次 PR 的改动（git diff origin/main...HEAD），将代码审查报告写入 .ai-review.md，包括：潜在 bug、性能问题、安全漏洞。"

      - name: Update CHANGELOG
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        working-directory: .
        run: |
          codex exec \
            --model gpt-4.1-mini \
            --full-auto \
            --quiet \
            "根据 git diff origin/main...HEAD 在 CHANGELOG.md 顶部追加一条 Unreleased 条目，格式遵循 Keep a Changelog 规范，只修改 CHANGELOG.md 文件。"

      - name: Commit AI changes
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add .ai-review.md CHANGELOG.md
          git diff --staged --quiet || git commit -m "chore(ai): update review and changelog [skip ci]"
          git push

stages:
  - ai-review
  - deploy

variables:
  NODE_VERSION: "22"

ai-code-review:
  stage: ai-review
  image: node:22-slim
  only:
    - merge_requests
  variables:
    OPENAI_API_KEY: $OPENAI_API_KEY  # 从 GitLab CI/CD Variables 注入
  before_script:
    - npm install -g @openai/codex
    - git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME
  script:
    - |
      codex exec \
        --model gpt-4.1-mini \
        --full-auto \
        --quiet \
        "审查本次 MR 的改动（git diff origin/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME}），
        将问题列表写入 .ai-review.md，包括：代码质量、潜在 bug、安全问题。
        只修改 .ai-review.md 文件，不修改其他任何文件。"
    - |
      codex exec \
        --model gpt-4.1-mini \
        --full-auto \
        --quiet \
        "根据 git diff origin/${CI_MERGE_REQUEST_TARGET_BRANCH_NAME} 在 CHANGELOG.md
        顶部追加一条 Unreleased 条目，格式遵循 Keep a Changelog 规范。"
  after_script:
    - git config user.email "[email protected]"
    - git config user.name "GitLab CI"
    - git add .ai-review.md CHANGELOG.md
    - git diff --staged --quiet || git commit -m "chore(ai): update review and changelog [skip ci]"
    - git push "https://oauth2:${CI_JOB_TOKEN}@${CI_SERVER_HOST}/${CI_PROJECT_PATH}.git"
        "HEAD:${CI_MERGE_REQUEST_SOURCE_BRANCH_NAME}"
  timeout: 10 minutes
  interruptible: true

# 根据最近 10 个提交生成 CHANGELOG 条目并追加到文件顶部
$ codex exec --model gpt-4.1-mini --full-auto --quiet \
    "读取 git log --oneline -10 的输出，在 CHANGELOG.md 顶部追加一个 ## [Unreleased] 区块，每个提交一个条目，格式：- 类型: 描述"

# 运行 lint 并自动修复所有可修复的错误
$ codex exec --full-auto --quiet \
    "运行 npm run lint 2>&1，分析输出，修复 src/ 目录下所有可自动修复的 ESLint 错误，然后再次运行 lint 确认无误"

# 为指定文件的所有 export function 生成 JSDoc 注释
$ codex exec --approval-mode auto-edit \
    "为 src/utils/helpers.ts 中所有导出函数添加完整的 JSDoc 注释，包括 @param、@returns 和 @example，保持函数实现不变"

# 使用 timeout 命令防止无限等待（设置 5 分钟超时）
$ timeout 300 codex exec --full-auto \
    "为 src/auth/login.ts 中的每个导出函数编写 Vitest 单元测试，测试文件保存到 src/auth/__tests__/login.test.ts，覆盖正常路径和边界情况"
RESULT=$?
if [ $RESULT -eq 124 ]; then
  echo "超时！任务可能需要拆分为更小的子任务。"
fi

# 低成本任务：用 mini 模型 + quiet 模式（减少输出 token）
$ codex exec --model gpt-4.1-mini --quiet --full-auto \
    "更新 CHANGELOG.md"

# 超时保护：防止因任务卡住产生不必要的 token 消耗
$ timeout 180 codex exec --model gpt-4.1-mini --quiet \
    "分析 src/ 下最近修改的文件并输出摘要"

# 按文件路径过滤：只在关键文件变更时才运行 AI 任务
# （在 GitHub Actions YAML 中设置 paths: filter）