Skip to content

Git Workflow 解决的是 AI 改动太快、工作区失控的问题。它把 commit 当成保存点,把 branch 当成沙盒,让每次改动都小、清楚、可 review、可回退。

AI 改完代码怎么整理提交:Git Workflow 怎么用

下载 git-workflow-and-versioning 中文版 Skill ZIP

AI 一次能改很多文件。

这很爽,也很危险。

如果没有 Git 纪律,半小时后你可能看到一个巨大的 diff:功能、重构、格式化、测试、文案全混在一起。

git-workflow-and-versioning 这个技能的核心是:用版本管理给 AI 的速度加护栏。

commit 是保存点

每完成一个可验证小步骤,就应该有一个保存点。

节奏可以是:

text
实现一个小切片

验证通过

提交

继续下一步

这样后面出问题时,你最多回退一小段,不会丢掉整天工作。

原子提交比大提交更重要

一个提交只做一件事。

好的提交像这样:

  • feat: add api key input to settings page
  • test: cover api key validation errors
  • fix: preserve pagination when filtering users
  • docs: add skill library programming index

不好的提交像这样:

  • update files
  • fix stuff
  • add feature and refactor

AI 很容易把多个意图混在一个 diff 里。提交前要让它说明:哪些文件为什么变了,哪些改动属于同一件事。

不要把重构和功能混在一起

功能改动和重构改动要尽量分开。

因为 review 的关注点不同。

功能改动要看需求是否满足。重构改动要看行为是否保持。混在一起时,review 很难判断某个变化是业务需要,还是顺手整理。

如果 AI 先写功能,又发现需要重构,可以让它停下来:

md
这次先只完成需求。
如果确实需要重构,请单独列出原因和范围,不要混进当前改动。

分支和 worktree 是隔离工具

多 Agent 或多任务并行时,分支和 worktree 很有用。

一个任务一个分支,互不干扰。试验失败,丢掉这个分支或 worktree,不影响主线。

但不要为了形式制造很多长期分支。分支放得越久,合并风险越大。

小步、短分支、快合并,比长期大分支更适合 AI 编程。

给 AI 的 Git Prompt

md
请先查看当前 git 状态。
整理本次改动时遵守:
1. 不要把无关文件放进同一个提交。
2. 功能、测试、文档、重构尽量分开。
3. 提交消息说明为什么改。
4. 不要使用破坏性 git 操作,除非我明确同意。

Git 是安全网,不是清理战场的橡皮擦。

你可能还需要

同类技能:

AI 写得越快,越要让 Git 记录每一步为什么发生。