Module 79 分鐘

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 四步裡,人類最後一次能介入把關的機會。

重點先讀

先讓 Claude Code explore、再 plan、確認後才動手,每一步留下版本紀錄,人工確認權才不會被跳過。

03概念模型

代理工作迴圈

可靠的代理流程會先探索,再計劃,接著行動,最後驗證並留下紀錄。

Explore

接續驗證

Plan

接續驗證

Code

接續驗證

Commit

留下紀錄

深入解析

04操作步驟

  1. 1.

    要求 Explore,不直接修改

    第一句可以要求 Claude Code 先讀取專案結構、找出相關檔案、列出風險與缺口。

  2. 2.

    要求 Plan 並等待確認

    計劃要包含要改哪些檔案、如何驗證、可能影響哪些路由與如何回退。

  3. 3.

    允許 Code 並持續驗證

    每個大變更後跑 lint、build、測試、路由預覽或截圖檢查。

  4. 4.

    Commit 前審視差異

    看變更摘要、檢查不相關檔案、確認沒有機密與學生資料,再提交或部署。

05容易誤解

迷你活動

06寫一段可驗證的 Claude Code 任務

把一個模糊需求改寫成 Explore、Plan、Code、Verify 四步。

  1. 1.寫出任務目標與不得改動的範圍。
  2. 2.列出預期驗證命令或人工檢查點。
  3. 3.要求 Claude Code 完成後回報變更檔案與剩餘風險。

互動任務

07先完成第一次安裝與啟動

照著步驟跑一次安裝、啟動與第一個 explore prompt,確認設定成功後再挑戰部署型任務。

開始第一次設定

完成檢核

我會先要求 Claude Code 讀懂專案再動手。

我能定義成功標準與驗證方式。

我知道 GitHub 與 Vercel 動作需要人工確認。