Agentic Coding
Agentic Coding 適合明確、可測試、可提交的工作。教育現場可用於互動教具、專題網站、資料整理、批次教材轉換與部署預覽。
核心問題
01如何讓 Claude Code 幫你做事,同時保留人工確認與版本紀錄?
學完本章後,你應該能做到:能把可驗證的工作交給 Claude Code 形成版本化流程,並保留人工確認。
重要概念
02先建立共通語言
Explore
Explore 是官方 Claude Code 101 課程定義的日常工作流第一步:先讀懂專案結構、既有設計、依賴關係、測試方式與潛在風險,不急著動手修改。這一步的價值在於避免代理在不理解現況的情況下「猜測式修改」,反而製造新問題。例如要修一個教學工具的畫面錯誤,第一句該是「請先讀懂這個元件的結構,列出你看到的限制,先別改任何東西」,而不是直接要求它修好。
Plan
Plan 是在動手前列出要改哪些檔案、成功標準是什麼、要怎麼驗證、可能影響哪些地方,並等待你確認。好的計劃會明確限制修改範圍,讓你在執行前就能判斷這個方向對不對,而不是事後才發現改錯方向。這一步特別重要,因為它把「人工確認」這個關鍵的把關點,安排在影響最小、最容易回頭的時間點。
Code
Code 是計劃確認後實際執行修改與命令的階段,原則是保持小步、每一步都可被驗證,而不是一次性做完一大堆改動再檢查。例如先改一個檔案就跑一次 build 確認沒壞掉,再改下一個,而不是改完十個檔案才第一次驗證——這樣出錯時才能快速定位是哪一步出的問題。
Commit
Commit 是驗證通過後提交版本、保留清楚紀錄的最後一步,但「驗證通過」不代表可以跳過人工確認——提交前仍需要人看過變更摘要,確認沒有不相關的檔案、沒有機密資訊或學生資料,且變更內容真的符合原始需求。這是 explore → plan → code → commit 四步裡,人類最後一次能介入把關的機會。
重點先讀
03概念模型
代理工作迴圈
可靠的代理流程會先探索,再計劃,接著行動,最後驗證並留下紀錄。
Explore
接續驗證
Plan
接續驗證
Code
接續驗證
Commit
留下紀錄
深入解析
04操作步驟
- 1.
要求 Explore,不直接修改
第一句可以要求 Claude Code 先讀取專案結構、找出相關檔案、列出風險與缺口。
- 2.
要求 Plan 並等待確認
計劃要包含要改哪些檔案、如何驗證、可能影響哪些路由與如何回退。
- 3.
允許 Code 並持續驗證
每個大變更後跑 lint、build、測試、路由預覽或截圖檢查。
- 4.
Commit 前審視差異
看變更摘要、檢查不相關檔案、確認沒有機密與學生資料,再提交或部署。
05容易誤解
迷你活動
06寫一段可驗證的 Claude Code 任務
把一個模糊需求改寫成 Explore、Plan、Code、Verify 四步。
- 1.寫出任務目標與不得改動的範圍。
- 2.列出預期驗證命令或人工檢查點。
- 3.要求 Claude Code 完成後回報變更檔案與剩餘風險。
完成檢核
我會先要求 Claude Code 讀懂專案再動手。
我能定義成功標準與驗證方式。
我知道 GitHub 與 Vercel 動作需要人工確認。