企业官网建设流程全解析

CodexGuide × GitHub Actions：CI失败自动修复实测

【免费下载链接】CodexGuideCodexGuide：面向全球初学者、创作者、开发者与团队的 Codex 实践指南项目地址: https://gitcode.com/gh_mirrors/co/CodexGuide

CI失败是开发日常中常见的问题，但传统处理流程往往繁琐且耗时。CodexGuide与GitHub Actions的结合，实现了CI失败后的自动读取日志、定位问题、修复代码并生成PR的全流程自动化，大幅提升开发效率。本文将通过实测案例，详细介绍这一强大功能的实现过程和使用方法。

传统CI失败处理方式的痛点

传统的CI失败处理流程通常包括：接收失败通知→查看CI日志→本地复现问题→修改代码→提交推送→等待CI重新运行→创建PR→人工审查合并。整个过程依赖人工操作，若遇到复杂错误或跨时区协作，可能导致问题拖延数小时甚至数天。

实测案例：购物车折扣计算bug

本次实测使用一个包含购物车总价计算功能的项目，核心逻辑是"满100减20"。在折扣函数中故意植入一个bug：将减号误写为加号，导致原价120元的商品折后价变为140元。

// 错误的代码 if (total >= 100) { return total + 20; // 应该是减号 }

CI失败日志分析

代码提交后，GitHub Actions自动运行测试，约1分钟后显示失败。从工作流失败列表中可以清晰看到具体的失败任务：

点击进入详情页面，测试日志明确指出错误原因：期望结果为100，实际得到140，直接定位到折扣计算问题：

自动修复工作流配置

实现Codex自动修复的关键是配置GitHub Actions工作流文件。以下是完整配置：

name: Codex Auto-Fix on Failure on: workflow_run: workflows: ["CI"] types: [completed] permissions: contents: write pull-requests: write jobs: auto-fix: if: ${{ github.event.workflow_run.conclusion == 'failure' }} runs-on: ubuntu-latest env: OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }} FAILED_WORKFLOW_NAME: ${{ github.event.workflow_run.name }} FAILED_RUN_URL: ${{ github.event.workflow_run.html_url }} FAILED_HEAD_BRANCH: ${{ github.event.workflow_run.head_branch }} FAILED_HEAD_SHA: ${{ github.event.workflow_run.head_sha }} steps: - name: Checkout Failing Ref uses: actions/checkout@v4 with: ref: ${{ env.FAILED_HEAD_SHA }} fetch-depth: 0 - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: '20' - name: Install dependencies run: npm install - name: Run Codex uses: openai/codex-action@main with: openai-api-key: ${{ secrets.OPENAI_API_KEY }} prompt: "这是一个 Node.js 项目，使用 Jest 做测试。请读取仓库代码，运行测试套件，找到导致测试失败的最小改动范围，修复它，然后停止。不要修改与失败无关的代码。" sandbox: workspace-write - name: Verify tests pass run: npm test --silent - name: Create Pull Request if: success() uses: peter-evans/create-pull-request@v6 with: commit-message: "fix: Codex 自动修复失败的测试" branch: codex/auto-fix-${{ github.event.workflow_run.run_id }} base: ${{ env.FAILED_HEAD_BRANCH }} title: "🤖 Codex 自动修复 CI 失败" body: | Codex 检测到 CI 失败，自动生成了这个修复 PR。 失败的工作流：${{ env.FAILED_WORKFLOW_NAME }} 失败记录链接：${{ env.FAILED_RUN_URL }} 请检查改动内容，确认无误后合并。

配置中的关键部分包括：

• 触发条件：仅在"CI"工作流失败时触发
• 环境变量：记录失败工作流的关键信息用于追溯
• 代码检出：拉取失败提交的代码以确保修复准确性
• Codex执行：使用官方action，通过中文prompt明确修复要求
• 验证与PR：修复后先验证测试通过，再自动创建PR

Codex自动修复过程

CI失败后，配置好的工作流自动触发，Codex执行以下操作：读取仓库代码→运行测试套件→定位问题→修改代码。整个过程约1分钟完成：

常见问题与解决方案

PR权限配置

实测中遇到的第一个问题是PR创建失败，错误信息为"GitHub Actions is not permitted to create or approve pull requests"。这需要在仓库设置中手动开启Actions创建PR的权限：

API费用管理

Codex API按token使用量计费，调试阶段的失败尝试也会产生费用。建议在OpenAI后台设置月度消费上限，正常情况下一次成功修复的成本约为$0.05–$0.10。

自动修复结果验证

工作流执行成功后，GitHub仓库会出现一个自动生成的PR：

查看PR内容，可以看到Codex精准地只修改了错误的那个字符：

确认无误后，只需点击合并即可完成整个修复流程。

总结

CodexGuide与GitHub Actions的集成，实现了CI失败的全自动修复，显著减少了开发人员处理此类问题的时间成本。通过本文介绍的配置方法，开发者可以快速搭建这一自动化流程。建议在使用过程中注意：

1. 确保GitHub仓库已开启Actions创建PR的权限
2. 合理设置OpenAI API的费用上限
3. 根据项目特点调整Codex的prompt指令

更多详细内容可参考项目文档：docs/recipes/13-github-actions-ci-fix.md。通过这一强大功能，开发团队可以将更多精力集中在创造性工作上，而非重复性的问题修复。

【免费下载链接】CodexGuideCodexGuide：面向全球初学者、创作者、开发者与团队的 Codex 实践指南项目地址: https://gitcode.com/gh_mirrors/co/CodexGuide