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