[!info] related notes

• 所属 MOC: Coding Agent MOC
• 并列概念: Coding Agent Code Review
• 关系笔记: Agent 工程纪律

Coding Agent GitHub 集成

一句话定义

GitHub 集成是 coding agent 接入 Git 工作流的方式，核心能力包括在 PR comment 中 tag agent 触发 review 或修复、自动 PR review、CI 失败诊断、以及通过 GitHub Actions 在 CI/CD 中运行 agent。

为什么需要 GitHub 集成

代码的生命周期不只是写——还有 review、合并、部署、维护。GitHub 集成让 AI 参与整个工程工作流：

• PR 提交后自动 review
• CI 失败时自动诊断
• Issue 描述直接变成实现任务
• Review comment 触发代码修复

各产品的实现

Codex GitHub 集成

• PR comment 触发：在 PR 评论里 tag @codex 触发任务
• @codex review → 让 Codex 审查 PR
• @codex fix the CI failures → 启动 Cloud task 修复
• 自动 PR review：可配置 Codex 自动 review 每个 PR
• GitHub Action：openai/codex-action@v1 在 CI/CD job 里运行 Codex
• 支持应用 patch、发布 review

Claude Code GitHub 集成

• PR comment 触发：在 PR 评论里 tag @claude 触发任务
• @claude review → 审查 PR，把发现作为 inline comments
• @claude implement this feature → 根据 Issue 描述实现功能
• @claude fix the TypeError → 修复特定问题
• GitHub Action：anthropics/claude-code-action@v1
• /review 命令：在 CLI 里审查 GitHub PR
• /autofix-pr：云端监听 PR，修 CI 或 review comment
• 多 agent 分析整个代码库上下文

共同模式

模式	触发方式	行为
PR Review	@codex review / @claude review	审查 PR，输出 inline comments
CI 修复	@codex fix CI / @claude fix CI	读日志、定位、提交 patch
Feature 实现	Issue 中 tag agent	根据描述实现功能
自动 Review	配置 webhook	每个 PR 自动触发

推荐用法

PR 前 Review

@claude review
Focus on race conditions, stale cache, duplicate source of truth, and frontend/backend contract mismatch.

CI 失败修复

@codex fix the CI failures
要求先定位失败测试，再最小改动修复。

自动化 Review

配置 GitHub Action，每个 PR 自动跑一次 AI review。

安全注意

• 不要把 API key 写进仓库，必须用 GitHub Secrets
• 先用于只读 review / 报告更稳，不要一上来让 agent 自动改代码
• 审查 agent 的 PR 修改再合并

最短记忆方式

GitHub 集成 = 在 PR comment 中 tag agent 触发 review/修复，通过 GitHub Action 接入 CI/CD。

Related notes

• Coding Agent MOC
• Coding Agent Code Review
• Agent 工程纪律