0%
Claude App 協作與排錯13
課堂講解+實作30 分鐘最後確認 2026-07-25

小步修改、驗證、除錯與回復

承接第 12 課已 commit 的 README 標題,故意多加入一個右括號,再完成只讀診斷、最小修正與差異歸零;全程不切 branch、不啟動 Preview、不建立新 commit。

13

學完這一課,你會做到

  • 完成一個有固定答案、可安全復原的 README 錯字練習
  • 用現況、預期、實際與 Review changes 證據請 Claude 先診斷
  • 只核准移除一個多餘括號,確認修改後差異歸零
  • 知道未提交錯誤恢復成既有 commit 時,不需要再 commit 或 push

開始前先定位

你在這裡Claude App 協作與排錯

在 Claude 桌面 App 的 Code 分頁,學會先理解、再動手、看變更、預覽與安全回復。

完成證據Checkpoint:錯誤已修好,但沒有新增版本

README 第一行恢復正確;Review changes 沒有未提交內容;GitHub 最新 commit 仍是第 12 課版本;沒有新 commit 或 push。你能說明:「這次只是把尚未 commit 的錯…

本課先不做開始條件:第 12 課必須真的完成

自己的 GitHub repo 最新 commit 必須是「練習:完成第一次 Review changes」;本機 README 第一行必須是「# 白袍 AI 排班工作坊(Review 練習)」;Review ch…

本課名詞除錯READMEReview changes最小修正差異歸零救命 Prompt

30 分鐘直接練習流程

時間學員動作完成證據
0–5 分核對正確起點,再製造一個多餘右括號只有 README.md、約 +1 -1
5–12 分描述現況、預期與實際,請 Claude 只讀診斷Claude 指出多一個「)」且尚未修改
12–20 分明確核准只移除多餘括號README 第一行恢復正確
20–26 分重新開啟 Review changes 並核對 GitHub差異歸零、最新 commit 未改變
26–30 分口頭說明為何這次不需 commit能分辨未提交修改與既有存檔點

A. 製造一個低風險、已知答案的錯字

  1. 保持 Claude App 的 Manual 權限模式,貼下方 Prompt。Claude 必須先檢查起點並等待,不可立刻修改。
  2. Claude 回報起點完全符合後,回覆「開始練習」。核准畫面只能出現 README.md 第一行。
  3. 修改後打開 Review changes:應只有 README.md,舊行是正確標題,新行則在最後多一個全形右括號。
  4. 現在不要急著叫 Claude 修,也不要 commit、push、Discard、reset 或切換 branch;先練習把問題說清楚。

第一步:建立可復原的單行錯字

可直接使用的 Prompt
這是第 13 課可復原除錯練習。請先只讀檢查:1. 目前是否沒有未提交變更;2. `README.md` 第一行是否正好是「# 白袍 AI 排班工作坊(Review 練習)」;3. 最新 commit 是否仍是第 12 課的 Review changes 練習。若任一項不符,停止並用繁體中文回報,不要修改。若全部符合,先告訴我你唯一準備修改的是 README 第一行,並等待我回覆「開始練習」。收到後,只把第一行改成「# 白袍 AI 排班工作坊(Review 練習))」——也就是刻意多一個全形右括號。不要修改其他行或檔案,不要啟動 Preview、不要 commit、不要 push。完成後停止並回報實際差異。

先自己填出錯誤報告

欄位本題答案
現況第 12 課已把正確 README 標題 commit 並 push
預期# 白袍 AI 排班工作坊(Review 練習)
實際# 白袍 AI 排班工作坊(Review 練習))
證據Review changes 只有 README.md,約 +1 -1
限制只診斷;不得改其他內容、commit、push、reset 或切 branch

第二步:只讀診斷,先不要修

可直接使用的 Prompt
我遇到一個課堂練習錯誤。現況:第 12 課的正確 README 標題已 commit。預期:第一行是「# 白袍 AI 排班工作坊(Review 練習)」。實際:第一行變成「# 白袍 AI 排班工作坊(Review 練習))」。Review changes 顯示只有 `README.md`,約 +1 -1。請先用繁體中文回報:1. 最可能原因;2. 最小修正;3. 修正後應如何驗收。現在只分析,不修改檔案、不 commit、不 push、不 Discard、不 reset、不切換 branch。

B. 核准最小修正,再確認差異歸零

  1. Claude 的診斷與上方答案一致後,才貼下方最小修正 Prompt。
  2. Manual 核准畫面只能顯示 README.md 第一行移除一個多餘的「)」;看到第二個檔案就拒絕並求助。
  3. 修正完成後重新開啟 README.md,第一行必須完全恢復為「# 白袍 AI 排班工作坊(Review 練習)」。
  4. 重新開啟 Review changes:差異統計應消失或顯示沒有未提交變更,因為檔案已回到第 12 課 commit 的內容。
  5. 回 GitHub 網頁確認最新 commit 沒有改變。本題不建立新 commit,也不 push。

第三步:只移除多餘括號

可直接使用的 Prompt
我確認診斷正確。現在只核准修正 `README.md` 第一行:移除最後多餘的一個全形右括號,讓整行完全恢復為「# 白袍 AI 排班工作坊(Review 練習)」。不要修改其他行或檔案,不要格式化整份 README,不要 commit、不要 push、不要 Discard、不要 reset、不要切換 branch。完成後請用繁體中文回報實際修改,並只讀檢查目前是否還有未提交變更。

結果不同時怎麼辦

看到的結果下一步不要做
差異已歸零完成本題,說明為何不需 commit不要為了留下紀錄又製造變更
README 仍有一行差異請 Claude 只讀逐字比較預期與實際不要重寫整份 README
出現第二個變更檔案停止,保留 Review changes 畫面並舉紅牌不要自行 Discard 或 reset
最新 commit 被改變立刻停止並請助教核對 GitHub 與本機狀態不要 force push 或重寫歷史

以後遇到真正錯誤時使用的救命 Prompt

可直接使用的 Prompt
我遇到一個錯誤。現況:[我做了什麼]。預期:[應該看到什麼]。實際:[畫面發生什麼]。完整錯誤訊息:[貼上已確認不含個資、token、cookie 或金鑰的文字]。Review changes:[檔案數與差異摘要]。已嘗試:[列出步驟]。請先分析可能原因與最小檢查順序,不要刪除檔案、不要 Discard、不要重置 Git 歷史、不要修改安全規則;等我確認後再修。

Checkpoint:錯誤已修好,但沒有新增版本

README 第一行恢復正確;Review changes 沒有未提交內容;GitHub 最新 commit 仍是第 12 課版本;沒有新 commit 或 push。你能說明:「這次只是把尚未 commit 的錯字恢復成既有版本,所以不需再建立一個存檔點。」

參考資料

介面與方案會改版;實際操作仍以各工具官方頁面為準。延伸資料用來幫助理解,不取代本課安全原則。

低壓力自我檢查

多餘括號移除後,Review changes 變成空白,最合理的理解是?

準備好再標記完成完成狀態會留在這台裝置,下次回來可接著學。