Skip to content

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

第1章 和 AI 一起做出东西——一眼看懂 SDLC ​

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

一句话总结:软件要经过计划 → 制作 → 评审 → 确认 → 发布 → 运营,才会走向世界。这个流程叫作 SDLC。 AI 可以成为每个步骤里的双手,但决定做什么、确认结果,是人的事。第4阶段就是学习这种分工。

这一章是根据 2026 年 11 月 1 日确认的 GitHub 官方文档和 Claude Code 官方文档写的。这是为在第3阶段用 Claude Code·Codex·Antigravity 操作过文件夹的读者准备的阶段。如果还没有看第3阶段,请先看第3阶段 · Claude Code。

什么是 SDLC ​

SDLC(软件开发生命周期,Software Development Life Cycle)指的是项目从最初的想法,到真正运转起来的软件所经历的步骤。[1] GitHub 把这个过程分成六个步骤。

步骤做什么这本指南
计划(Plan)写下要做的事并跟踪第3章
制作(Create)写代码并记录改动第4章
评审(Review)提出改动并收集意见第6章
确认(Test)合并之前自动检查第5章
发布(Deploy)发布出去让人们使用第7章
运营(Operate)盯着它并持续改进第 8·9 章

出处:GitHub 官方文档(这本指南的整理)[2]

表里的章节顺序有一点不同。这本指南把确认(第5章)放在评审(第6章)前面讲。这是为了在评审时能一并看到确认的结果。[3]

不需要从一开始就用到所有步骤。 GitHub 也说,很多人是从一个仓库和几个待办事项开始,随着项目成长再逐步扩展。[4] 这本指南也是用一个小网页,把六个步骤走一圈。

理解检查

关于 GitHub 所说的 SDLC,哪种说法是对的?

AI 是怎么工作的 ​

Claude Code 分三个阶段处理交给它的事。收集上下文 → 采取行动 → 确认结果。[5] 查找并阅读文件、修改、运行测试来确认自己的工作,这些都包含在这个循环里。

在第3阶段用过的计划模式,在这里又变得重要了。在计划模式下,Claude 读取文件后只给出计划,在我批准之前什么也不修改。[6]

官方最佳实践文档列出了事情没有按预期进行的典型原因。[7]

  • 做出来的和我脑子里想的不一样。 因为缺少只读仓库无法获知的信息。→ 在第3章「策划与规格说明」里讲。
  • 说做完了,其实没做完。 因为它没有办法自己确认。→ 在第5章「确认与测试」里讲。

这两种情况,只要由人提供信息和确认装置,就能减少。所以第4阶段学的不是写代码的方法,而是给 AI 什么、要回什么来确认。

理解检查

官方文档指出,AI 说做完了其实没做完,常见原因是什么?

人负责的事 ​

即使 AI 来当双手,也有一些事必须由人负责。

步骤人负责的事
计划决定做什么、为什么做
制作阅读计划并批准
确认看证据(命令和输出)后做出判断
评审决定合不合并
发布判断能不能公开,并按下按钮

出处:这本指南的整理(依据在各章的脚注里)

官方文档也写明,对提议的代码和命令是否安全,在批准之前进行检查的责任在用户。[8] 另外,像发布这类会影响外部系统的行为,不能用 Claude Code 的回退(检查点)撤销。[9] 检查点是每次发送请求时自动留下的保存点。就像游戏里的存档点一样,Claude 改过的我电脑里的文件,大多可以退回到那个时间点(shell 命令或其他会话改过的文件除外)。但已经在网上公开的东西是退不回来的。所以越是会影响到外部的行为,越要由人来确认并按下按钮。

理解检查

在和 AI 一起制作时,这份指南指出必须由人来承担的事是什么?

这个阶段要做出什么 ​

第4阶段的「亲自试一试」,是用一个贯穿各章的例子来做。就是把第3阶段整理工具做出的会议记录里的待办事项汇总展示出来的网页,名字叫「街角咖啡馆待办看板」。

GitHub 的官方入门系列也是一路跟着做出一个小网站,计划、写代码、评审改动,然后发布成真正的网站。[10] 这本指南遵循同样的顺序,只是把 AI 的位置换成第3阶段熟悉了的 Claude Code。

表里会出现几个陌生的词。现在只要大概知道意思就行。到了相应的章节会一步步讲。

  • GitHub:把项目文件和改动记录放到网上、一起协作的服务
  • 仓库(Repository):存放项目文件和改动记录的地方。是项目的家
  • PR(Pull Request,拉取请求):递出"请把我改的东西合并进去"的改动提议
  • GitHub Pages:把仓库里的文件免费发布成网页的功能
章在待办看板上做的事
2在 GitHub 上创建仓库
3接受采访,决定要展示什么,写出 SPEC.md
4拿到计划,在分支上做出第一个界面
5做一个确认装置,检查待办数量对不对
6创建 PR 并接受评审
7用 GitHub Pages 公开
8把下一步改进写成议题,再走一圈
9公开前检查密钥和个人信息

出处:这本指南的计划

不需要一开始就完美。 一章一章跟着做,到最后就会有一个带互联网地址的我自己的网页。

整理 ​

  • SDLC 是从想法到真正运转起来的软件的步骤。GitHub 把它分为计划·制作·评审·确认·发布·运营六个步骤。
  • 不需要从一开始就全用。小处着手,逐步扩展。
  • Claude Code 按收集上下文 → 行动 → 确认结果的方式工作。失败的常见原因是缺少信息和缺少确认装置。
  • 决定做什么、看证据做判断、决定合并和发布,是人的事。

术语整理 ​

术语中文名称一句话解释
SDLC软件开发生命周期软件从想法到运营所经历的步骤
Repository仓库存放项目文件和改动记录的地方
Deploy发布(部署)把做好的东西发布出去让人们使用
Plan mode计划模式修改之前只展示计划的 Claude Code 工作方式

这一章读完了吗?

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

下一章:第2章. 创建 GitHub 仓库

参考资料(10 条)
  1. GitHub 官方文档,《What is GitHub?》。"The software development life cycle describes the stages a software project moves through, from the first idea to running code in production." docs.github.com (确认日期 2026-11-01) ↩︎

  2. GitHub 官方文档,《What is GitHub?》。"Track your work, set milestones, and organize long-term projects." / "Write and store code, develop new features safely, and create a clear timeline of your changes." / "Suggest changes to your project, discuss your updates with reviewers, and apply feedback." / "Automate checks to validate every change before it merges." / "Ship software with automated deployment workflows and release management." / "Monitor applications, manage dependencies, and find and fix security issues." docs.github.com (确认日期 2026-11-01) ↩︎

  3. 「运营」在 GitHub 里的含义很宽,包括监控、依赖管理、安全。这本指南只讲到用议题(issue)来改进(第8章)和安全(第9章)。 ↩︎

  4. GitHub 官方文档,《What is GitHub?》。"You do not need to use every stage at once. Many people start with a repository and a few issues, then expand their use of the platform as their project grows." docs.github.com (确认日期 2026-11-01) ↩︎

  5. Claude Code 官方文档,《How Claude Code works》。"When you give Claude a task, it works through three phases: gather context, take action, and verify results." code.claude.com (确认日期 2026-11-01) ↩︎

  6. 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) ↩︎

  7. Claude Code 官方文档,《Best practices for Claude Code》。"It's missing information it can't get from reading the repo." / "Claude said it was done and it wasn't quite, usually because it had no way to check its own work." code.claude.com (确认日期 2026-11-01) ↩︎

  8. Claude Code 官方文档,《Security》。"You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (确认日期 2026-11-01) ↩︎

  9. Claude Code 官方文档,《How Claude Code works》。"Actions that affect remote systems (databases, APIs, deployments) can't be checkpointed." code.claude.com (确认日期 2026-11-01) ↩︎

  10. GitHub 官方文档,《Creating a repository for your project on GitHub》。"By the end of the journey, you'll plan work, write code, review changes, and deploy your code to a live website." docs.github.com (确认日期 2026-11-01) ↩︎