第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 工作方式 |
這一章讀完了嗎?
學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。
參考資料(10 則)
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) ↩︎
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) ↩︎
「運營」在 GitHub 裡的含義很寬,包括監控、依賴管理、安全。這本指南只講到用議題(issue)來改進(第8章)和安全(第9章)。 ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
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) ↩︎
Claude Code 官方文件,《Security》。"You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (確認日期 2026-11-01) ↩︎
Claude Code 官方文件,《How Claude Code works》。"Actions that affect remote systems (databases, APIs, deployments) can't be checkpointed." code.claude.com (確認日期 2026-11-01) ↩︎
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) ↩︎