auto-git：为AI智能体设计的Git工作流自动化工具

auto-git是一套专为AI智能体与Git仓库交互设计的Codex技能套件，旨在解决AI生成代码在版本控制中的挑战（如变更意图不清晰、提交信息混乱等）。核心功能包括基于意图的提交、安全暂存管理、多工作树协调、PR交接及历史重写等。

原作者/维护者：async，来源平台：GitHub，发布时间：2026-06-14，项目链接：https://github.com/async/auto-git

随着AI编程助手和智能体的兴起，开发者依赖AI协助代码编写，但AI生成的代码变更面临版本控制挑战：变更意图不清晰、提交信息混乱、大型改动难拆分、多分支协调困难等。传统Git工作流未针对AI协作场景优化。

auto-git应运而生，它不是简单的Git包装器，而是完整技能套件，让AI智能体以结构化方式理解代码变更意图，生成清晰可追溯的Git历史。

auto-git包含三个主要技能模块：

1. auto-git（核心技能）：支持本地审查模式（单会话场景，按意图提交）和协调分支模式（多会话/协作场景，用隔离分支和工作树，通过ledger.json维护元数据）。

2. git-intent-audit（意图审计）：只读工具，分析脏工作树问题（如意图不清晰、超大提交、混合提交等），为历史重写提供证据。

3. git-history-rewrite（历史重写）：基于审计证据重新播放本地历史，保留原始作者信息，默认不强制推送。

auto-git以'意图驱动'为核心设计理念，定义了完整的提交类型体系：

类型前缀	用途说明
feat:	新增功能或能力
fix:	修复错误行为
security:	安全漏洞修复或加固
perf:	性能优化
refactor:	内部重构，行为不变
test:	仅测试代码变更
docs:	仅文档变更
style:	仅格式变更
deps:	仅依赖更新
build:	构建/打包系统变更
ci:	CI工作流变更
migrate:	数据库/模式/数据迁移
release:	版本/变更日志/发布元数据
revert:	撤销之前的提交
chore:	不属于以上类别的维护工作

规范要求优先选择最具体的意图前缀，仅在无法归类时使用chore:，使Git历史自解释、便于审查和分析。

auto-git内置多层安全保护：

安全门：全自动模式下，以下情况触发暂停等待用户确认：检测到敏感信息、破坏性清理操作、验证失败、强制推送、远程标签移动、缺失发布元数据。

大型差异拆分：智能分析变更关联性，将大量未暂存变更拆分为多个逻辑独立的提交，避免巨型提交。

无关编辑保护：自动检测并防止不相关变更被意外打包到同一提交。

协调分支模式实现复杂多工作流管理：

1. 租约管理：每个工作分支对应租约记录，防止多会话同时修改同一分支。
2. 账本追踪：ledger.json记录所有活跃和已完成的工作状态。
3. PR交接：完成的分支可安全推送到远程并创建PR，ledger记录交接状态。
4. 主干保护：默认不自动合并PR，合并与明确的land意图绑定。
5. 清理保证：工作完成后自动切换回主干分支，保持环境整洁。

应用场景：

• AI辅助编程：帮助Codex、Cursor等AI工具理解变更意图，生成规范提交历史。
• 大型重构项目：分阶段、按模块提交，利用意图分类和差异拆分能力。
• 多特性并行开发：隔离不同工作流，避免干扰。
• 代码审查优化：PR前优化提交历史，便于审查者理解逻辑。

Codex集成：

• 技能定义位于skills/auto-git/目录。
• 通过pnpm run gists:package生成可安装的gist包。
• 提供auto-git CLI工具，支持快照、门禁检查、发布预检等操作。

auto-git代表AI辅助开发工具的重要方向：让AI以可协作、可审查、可追踪的方式参与软件开发全流程。

核心贡献：

1. 结构化意图：将模糊需求转化为明确的变更类型和范围。
2. 安全边界：平衡自动化与人工审查。
3. 历史可维护性：生成对人类友好的Git历史，便于长期维护。

对于探索AI辅助开发的团队，auto-git提供了值得参考的实践范式。