Claude App 與 GitHub 網頁：建立可回去的存檔點
先把 README 的第一行標題改成「白袍 AI 排班工作坊（Review 練習）」，製造只有一個檔案、預期 +1 -1 的安全差異；再操作 Review changes、commit、push 與 GitHub 網頁驗收。
12
學完這一課，你會做到
- 完成一個只修改 README 標題的安全練習，不必先啟動網站 Preview
- 從差異統計或 Views → Diff 開啟 Review changes，逐檔逐行檢查
- 只在通過驗收後，單獨授權 Claude 建立一個小型 commit
- 再次確認後才單獨授權 push，並在 GitHub 網頁核對存檔點
開始前先定位
你在這裡課堂啟動與版本準備
先認識 Claude Code 介面並安裝 Node.js，再理解資料夾與 GitHub，最後把自己的 repo 帶進 Claude App，完成第一次 Review changes。
完成證據Checkpoint：你真的完成了一次 Review changes
Review changes 只有 README.md，差異只有第一行舊標題與新標題；README 檔案內容正確；commit 與 push 分兩次核准；自己的 GitHub 網頁顯示正確 commit、檔案與新標…
本課先不做Review code 不是你親自 Review changes 的替代品
差異檢視右上角若有 Review code，它會請 Claude 評估目前差異並留下註解；這可以當第二意見，但不能取代你逐檔逐行核對，也不代表可以直接 commit。
本課名詞Review changesDiffManualREADMEcommitpush
牙科工作台的比喻
正在修改的檔案像工作台上的器械；Review changes 是盤點並查看剛才動了哪裡，commit 是拍照封存並貼上標籤，push 則是把已封存的版本送到自己的 GitHub 雲端專案。
四個不能跳過的關卡
| 關卡 | 白話 | 通過條件 |
|---|---|---|
| Review changes | 查看每個檔案修改前後的差異 | 只含本次任務，沒有個資與秘密 |
| 檔案驗收 | 親自核對 README 標題 | 新標題完整，其他內容沒有改變 |
| 核准 commit | 建立有名稱的本機存檔點 | Claude 先說明範圍與訊息，你再單獨同意 |
| 核准 push | 把該 commit 送到 GitHub | commit 已完成且再次核對後，另一次單獨同意 |
這次只允許一個小修改
| 項目 | 本課固定內容 | 若看到不同內容 |
|---|---|---|
| 檔案 | README.md | 先拒絕或停止，不要 commit |
| 位置 | 第一行 Markdown 標題 | 請 Claude 恢復其他段落 |
| 新文字 | # 白袍 AI 排班工作坊（Review 練習） | 不要加入姓名、email 或真實診所資訊 |
| 預期差異 | 通常是 +1 -1，只有一個檔案 | 多檔案或大量行數都要先查原因 |
| 這次不做 | 程式碼、Firebase、SQLite、套件、Preview、commit、push | 任何一項出現都超出範圍 |
A. 切到 Manual，再建立可審查的單行差異
- 確認 Claude App 上方開啟的是自己的 wca-ai-clinic-schedule-workshop repo；先看 GitHub 網頁目前最新 commit，確定起點正確。
- 在輸入框旁的權限模式選單選 Manual。官方建議新手從 Manual 開始，因為編輯檔案前會先詢問，可以接受或拒絕每項變更。
- 貼上下方 Prompt。Claude 應先只說明要改的檔案與一行內容；此時畫面不該已有新修改。
- 說明完全符合表格後，回覆「開始修改」。出現檔案編輯核准畫面時，確認只有 README.md 的第一行標題，再接受這項修改。
- 若 Claude 想改第二個檔案、安裝套件或改 README 其他段落，選拒絕／停止，並回覆：「這不在本次任務，請恢復額外變更，只保留 README 第一行標題。」
第一步：只改 README 第一行標題
這是第 12 課 Review changes 練習。請只修改 repo 根目錄 `README.md` 的第一行 Markdown 標題，把它改為「# 白袍 AI 排班工作坊（Review 練習）」。不要修改 README 其他段落、任何程式碼、Firebase、SQLite、package.json 或其他檔案；不要安裝套件、不要啟動 Preview、不要 commit、不要 push。修改前先用繁體中文告訴我唯一預計修改的檔案與一行內容，等我回覆「開始修改」後才執行。完成後停止，列出實際修改檔案，不要建立其他變更。
Claude 修改檔案後會出現差異統計，例如 +1 -1。點擊統計可開啟差異檢視；較舊版本可能顯示 Review changes。也可從 Views → Diff 開啟。
- 左側檔案清單這次只能有 README.md。
- 右側紅色／減號是被移除的舊行，綠色／加號是準備留下的新行。
- 差異檢查不等於 commit；尚未核對完整 README 標題前不要建立存檔點。
B. 實際操作 Review changes／差異檢視
- Claude 完成修改後，找到會話中的差異統計，例如 +1 -1，點擊它。較舊版本若顯示 Review changes，就點該按鈕。
- 若找不到按鈕，從 Claude App 的 Views 選單選 Diff；快捷鍵為 macOS 的 Cmd+Shift+D、Windows 的 Ctrl+Shift+D。
- 在左側檔案清單確認只有 README.md；點選它後，在右側找到第一行 Markdown 標題。
- 確認被移除的舊行是原本 README 標題；新增行必須完整顯示「# 白袍 AI 排班工作坊（Review 練習）」。
- 從差異最上方看到最下方，確認沒有真實姓名、email、密碼、驗證碼、PAT、token、金鑰、Firebase config 或其他變更。
- 若某行不正確，可直接點該行加入註解，輸入修正要求後按 Enter；有多則註解時，macOS 用 Cmd+Enter、Windows 用 Ctrl+Enter 一次送給 Claude 修正，再重新 Review。
這張 diff 應該怎麼讀
| 畫面區域 | 這次應看到 | 通過判斷 |
|---|---|---|
| 差異統計 | +1 -1 左右 | 一行舊字串換成一行新字串 |
| 左側檔案清單 | 只有 README.md | 沒有 package.json、程式碼或陌生檔案 |
| 移除行（紅色／-） | 原本的 README 標題 | 只有第一行被取代，其他段落沒有刪除 |
| 新增行（綠色／+） | # 白袍 AI 排班工作坊（Review 練習） | 井字號、空格、括號與文字完整 |
第二步：請 Claude 解釋差異，不再修改
請只閱讀目前未提交的差異，不要修改任何檔案、不要 commit、不要 push。請用繁體中文回報：1. 總共有幾個變更檔案；2. 每個檔案的路徑；3. 被移除與新增的內容各是什麼；4. 是否只有 `README.md` 第一行改成「# 白袍 AI 排班工作坊（Review 練習）」；5. 是否發現個資、秘密或超出任務的變更。若不是只有這一項，請先指出問題但不要自行修正。C. 核對 README 後，才準備 commit
- 在差異檢視或 Files 窗格打開 README.md，確認第一行是「# 白袍 AI 排班工作坊（Review 練習）」，下方其他段落仍在。這一步不需要啟動網站 Preview。
- 回 Review changes 再看一次，確認仍只有 README.md 的一行取代。
- 貼下方 commit 前檢查 Prompt。Claude 這一步只能提出檔案清單與 commit 訊息，不能直接 commit。
- 若回報只有 README.md，且 Review changes 與檔案驗收都通過，再貼『核准 commit』Prompt。
第三步：commit 前只回報，不執行
我已完成 Review changes 與 README 檔案驗收。請先不要修改、不要 commit、不要 push，只用繁體中文回報：1. 目前未提交的檔案；2. 本次變更摘要；3. 建議的 commit 訊息。預期只能有 `README.md`，內容只能是第一行 Markdown 標題改成「# 白袍 AI 排班工作坊（Review 練習）」；若不同請停止並指出。第四步：只核准 commit，仍不要 push
我已確認 Review changes、README 標題、檔案範圍與 commit 訊息都正確。現在只核准把 `README.md` 的這一項已驗收變更建立 commit，commit 訊息使用「練習：完成第一次 Review changes」。不要修改其他檔案、不要 push。完成後請用繁體中文回報 commit 摘要與目前是否還有未提交變更。第五步：再次核對後，才單獨核准 push
我已確認上一個 commit 是本課預期的 README 單行標題變更，且目前沒有其他未提交內容。現在只核准把目前分支 push 到我自己的 GitHub repository。執行前先核對 remote Owner 是我的 GitHub username、不是 dentallio；不要修改檔案、不要建立新 commit、不要切換分支，也不要要求或讀取密碼、一次性驗證碼、PAT、token 或 cookie。完成後只回報 push 的分支與結果。
push 完成後，以 GitHub 網頁作最後核對：Owner／repo、分支、最新 commit 與檔案必須全部一致。
- 先核對 Owner／repo，避免看錯專案。
- 分支必須是課程指定的主分支。
- 最新 commit 應顯示「練習：完成第一次 Review changes」，且只修改 README.md；repo 首頁標題也應同步更新。
Checkpoint：你真的完成了一次 Review changes
Review changes 只有 README.md，差異只有第一行舊標題與新標題；README 檔案內容正確；commit 與 push 分兩次核准；自己的 GitHub 網頁顯示正確 commit、檔案與新標題。任何一項不符都先不要往下。
參考資料
介面與方案會改版；實際操作仍以各工具官方頁面為準。延伸資料用來幫助理解，不取代本課安全原則。
低壓力自我檢查
Claude 完成修改後，畫面出現 +1 -1，最正確的下一步是？
準備好再標記完成完成狀態會留在這台裝置，下次回來可接著學。