Codex可自动响应GitHub事件实现PR审查、Issue转任务、Wiki同步。需先配置Actions权限与OIDC令牌,再分别设置PR审查、Issue处理和Wiki同步工作流,严格匹配Schema与技能定义。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让Codex自动响应GitHub代码提交、PR审查、Issue同步和文档更新,省去手动触发和上下文重建的重复操作,直接在Git事件发生时启动AI分析与执行。
启用Codex GitHub Actions集成
在项目仓库中启用GitHub Actions是联动的前提,否则所有工作流都无法触发。
进入仓库 Settings → Actions → General → “Workflow permissions”,勾选 【Allow GitHub Actions to create and approve pull requests】 并将“Read and write permissions”设为允许;若使用自定义OIDC令牌,还需在 Secrets and variables → Actions 中添加 CODER_TOKEN(由 codex login --oidc 生成)。
这一步漏掉会导致后续所有 job 报错 “Permission denied: cannot create PR”,且错误日志不提示具体缺失权限项。
配置PR自动审查工作流
每次有人提PR,Codex自动扫描变更文件并输出结构化问题报告,无需人工干预。
第一步:在 .github/workflows/ 目录下新建 codex-pr-review.yml 文件。
第二步:粘贴以下内容(注意替换 YOUR_PROJECT_TYPE 为 node/python/go 等实际类型):
name: Codex PR Review
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Codex
run: |
curl -fsSL https://gitcode.com/GitHub_Trending/codex31/codex/releases/latest/download/codex-x86_64-unknown-linux-musl.tar.gz -o codex.tar.gz
tar -xzf codex.tar.gz
chmod +x codex
- name: Run Review
run: ./codex exec "审查本次PR:聚焦${{ github.event.pull_request.title }}涉及的逻辑变更,按YOUR_PROJECT_TYPE规范检查空指针、资源泄漏、API兼容性" --full-auto --output-schema .github/codex-schema.json
第三步:在仓库根目录创建 .github/codex-schema.json,严格匹配 Codex v2.4.1+ 的 JSON Schema 格式要求,否则 --output-schema 会静默失效。
实现Issue到Codex任务自动转化
当团队成员在GitHub Issue中写「帮我加个导出Excel功能」,Codex能自动解析需求、生成函数草稿、附上测试用例,并提交为 draft PR。
方法一:使用官方 Linear+Codex 桥接技能(需先启用Linear集成)
前往 Codex 设置页面 → Add Integration → Linear → 输入 API key;然后在 Linear 中为对应 Project 启用 Codex Sync,Issue 描述含「#codex」标签即触发任务提取。
方法二:纯GitHub原生方案(推荐)
在 .github/workflows/issue-to-task.yml 中配置 on: issues: types: [opened] → 使用 actions/github-script@v7 提取 issue.body → 调用 codex exec "将以下需求转为可运行的Python函数:${{ github.event.issue.body }}" --skill python-export-gen。
【必须确保 .codex/skills/python-export-gen/SKILL.md 中定义了 input_schema 字段,否则 codex exec 会跳过该技能】
同步Codex本地笔记到GitHub Wiki
Codex里写的API设计文档、部署 checklist、故障排查流程,实时推送到项目Wiki,保持知识源唯一。
执行 codex wiki sync --target github --repo owner/repo --token ${{ secrets.GITHUB_TOKEN }}。
该命令会扫描 .codex/wiki/ 下所有 .md 文件,按目录结构映射为 Wiki 页面路径;首次运行前需手动在 GitHub Wiki 页面点击「Create first page」初始化仓库。
注意:若 Wiki 已存在同名页面,此命令默认覆盖,不可逆。
















