iT邦幫忙

2026 iThome 鐵人賽

DAY 7
0

Day 7 封面:四個不同顏色的終端機視窗,匯流到同一個發光節點

前面六天講的都是設計。今天講手指頭實際要敲什麼。

我這邊是 Windows,組長跑在 Claude Code 上,另外四位是四個獨立的命令列工具。要讓它們動起來,就是從專案資料夾裡把它們叫起來、餵一段指令、等它回話。

聽起來很簡單,實際上每一個都有自己的怪脾氣。

一、要讓它自動讀到規矩

其中三個工具有一個好性質:在專案資料夾裡喚它,它會自己去讀 AGENTS.md,開機就知道自己是誰、該遵守什麼,不用每次重貼規矩。

立霧(Codex)是例外——他會連 repo 裡其他檔案一起翻,翻著翻著就跑題。我們的解法是乾脆關掉他的自動載入(下面那個 project_doc_max_bytes=0),把必要的規矩直接寫進工單。同一個目的,兩種到達方式。

所以第一條規矩是:一律從專案根目錄喚;用 Codex 就記得規矩要自己帶。

二、中文指令要用管線餵

這是 Windows 上最容易踩的一類。每個工具炸的點不一樣:有的走 PowerShell 管線時中文會被編碼層絞碎,收到的那端看到滿螢幕問號,然後很認真地照著亂碼做事;有的是長指令裡一出現 # 或引號,參數解析直接爆掉。

正解是別把中文直接貼在指令後面當參數:先存成 UTF-8 檔案,再用管線灌進去,內容原封不動送達,不經過命令列那層會絞碎它的轉換。

四個工具的實際喚法長這樣。這一盒是給要抄的人的,不打算抄可以整盒跳過:每行 # 開頭的註解就是人話版,旗標的來歷後面用故事講:

# 立霧(Codex):關掉專案文件自動載入(含 AGENTS.md),規矩直接寫進 prompt
cat prompt.txt | codex exec --ignore-user-config -c project_doc_max_bytes=0 \
  -s read-only -C "<repo路徑>" -

# 秀姑巒(Antigravity):廣搜要拉長逾時、跳過權限確認,成品叫他寫檔
agy -p "<任務>…成品寫到 workspace/outbox/<檔名>.md" \
  --print-timeout 15m --dangerously-skip-permissions

# 木瓜溪(OpenCode):從 repo 目錄跑,他才讀得到 AGENTS.md
opencode run -m opencode/<模型> "<任務>"

# 美崙溪(Grok):多步驟工具活必加自動核准,否則卡在權限確認
grok -p "<任務>" --always-approve --max-turns 8 --cwd "D:/path/to/repo"

一個很陰的細節:最後那條的 --cwd 在 Bash 裡要用正斜線。反斜線會被吃掉,D:\Ted_data 變成 D:Ted_data,然後它回你一句「Failed to set working directory」。

公平講,這個雷實測只在其中兩個工具上炸過,另外兩個的中文處理是乾淨的。但我後來索性統一:所有超過一行的指令,不管派給誰,都寫成檔案再餵,不直接打在命令列上。統一之後不用記「誰有雷誰沒有」,順便指令也留下來了,下次改一改能再用。

三、每一個的旗標地雷

要連續對話的那位:一次性問答跟連續追問要走不同的入口。走一次性的入口很乾淨、回傳直接,但沒有跨呼叫記憶;要接續前一輪就得走另一條,並用專門的續接指令。搞錯的話,你以為它記得,其實它什麼都不記得。

負責廣搜的那位:預設的輸出等待時間只有五分鐘,而廣搜這種活本來就慢。時間到了它會被切斷,你看到的是空白,會誤以為它死了。長活要把等待時間拉長,而且不要盯著看,讓它非同步跑。

便宜大批次的那位:指令一長就會出事,超過大約兩千位元組,它會把所有檔案都讀完,然後不給你結論。解法是一題一問、分段餵。我實測過同一份工作,拆成四次呼叫,四題全部答對而且數字精確。一次丟整包,什麼都拿不到。

負責即時消息的那位:多步驟的工具活一定要加上自動核准的旗標,否則它會卡在權限確認那一步,在無人互動的模式下永遠做不完。另外要提醒的是,短問句十幾秒就回,但兩三千字的長指令每一輪要一兩分鐘——估時間的時候別拿短問句的數字去套長活。

四、我從這幾條學到的通則

這些地雷看起來很雜,但它們有共同的形狀:每一個都是「你以為它在做事,它其實沒有」。

推不上去、改檔沒生效、被切斷、讀完不給結論、卡在權限確認——五種不同的原因,同一種症狀:安靜地失敗。

所以我的驗收方式後來統一了,不管派給誰、不管它回什麼,一律看同一件事:要它產出的那個檔案,落地了沒有。

明天整篇講這個,因為裡面還有一層更深的坑:連「它回話了」這件事本身,都可能是假的。


上一篇
Day 6|能力會漂移,所以要有一張煞車燈
下一篇
Day 8|它回話了,不代表它做完了
系列文
一個人的 AI 團隊:Claude Code 當組長,帶四家引擎做教學工作的實測與踩坑13
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言