Skip to content

本頁由 AI 根據韓語原文翻譯,可能存在錯誤。

第5章 檢查與測試——給它檢查裝置,拿回證據 ​

必讀 想跟著這個階段學下去,一定要讀這一章。

一句話總結:AI 在事情看起來做完了的時候就會停下。如果給它一個能告訴它是不是真的做完了的檢查裝置,AI 就會自己轉起"修改後再檢查"的迴圈。 並且,不要聽"全部通過了"這句話,要拿到證據(執行過的命令和它的輸出,或者畫面)。

本章依據 2026 年 11 月 1 日確認過的 Claude Code 和 GitHub 官方文件寫成。在第3階段,我們養成了把結果和原始筆記對照的習慣,到了第4階段,它被自動化,名字叫"檢查裝置"。

為什麼需要檢查裝置 ​

官方最佳實踐文件是這樣說的。Claude 在事情看起來做完了時就會停下。如果沒有東西能告訴它是不是真的做完了,"看起來做完了"就是它判斷的全部。[1] 這樣一來,最後就變成我來當測試,錯誤會一直留在那裡,直到我碰巧發現。[2]

反過來,如果給它能用透過/失敗來回答的東西,Claude 就會自己把迴圈閉合。改動、執行檢查,壞了就讀輸出、修改、再執行。[3]

沒有檢查裝置給了檢查裝置
"做完了" → 我開啟看,找出錯的地方檢查失敗 → Claude 修改 → 再檢查 → 透過

來源:本指南的整理(依據是官方文件)[3:1]

理解檢查

給它檢查裝置(以透過/失敗作答的檢查)後,會有什麼不同?

檢查裝置的種類 ​

檢查裝置可以是任何 Claude 能讀到結果的東西。官方文件舉了這些例子。[4]

  • 測試檔案:像"5 條待辦事項都顯示出來了嗎?"這樣,寫下要檢查的內容的檢查檔案
  • 構建是否成功:第4章看到的準備過程(構建)有沒有無錯誤地完成
  • 語法檢查器(linter):像程式碼拼寫檢查器一樣的工具
  • 對比輸出的指令碼:把結果和事先準備好的正確答案對照的小程式(指令碼)
  • 瀏覽器畫面:和設計稿放在一起比較的實際畫面

待辦看板是不需要構建的網頁,所以先從測試檔案和瀏覽器畫面用起就行。

如果有這樣的裝置,文件甚至說,CLAUDE.md 裡最有用的一行就是執行它的命令。[5]

最簡單的方法是寫在請求裡。不需要任何設定,今天就能用。[6]

修改待辦看板之後,請逐條檢查 SPEC.md 裡的檢查標準,一直做到全部透過為止。

在桌面應用裡,Claude 可以啟動開發伺服器(只在我電腦上把做好的網頁預先開啟看看的小程式),並在應用裡的瀏覽器視窗裡開啟,確認自己的改動。預設每次編輯後都會自動檢查。[7] 對作為網頁的待辦看板來說,這是很合適的裝置。

請它做測試時,要具體說明要檢查什麼行為。[8]

不太好的請求更好的請求
做個測試做一個測試,檢查會議紀要裡的 5 件待辦是否都顯示在螢幕上,期限是否是日期格式

來源:本指南的例子(要點來自官方文件)[8:1]

理解檢查

如果已經有檢查裝置,官方文件說 CLAUDE.md 裡最有用的一行是什麼?

拿到證據 ​

不管用什麼裝置,都要它給證據。就是執行過的命令和它的輸出,或者畫面。[9] 光是"全部通過了"這句話,幾乎得不到任何資訊,讀輸出比自己重新跑一遍更快。[9:1]

把剛才執行的檢查命令和它的輸出原樣給我看。也告訴我通過幾個、失敗幾個。

也要確認檢查是不是真的在檢查。 故意弄錯的時候不會失敗的檢查,不是裝置而是擺設。比如,刪掉一件待辦再執行,看檢查會不會失敗。

理解檢查

Claude 說「測試全都通過了」。這份指南建議怎麼應對?

每次上傳時自動檢查——GitHub Actions ​

可以讓檢查不必每次都由人來下令。GitHub Actions 是 GitHub 上自動執行構建、測試、釋出的功能。可以讓它在每次上傳改動時執行測試。[10]

在公開倉庫裡,可以免費使用 GitHub 提供的標準執行器(替你執行檢查的 GitHub 的電腦)。[11]

不需要一開始就配齊所有自動化。 一開始,只用上面的"寫在請求裡"和瀏覽器檢查就足夠了。以後想用的時候,設定檔案(寫下什麼時候執行什麼的檔案)讓 Claude 幫你做就行。

再多瞭解一點(點選展開)
  • 要做什麼,由放在倉庫 .github/workflows 資料夾裡的 YAML 檔案(設定檔案)決定。[12]
  • 經常提交、經常檢查的習慣叫做持續整合(CI)。它能幫你更早發現錯誤。[13]
  • GitHub 會把檢查結果顯示在 PR 介面裡。PR 是請求合併分支改動的提議,第6章會講。可以馬上看到我分支裡的改動有沒有引入錯誤。[13:1]

理解檢查

關於 GitHub Actions,哪種說法是對的?

親手試一試 ​

  1. 在第4章的 first-board 分支上,讓它做一個檢查 SPEC.md 裡檢查標準的裝置。
  2. 執行檢查,並要它把執行的命令和輸出原樣給你看。
  3. 故意刪掉一件待辦再執行一次,看檢查會不會失敗。確認之後再恢復。
  4. 在應用的瀏覽器視窗裡開啟待辦看板,親自數一數待辦的數量。
  5. 把檢查命令用一行寫進 CLAUDE.md。

連續任務:第6章會把到目前為止的改動以 PR 的方式提交,並接受審查。

小結 ​

  • AI 看起來做完了就會停下。給它一個用透過/失敗來回答的檢查裝置,它就會自己修改並再次檢查。
  • 檢查裝置可以是測試、構建、對比指令碼、瀏覽器畫面等任何 Claude 能讀到結果的東西。
  • 不要聽"全部通過了",而要拿到命令和輸出這樣的證據。也要看故意弄錯時檢查會不會失敗。
  • GitHub Actions 會在每次上傳時自動檢查。在公開倉庫裡,標準執行器是免費的。

術語整理 ​

術語中文名稱一句話解釋
Test測試自動檢查結果是否符合預期的檢驗
CI持續整合經常合併、經常自動檢查的習慣
GitHub ActionsGitHub Actions(自動化工作流)每次上傳時自動執行預先設定的任務的功能
YAMLYAML(配置檔案格式)用於自動任務設定的文字格式

這一章讀完了嗎?

學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。

下一章:第6章. PR 與審查

參考資料(13 則)
  1. Claude Code 官方文件,「Best practices for Claude Code」. "Claude stops when the work looks done. If it has nothing to run that tells it whether the work actually is done, "looks done" is all it has to go on." code.claude.com (確認日期 2026-11-01) ↩︎

  2. Claude Code 官方文件,「Best practices for Claude Code」. "In practice that makes you the test suite, and every mistake sits there until you happen to notice it." code.claude.com (確認日期 2026-11-01) ↩︎

  3. Claude Code 官方文件,「Best practices for Claude Code」. "If you give it something that comes back pass or fail, Claude can close that loop itself." code.claude.com (確認日期 2026-11-01) ↩︎

  4. Claude Code 官方文件,「Best practices for Claude Code」. "The check can be almost anything, as long as Claude can read the result:" / "A test file" / "A build's exit code" / "A linter" / "A script that diffs output against a fixture" code.claude.com (確認日期 2026-11-01) ↩︎

  5. Claude Code 官方文件,「Best practices for Claude Code」. "If your repo already has one of these, the single most useful line in your CLAUDE.md is the command that runs it." code.claude.com (確認日期 2026-11-01) ↩︎

  6. Claude Code 官方文件,「Best practices for Claude Code」. "In the prompt: run the auth tests after, and keep going until they pass. Claude decides for itself when it's satisfied." code.claude.com (確認日期 2026-11-01) ↩︎

  7. Claude Code 官方文件,「Desktop application」. "Claude can start a dev server and open it in the Browser pane to verify its changes." / "By default, Claude auto-verifies changes after every edit." code.claude.com (確認日期 2026-11-01) ↩︎

  8. Claude Code 官方文件,「Common workflows」. "When asking for tests, be specific about what behavior you want to verify." code.claude.com (確認日期 2026-11-01) ↩︎

  9. Claude Code 官方文件,「Best practices for Claude Code」. "Whichever option you use, ask Claude for evidence: the command it ran and its output, or the screenshot." / "reading the output is faster than rerunning the check yourself." code.claude.com (確認日期 2026-11-01) ↩︎

  10. GitHub 官方文件,「Quickstart for GitHub Actions」. "GitHub Actions is a continuous integration and continuous delivery (CI/CD) platform that allows you to automate your build, test, and deployment pipeline." / "You can create workflows that run tests whenever you push a change to your repository, or that deploy merged pull requests to production." docs.github.com (確認日期 2026-11-01) ↩︎

  11. GitHub 官方文件,「Billing and usage」. "GitHub Actions usage is free for standard GitHub-hosted runners in public repositories, and for self-hosted runners." docs.github.com (確認日期 2026-11-01) ↩︎

  12. GitHub 官方文件,「Understanding GitHub Actions」. "Workflows are defined in the .github/workflows directory in a repository." docs.github.com (確認日期 2026-11-01) ↩︎

  13. GitHub 官方文件,「Continuous integration」. "Committing code more often detects errors sooner and reduces the amount of code a developer needs to debug when finding the source of an error." / "GitHub runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error." docs.github.com (確認日期 2026-11-01) ↩︎