BaseHalf
全部文章

用 BaseHalf 和 AI 入门 Git 分支

把本地 BaseHalf 画布当成 Git 学习地图（提交、分支、合并与变基笔记加上练习都是卡片），再让 Claude Code 或 Codex 根据你连上的文件讲解和出题。

我们想要一条短一点的 Git 分支入门路径，不要从聊天粘贴或随手开的教程标签页开始。目标很窄：能在分支上提交、干净地切换分支，以及完成合并（或理解 rebase 到足以避免盲目改写已共享的历史）。不是「成为 Git 维护者」。

BaseHalf 已经有这些零件。普通文件夹打开就是画布，卡片就是文件，连线会把纯文本 upstream 写进目标文件。右侧 Agent Area 里开着 Claude Code 或 Codex，读你指给它们看的东西。我们把这套当成 Git 分支的学习地图来用，而不是某个新的「学习模式」。

BaseHalf 里打开的项目文件夹：相连的笔记卡片，右侧 Agent Area 中是 Claude Code。

文件夹就是大纲

建一个文件夹，用 BaseHalf 打开，结构故意保持无聊：

git-branching/
  00-goal.md
  concepts/
    commits-and-pointers.md
    create-and-switch.md
    merge-fast-forward.md
    rebase-vs-merge.md
  practice-repo/
    README.md
  exercises/
    01-branch-and-commit.md
    02-switch-cleanly.md
    03-merge-or-rebase.md
  sources.md

00-goal.md 用一段话写清边界：这条路径结束时「完成」长什么样。sources.md 放你要对照核验的链接，从 Pro Git 起，尤其是 Branches in a Nutshell、Basic Branching and Merging 和 Rebasing。命令手册也留着：git branch、git switch、git merge、git rebase。这个文件夹里以 Pro Git / git-scm.com 为准。

在画布上把每道练习连到对应概念笔记和 sources.md。Git 看得到这些 upstream 列表，下一次 Agent 会话也看得到。

对着连上的文件提问

选中一张概念卡或一道练习，先看状态栏确认「这个」指什么，再在 Agent Area 里问。提示词绑在文件上，不要空喊「教我 Git」：

  • 「根据这道练习的 upstream 笔记，解释分支指针和 HEAD 的差别。针对 practice-repo/ 给一组错的、一组对的 git branch / git switch 步骤。」
  • 「只用 merge-fast-forward.md 和 sources.md 里的 Basic Branching and Merging 章节，考我快进合并和三方合并。等我答完再公布你的答案。」
  • 「我把步骤写在 exercises/03-merge-or-rebase.md 里了。对照 upstream 概念笔记里的 rebase vs merge 规则检查，标出会改写共享远端上已有提交的建议。」

Agent 读你连上的文件，比记住三轮前你打的字更靠谱。关系写在文件里，下一会话开头就还在。

练习和验收标准

练习你应能做到验收
建分支并提交创建主题分支、在其上提交，且 main/master 不变git log --oneline --decorate --graph --all 只在主题分支上看到新 tip
干净切换在干净工作区（或明确 stash 计划）下切换分支切换前 git status 干净；git switch 后文件与分支 tip 一致
合并或变基合并主题分支，或只对本地未发布提交做 rebase合并得到预期 tip；rebase 从不改写别人可能已有的提交

在 practice-repo/ 下的一次性克隆（或另建一个练习仓库）里跑每道练习。把命令输出贴回练习笔记。让 Agent 对照验收那一行，不要中途让它编造不存在的参数。

AI 常踩的坑

把模型输出当草稿。我们反复看到的失误：

  • 对已经在共享远端上的提交做 rebase 再强推（Pro Git 的规则：不要 rebase 公开历史）
  • 把 merge 和 rebase 混为一谈，或不说明你想要什么样的历史
  • 编造参数（git branch --magic、不存在的 switch 选项），而不是去读 sources.md 里的文档
  • 工作区还脏着就建议 git checkout / git switch，再含糊带过冲突

当 Agent 和上面的 Pro Git 章节冲突时，文档说了算。改概念笔记，而不是改文档。

这不是什么

这条路径不是可视化思考的元文章，BaseHalf 也不会替你自动生成知识图谱。你只是把普通的 Markdown 文件摆在画布上，连线让 upstream 进 Git，再让 Claude Code 或 Codex 根据这些文件讲解和出题。还是同一个桌面产品：文件夹当画布，连线写进文件，Agent 在右侧。

快速入门降低摩擦，并不承诺几分钟就精通。当 00-goal.md 和三道练习都能在不依赖 Agent「给最终答案」的情况下通过验收，这条路径就结束了。下一个领域用同样的办法：另一个文件夹，另一张地图，还是那些读你连线的 Agent。