codex-git

Codex Git Integration 是一个面向 Codex CLI 的 Git 感知开发工作流技能，用于把常见的 Git 操作交由 Codex 自动执行。文档最后更新标注为 2025 年 12 月（GPT-5.2 发布）。

用途

该技能的核心目标是在 Codex CLI 中提供 Git 感知的开发流程。Codex 会识别 Git 上下文：遵守 .gitignore、理解提交历史、避免不必要地修改已提交文件、生成干净且原子的提交，并理解分支上下文。适用于需要自动化提交、PR、分支与历史管理的开发场景。

主要能力

应用变更：Codex 生成的 diff 可作为 git patch 应用。使用 codex apply（简写 codex a）应用变更，可用 git diff 查看 Codex 提议的改动，用 git add -p 选择性暂存，用 git checkout . 回退。
智能提交生成：Codex 分析改动并生成有意义的提交，可分组相关改动、撰写清晰的提交信息、遵循 conventional commits 格式，并为不同关注点创建独立提交。支持指定 Angular 等提交规范。
PR 自动化：可审查所有提交、生成 PR 标题与描述、列出改动并通过 gh CLI 创建 PR；也支持从创建功能分支到推送并创建带详细描述的 PR 的完整流程。
分支管理：创建并工作在分支、智能合并分支并解决冲突、清理已合并分支。
Git 历史分析：分析最近提交、识别常见改动模式与高活跃区域、查找相关改动、识别潜在破坏性变更，可输出 JSON。
冲突解决：自动分析冲突、理解双方改动意图、在保留双方功能的前提下解决冲突，并运行测试、创建合并提交。
Git Hooks：生成 pre-commit 钩子（运行 linter、类型检查、快速测试，失败则阻止提交）与 commit-msg 钩子（强制 conventional commits 格式）。
Changelog 生成：从 git 历史生成 CHANGELOG.md，按版本/标签分组，分类 Features、Fixes、Breaking Changes，链接提交与 PR，并按 Keep a Changelog 格式化；也可生成发布说明。
高级工作流：自动化发布流程、git bisect 自动化排查引入问题的提交、子模块更新。
CI/CD 集成：提供 GitHub Actions 示例，用于在 PR 上运行 Codex PR 分析并回帖评论，以及校验提交信息格式。
Git 安全模式：自动化前用 git stash 备份、dry-run 生成 diff 到文件并用 git apply --check 检查后再应用、长任务中创建检查点提交。

使用方式

主要通过 Codex CLI 命令调用。典型命令如下：

# 应用 Codex 变更
codex apply
codex a

# 生成智能提交
codex exec --dangerously-bypass-approvals-and-sandbox \
  "Review all changes and create meaningful git commits"

# 自动化 PR 流程
codex exec --dangerously-bypass-approvals-and-sandbox \
  "Create feature branch, implement auth, commit, and create PR"

文档还给出多个 bash 函数示例，如 develop_feature、respond_to_pr_feedback、create_hotfix、safe_codex_automation、checkpoint_refactoring、automate_release 等，用于封装完整工作流。

配置方面，可在 ~/.codex/config.toml 中设置默认模型（如 gpt-5.1-codex-max、gpt-5.2）、是否尊重 .gitignore、是否自动提交、提交信息风格、是否要求干净工作区、是否创建备份 stash，并可定义 git-auto、git-large-repo 等 profile。

适用场景

适合需要把提交、分支、PR、变更日志与历史分析纳入 AI 自动化流程的开发者与团队，尤其在功能开发、热修复、代码审查反馈处理、发布流程与 CI 集成等环节。也可用于长周期重构（检查点提交）、合并冲突处理与历史清理。

限制与注意事项

文档中的大量命令使用 --dangerously-bypass-approvals-and-sandbox 与 --full-auto 等参数，意味着绕过审批与沙箱，属于高风险自动化方式。文档建议采用安全做法：自动化前用 git stash 备份、在分支上工作、用 codex apply 在审查后应用、频繁设置检查点。文档也列出常见问题的处理方式，包括未提交改动（先 stash 再 pop）、合并冲突、提交信息不佳（重写历史）、丢失改动（用 git reflog 恢复）。关于该技能的收费、价格、平台支持范围等事实，资料暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制与注意事项

相关技能