免費試讀課程單元 · 從零建置 Orca AI 個人助理總控(完整實作版)

從聊天到 CLI 代理

Wondering 課程《從零建置 Orca AI 個人助理總控(完整實作版)》的第 1 個課程單元

聊天介面:你得自己動手

你已經用過 ChatGPT。問它怎麼修 bug,它會回你一段文字或程式碼。

接下來呢?複製、貼上、執行,全部要你自己做。

開發者在聊天視窗與終端機之間手動搬運程式碼

注意中間那位開發者:聊天視窗和終端機彼此不相連,所有複製、貼上、執行都靠人來回搬。

跑出錯誤,你再把錯誤訊息貼回去問。聊天介面看不到你的專案,也碰不到你的終端機。

CLI 代理:在專案裡動手做事

CLI 代理是在終端機裡執行的 AI 助手,例如 Claude Code、Codex、OpenCode。

它就待在你的專案資料夾裡,能自己讀檔、改檔、跑指令。

測試失敗,它會看結果再改,一路改到測試通過。你不用在視窗之間來回搬運。

代理的工作循環
  • 讀檔: 在專案資料夾裡找出相關檔案。
  • 改檔: 直接修改程式碼。
  • 跑指令: 在終端機執行測試。
  • 看結果: 測試失敗就回頭再讀、再改。

同一個問題,兩種做法

假設你要修一個失敗的測試。

用聊天介面,你描述問題、複製答案,再自己貼上執行。

用 CLI 代理,你交代任務,它自己讀相關檔案、修改,再跑測試。兩者最大的差別在於誰動手。

誰動手?
  • 聊天介面
  • CLI 代理

你的新角色:驗收者

代理動手了,你的工作也跟著改變。你從執行者變成驗收者。

先用 git diff 看它到底改了什麼。逐行讀,確認每個改動都合理。

確認沒問題,才 git commit。有疑慮,就請代理修正,再看一次 diff。

驗收流程
  • 代理改完
  • 執行 git diff: 逐行看它改了什麼。
  • 改動合理嗎?
  • 請代理修正
  • git commit
  • 再看一次

測試通過,不代表改對

代理會一路改到測試通過。這很方便,但也藏著陷阱。

測試通過不等於改對。測試只檢查它寫到的情況。

所以就算畫面一片綠燈,你還是要看 git diff,自己判斷改動是否合理。

綠燈之後,你還要確認什麼?

動手:只看不改

找一個練習用的 git repo,在裡面啟動 CLI 代理。

請它說明專案結構,並明確交代:不要改任何檔案。

它說明完後,跑 git status 和 git diff。兩者都沒有顯示改動,才代表它真的守住了指示。

第一次練習
  • 準備 repo: 在練習用的 git repo 裡啟動 CLI 代理。
  • 下指示: 請它說明專案結構,並交代不要改檔。
  • git status: 確認沒有任何檔案被修改。
  • git diff: 確認輸出是空的,沒有改動內容。

重點回顧

從聊天到 CLI 代理,動手的人換了。

代理負責讀檔、改檔、跑指令;你負責看清楚它改了什麼,再決定要不要收下。

下次用代理時,對照下面這張表。

自我檢測

你請 Claude Code 修一個失敗的測試,它在專案裡改了檔案並重跑測試直到通過。這時你的主要角色是_____

  • 驗收者,檢查改動再決定是否收下
  • 執行者,複製代理的程式碼並貼上

答案: 驗收者,檢查改動再決定是否收下

CLI 代理會自己讀檔、改檔、跑指令,動手的人換成了代理。你從執行者變成驗收者:負責看清楚它改了什麼,再決定要不要收下。

代理改完程式後,先用 _____ 逐行檢查它改了什麼;確認每個改動都合理,才執行 _____。若想先快速確認有哪些檔案被動過,可用 _____。

答案: 代理改完程式後,先用 git diff 逐行檢查它改了什麼;確認每個改動都合理,才執行 git commit。若想先快速確認有哪些檔案被動過,可用 git status。

git diff 顯示具體改了哪些內容,適合逐行審查;git commit 是確認無誤後才收下改動;git status 列出工作目錄中有哪些檔案變動。驗收順序是先看、再決定、最後才提交。

小美習慣用 ChatGPT 修 bug,現在改用 CLI 代理處理同一個失敗的測試。下列哪一項最能描述兩種做法的關鍵差異?

  • CLI 代理會自己讀檔、改檔、跑測試,不需要她在視窗間搬運
  • CLI 代理用的模型比較聰明,所以給出的程式碼品質一定更好
  • CLI 代理只回傳文字建議,但說明比聊天介面更詳細
  • CLI 代理能看到錯誤訊息,但修改檔案仍須她手動貼上

答案: CLI 代理會自己讀檔、改檔、跑測試,不需要她在視窗間搬運

聊天介面看不到專案、碰不到終端機,所以複製、貼上、執行和回貼錯誤訊息都要你自己做。CLI 代理待在專案資料夾裡,自己讀檔、改檔、跑測試。兩者最大差別在於誰動手,而不是誰比較聰明或回答比較準。

繼續學習

這是《從零建置 Orca AI 個人助理總控(完整實作版)》共 31 個課程單元中的第 1 個。接下來:

  1. git worktree:讓多個代理平行又不互蓋
  2. Orca 是什麼、適合誰
  3. 匯入專案與 repo
  4. 開 worktree 並啟動代理
  5. 讀取、送字與等待 terminal

免費開始這門課程

Wondering 把任何主題變成可以閱讀、觀看或收聽的短課程單元,並附有練習題和 AI 家教。