免費試讀課程單元 · 從零建置 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 個。接下來:
- git worktree:讓多個代理平行又不互蓋
- Orca 是什麼、適合誰
- 匯入專案與 repo
- 開 worktree 並啟動代理
- 讀取、送字與等待 terminal
Wondering 把任何主題變成可以閱讀、觀看或收聽的短課程單元,並附有練習題和 AI 家教。