Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第4章 动手做——先要计划,再建分支、提交 ​

必读 想跟着这个阶段学下去,一定要读这一章。

一句话总结:开一个新会话,把 SPEC.md 交给它,用计划模式先拿到计划。批准之后,在叫分支的独立空间里动手做,每做一个小改动就用提交记一笔。 在分支里做、记录、经过评审后合并,这个流程叫作 GitHub flow。它不只适合开发者,是一套对谁都有用的轻量工作流程。

本章依据 2026年11月1日确认的 Claude Code、GitHub 官方文档写成。计划模式和提交,你在 Claude Code 第4、5章里已经用过。本章把它们和分支串起来,整理成「安全地做东西的流程」。

先拿到计划 ​

SPEC.md 有了之后,开一个新会话,切换到计划模式。在桌面应用里,像 Claude Code 第5章那样,把输入框下面的模式切换成「计划(계획)」。在计划模式下,Claude 会读文件、只给出计划,在我批准之前不会改任何东西。[1]

读一下 SPEC.md,按这份说明书制定一个做待办看板的计划。先不要创建文件。

拿到计划后,请这样问一问。

  • SPEC.md 的每一行,分别对应计划里的哪一步?
  • 每一步的大小,是一次就能确认完的吗?
  • 里面有没有我不认识的新工具,或需要安装的东西?

不满意的话,批准之前就让它改。在计划阶段修改,成本最低。

理解检查

关于计划模式,哪种说法是对的?

在分支上动手做 ​

分支让你在独立的空间里做出新功能。在准备好之前,基本版本(main)不会变。[2] 就算搞砸了,main 也安然无恙,所以你可以放心地尝试。

GitHub 的入门教程把做东西的过程概括为:建立工作空间 → 修改并保存 → 提出来请人审阅,所用的工具就是分支、提交、PR。[3] PR(Pull Request,拉取请求)是递出"请把分支里改的东西合并到 main"的提议。第6章会亲手做一个。

分支名要起得简短,并且看得出意思。[4] 如果做的是待办看板的第一个页面,叫 first-board 就够了。

创建 first-board 分支,按已批准的计划做出第一个页面。不需要构建,只用最外层文件夹里的一个 index.html 就能打开。

请求里提到的构建(build),是把写好的代码转换成浏览器能读的文件的准备过程。"不需要构建"的意思是,不经过这样的过程,用浏览器直接打开文件就能看到。

只用一个 index.html 来做,是因为第7章的 GitHub Pages 会在要发布的文件夹最外层寻找 index.html。

理解检查

使用分支的理由,哪项是对的?

小步提交 ​

提交把改动像拍照一样存下那一刻的样子,推送则把这张照片送到 GitHub 仓库。[5]

一个提交最好只装一个独立且完整的改动。这样,想换一种做法时,只回退那一部分就行了。[6] 互不相关的改动,也要分别建分支。[6:1]

不太好的提交更好的提交
把一天的工作一次提交,写成"工作""增加读取待办表"、"给过期待办标上颜色"

出处:本指南的示例(原则来自 GitHub 官方文档)[6:2]

就像你在第3阶段学到的,在交给它做之前和之后都留下记录,这个习惯在这里同样适用。

理解检查

GitHub 建议的提交方式是什么?

阅读 AI 做出来的东西 ​

AI 做出来的结果,要读过之后再接受。GitHub 的教程也说,要先检查 AI 生成的内容,再按示例修改。[7]

在 Claude Code 桌面应用里,你可以在查看改动内容(diff)中按文件检查改动。点击行旁边的 + 写下意见,Claude 会读到并修改。[8]

不用把代码全部看懂也没关系。请这样问。

对刚才改过的每个文件,用一行说明改了什么、为什么改。再告诉我它对应 SPEC.md 的哪一行。

如果有的改动说不出和 SPEC.md 的关联,它可能做了你没要求的事。请追问那一部分。

理解检查

AI 写的代码没能全部看懂时,这份指南建议怎么做?

亲自动手试试 ​

  1. 在待办看板文件夹里开一个新会话,切换到计划模式。
  2. 发送上面的计划请求,用三个问题检查计划,然后批准。
  3. 让它在 first-board 分支上做出第一个页面。待办数据用第3阶段会议记录里的待办表。
  4. 用查看改动内容的功能确认文件,并请它解释改动。
  5. 让它按小单位提交。
  6. 请 Claude "把 first-board 分支上传(推送)到 GitHub"。在 GitHub 仓库页面里能看到这个分支就行。第一次上传时如果弹出登录窗口,像第2章那样照着提示做。如果出现失败的提示,就把那条提示原样给 Claude 看,问它哪里出了问题。

连续任务:第5章要做一个装置,让 Claude 自己确认"待办事项有没有一个遗漏地显示出来?"

小结 ​

  • 开新会话,交上 SPEC.md,用计划模式先拿到计划。修改在计划阶段成本最低。
  • 分支是不碰 main 的工作空间。名字要简短、看得出意思。
  • 一个提交只装一个完整的改动。不相关的改动要分开建分支。
  • AI 做出来的东西,读过再接受。每个改动都要问它对应 SPEC.md 的哪一行。

术语解释 ​

术语中文名称一句话解释
Branch分支不动基本版本、单独工作的一条岔路
Commit提交像拍照一样记录下改动
Push推送把我的记录送到 GitHub 仓库
GitHub flowGitHub 工作流分支 → 修改 → PR → 审阅 → 合并的工作流程

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第5章. 检查与测试

参考资料(8 条)
  1. Claude Code 官方文档,「Common workflows」。"For changes you want to review before they touch disk, switch to plan mode. Claude reads files and proposes a plan but makes no edits until you approve." code.claude.com (确认日期 2026-11-01) ↩︎

  2. GitHub 官方文档,「Writing and storing your code」。"A branch lets you work on your feature in its own space, without changing the main copy of your code until you're ready." docs.github.com (确认日期 2026-11-01) ↩︎

  3. GitHub 官方文档,「Writing and storing your code」。"Along the way, you'll follow the core developer workflow—setting up a space for your work, making and saving your changes, and proposing them for review—using branches, commits, and a pull request." docs.github.com (确认日期 2026-11-01) ↩︎

  4. GitHub 官方文档,「GitHub flow」。"A short, descriptive branch name enables your collaborators to see ongoing work at a glance." docs.github.com (确认日期 2026-11-01) ↩︎

  5. GitHub 官方文档,「Writing and storing your code」。"Committing saves a snapshot of your changes, and pushing sends them to GitHub where they will be stored in your repository." docs.github.com (确认日期 2026-11-01) ↩︎

  6. GitHub 官方文档,「GitHub flow」。"Ideally, each commit contains an isolated, complete change. This makes it easy to revert your changes if you decide to take a different approach." / "Make a separate branch for each set of unrelated changes." docs.github.com (确认日期 2026-11-01) ↩︎

  7. GitHub 官方文档,「Writing and storing your code」。"Review what Copilot generates, then adjust the files to match the examples below." docs.github.com (确认日期 2026-11-01) ↩︎

  8. Claude Code 官方文档,「Desktop application」。"After Claude makes changes to your code, the diff view lets you review modifications file by file before creating a pull request." / "Claude reads your comments and makes the requested changes, which appear as a new diff you can review." code.claude.com (确认日期 2026-11-01) ↩︎