AI 编程时代,7.4k 星的 my-git 把 Git 变成了一份有操作手册的治理框架

当 Codex、Claude Code 和 Cursor 们开始往你的仓库里写代码,一个最基本的问题浮出水面:谁来 review?谁来决定合并?谁来为 AI 生成的变更负责?

xirong/my-git 回答不了所有问题,但它把这些问题整理成了一份可以照着操作的手册。截至 2026 年 8 月,这个项目累计获得 7,399 颗星、2,480 个 Fork,最近一次更新在 8 月 22 日——属于活跃维护状态。

这个项目到底是什么

严格来说,my-git 不是一行代码可以 pip install工具。它是一个成体系的 Git / GitHub 实战手册,用 Markdown 写就,覆盖从 Git 入门到企业工程治理的完整路径。

项目最初是中文开发者的 Git 入门资料集合。v1.x 阶段,它解决的是”命令怎么用”的问题。随着 AI 编程工具进入日常开发,作者意识到核心需求已经变了:Git 的问题不再只是命令语法,而是心智模型、变更治理和 AI 协同。于是有了 2026 年 6 月发布的 v2.0,一次彻底重新定位。

现在的定位是:

面向现代工程团队与 AI 编程时代的 Git / GitHub 实战手册

核心内容:10 个目录覆盖了哪些真实场景

项目用目录把内容组织成学习路径,最值得关注的几个章节:

05-ai-native-development —— 这是整个项目最有差异化的部分,直面 AI 编程工具带来的新问题:如何对 AI 生成的 diff 做 review?如何把大块 AI 变更拆成逻辑清晰的 commit?如何用 worktree 让多个 AI agent 在不互相覆盖的情况下并行工作?如何为 AI agent 定义行为边界和权限?

04-github-engineering —— 分支保护、Rulesets、CODEOWNERS、CI 配置、发布流程。这部分对技术负责人最有价值,因为它把 GitHub 平台上那些散落在各个文档角落的治理能力串联成了可操作的决策图谱。

06-troubleshooting —— “误提交了 secret 怎么清除”、”force push 之后怎么恢复丢失的 commit”、”合并冲突处理的标准流程”。这些是真实事故中的高频问题,手册里给出了具体操作步骤,而不是泛泛的”小心点”。

02-daily-workflow03-team-collaboration —— 分别覆盖日常开发命令(rebase、stash、worktree)和团队协作模型(GitHub Flow、GitLab Flow、Trunk-Based Development、Stacked PRs)。

v2.1.0 更新了什么

2026 年 6 月 11 日发布的 v2.1.0 主打 AI Agent Governance and Conventions。这次更新新增了 AI Agent 行为规范章节,定义了:

  • 多 Agent 协作规则:当多个 AI agent 同时在同一个仓库工作时,谁的变更优先、如何避免覆盖、如何做 session 隔离
  • Stacked PR 指南:AI 编程工具一次生成的变更往往很大,手册说明了如何把它拆成多个小 PR,方便人类 reviewer 逐个理解
  • AI Agent 的 Worktree 使用方式:利用 Git worktree 为每个 AI agent 创建独立的目录实例,从文件系统层面避免并发写入冲突

v2.0.1(2026-06-07)和 v2.0.0(2026-06-03)则分别补全了开源治理规范和整体手册结构,奠定了现在这份 10 目录框架的基础。

适合谁,不适合谁

适合:

  • 技术负责人或工程团队负责人,需要给团队设计 Git 工作流和 GitHub 治理规范
  • 已经引入 Claude Code、Codex、Cursor 等工具的团队,正在面对”AI 写的代码谁来管”的问题
  • 需要系统性理解 Git 分支策略、PR 流程和 Code Review 最佳实践的开发者
  • 对”AI-native 开发”这个概念感兴趣,想找一份有具体操作的参考手册

不适合:

  • 希望找一个 CLI 工具一键解决问题的开发者——它是一本手册,不是代码库
  • Git 零基础用户——虽然有入门路径,但它的价值在于深度,不适合当第一本 Git 教程
  • 需要实时社区支持或商业 SLA 的场景——这是一个个人维护的开源文档项目

使用门槛

这个项目是纯文档形式,不需要安装依赖。唯一的前置条件是:你要对 Git 有基本的接触经验(至少用过 git addgit commitgit push),否则直接读 05 和 04 章节会有些吃力。

手册支持在线交互学习,通过动画理解 Git 的快照模型、对象图和 Index 概念——这个功能对视觉学习者比较友好。

和同类项目相比

在 Awesome 仓库列表里,my-git 被收录在”AI Assisted Development”分类下,和它并列的还有 microsoft/vscode-docsphodal/auto-dev 等项目。相比之下,my-git 的差异化在于只聚焦版本控制和协作治理,不试图做全栈 AI 开发框架——这种专注让它更像一本可以长期参考的工具书,而非一个会被版本迭代冲掉的框架。

链接汇总


如果你正在管理一个引入了 AI 编程工具的开发团队,与其去 Reddit 或 HN 翻碎片化的讨论,不如把这 10 个目录过一遍。里面的内容不一定完全适配你的场景,但至少能帮你把”AI 生成代码怎么管”这个模糊的焦虑,变成几个可以实际操作的问题。

评论区

0 条评论

登录后可评论。

器匠·开发者工具 953 阅读