4.6 指揮 AI 的溝通協定:命名、決策編號與「宣稱 vs. 驗證」

學完本節,你能夠:

  1. 從「同一份題目、兩種結果」的案例,指出與 AI 協作時不能交出去的三件事。
  2. 使用參照點命名、決策編號(D/O/Q)與固定回報格式,讓 AI 的回覆可以被逐項核對。
  3. 分辨 AI「宣稱做完」與「已被驗證」的差別,並寫出比「幫我修好」更有效的問題回報。

壹、開場情境:同一份題目,16 個指令 vs. 77 個指令

📌 以下為教學情境(依國外課程中真實觀察到的對比改編)。

一家五金貿易公司請兩位暑期實習生,各自用同一個 AI 代理、在同樣兩小時內,做一個「客戶詢價 → 自動算出含運費報價」的小工具。

實習生 A 實習生 B
前 15 分鐘 先站在業務的角度想:「他每天怎麼用?什麼情況會讓他抓狂?」寫下一頁自己的決定 請 AI「寫一份完整的設計文件」,AI 寫出一份數千字的長文件
設計文件 一頁,自己寫、自己懂 很長、很專業,但 B 沒有細讀
開發方式 一小塊一小塊做,每做完一塊就親自用業務的身分操作一次 讓 AI 照文件一路做完
發現問題 自己操作時發現 4 個自動測試都沒抓到的錯誤,逐一描述給 AI 修 程式一執行就當機。原因是文件裡某個欄位一處叫「報價日」、另一處叫「今天」,B 從沒發現
修錯方式 明確告訴 AI 錯在哪一邊(例如「是測試寫錯,不是主程式」) 「修好它」「好了嗎?」「為什麼還是不行」,AI 只看到錯誤訊息,同一個啟動檔連改三次,都沒改到真正出錯的地方
結果 16 個指令,準時完成 77 個指令,時間到了仍會當機

兩人用的工具、時間、題目完全相同。差別不在誰比較懂程式,而在誰在做判斷:B 形式上也是「先設計、再實作」,可是設計由 AI 寫、測試由 AI 跑、修正方向也由 AI 猜;A 的每一個轉折點,都是自己拍板。

本節要解決的問題: 怎麼和 AI 溝通,才能讓「決定權」留在人身上,又不會累到每一行都要自己看?


貳、概念:宣稱與驗證,在對話視窗裡長得一模一樣

1. 三件不能交出去的事

不能交出去的事 交出去會怎樣 開場案例
做決定 AI 替你做的決定,你不知道它做了 B 的 3,000 字文件裡藏著前後矛盾的欄位名稱
親眼看結果 「測試通過」不等於「業務用起來沒問題」 A 親自操作才找到 4 個測試抓不到的錯
決定告訴 AI 什麼 AI 只能依你給的線索猜 B 只給錯誤訊息,AI 就在錯的地方反覆修

2. 「宣稱」不等於「驗證」

AI 代理每次說「已完成」「測試已通過」時,在對話視窗裡的樣子都一樣,但背後可能是三種完全不同的狀況:

AI 說「完成了」,實際上可能是…… 例子
✅ 真的做了,也真的檢查過 執行了你事先準備的驗收測試,全部通過
⚠️ 做了,但沒有檢查 程式寫好了,但根本沒執行過
❌ 自己出題自己答 它自己挑了一個「一定會過」的檢查,例如只確認程式能開啟,沒有真的算一筆報價

AI 本身不會記得哪些是驗證過、哪些只是宣稱;記住這件事是你的工作。

3. 判斷要站在「剛好的距離」

可以用主管審核部屬工作來想像:

審核方式 像什麼 結果
逐字逐句改 主管把每份報告都重寫一遍 主管成了瓶頸,AI 的速度優勢消失
只看結論就簽 主管看到「已完成」就蓋章 出事時才發現沒人真正看過
看關鍵節點 主管只確認:答應的事交了沒?證據是什麼?哪裡還沒確認? 需要一套雙方都看得懂的「溝通協定」,就是本節第參段

一句話記住:不必看每一行,但要看每一個決定。


參、方法:四個溝通協定

協定 1:參照點,用「名字」不用「描述」

給專案裡重要的東西取一個短而固定的名字,之後一律用名字溝通。

用描述(容易走樣) 用參照點(精確、省字)
「把運費那個部分改一下,讓它比較合理」 「只處理 F3(運費計算)的驗收條件 F3-2:超過 30 公斤改用海運報價。只改 freight.py。」
「之前說的那個例外」 「規格 §4 第 2 條」

規則只有兩條:名字一旦用了就不改意思(要改就給新編號);AI 提到你沒定義過的編號時,要立刻追問。

協定 2:決策編號 D/O/Q

在 AI 的規則檔(第 7.2 節、附錄 B.8 的 AGENTS.md 或 CLAUDE.md)寫一行:

當你列出三項以上的內容時,請一律編號:決策用 D1、D2…,選項用 O1、O2…,問題用 Q1、Q2…。

AI 回覆時會變成:

D1 報價幣別預設為美元,可切換新台幣。
D2 運費依重量分三級:0–10 kg、10–30 kg、30 kg 以上。
D3 匯率每天早上更新一次。
Q1 報價有效期限是幾天?

你只要回覆:「D1 同意。D2 改成兩級,30 kg 為界。D3 同意。Q1:7 天。」AI 可以逐項確認,也能發現「D2 你改了,但 D4 你沒回答」。這就像簽呈上的逐項批示,比一大段「大致上可以,但運費那邊……」清楚得多。

協定 3:固定回報格式

要求 AI 每做完一段工作,都用同一個格式回報:

【交付】完成了哪些驗收條件(用編號)
【改動】動了哪些檔案
【執行】實際執行了哪些檢查,結果如何
【未驗證】哪些事情我沒有確認

最重要的是最後一欄。看到「執行:無」,就知道這次的「完成」只是宣稱。

協定 4:一行進度狀態

把目前進度濃縮成一行,例如:

規格 v2 · F1、F2 完成 · F3-2 未通過:30 kg 以上海運報價錯誤

這一行可以拿來當作新對話的開場、交接給同事的訊息,也可以當作版本紀錄的說明(附錄 A.2)。對話關掉了,這一行還在。

補充:比「修好它」更好的問題回報

❌ 只給結論 ✅ 給三樣東西
「報價算錯了,修好它。」 「我做了什麼:輸入 35 公斤、目的港胡志明市。我預期:海運報價約 US$ 120。我看到:顯示空運報價 US$ 480。只修 F3-2,不要動其他功能。」

肆、應用到情境:實習生 B 重來一次

B 在第二週重新挑戰,這次先在專案資料夾放了一份規則檔:

# AGENTS.md(報價小工具)
- 列出三項以上的內容時,決策用 D、選項用 O、問題用 Q 編號。
- 功能編號 F1–F4、驗收條件 F1-1… 以 SPEC.md 為準,不得自行新增編號。
- 每段工作結束時,依「交付/改動/執行/未驗證」四欄回報。
- 規格沒寫到的情況,先停下來用 Q 編號問我,不要自己決定。

AI 提出的設計只有 12 條決策,B 逐條批示,花了 10 分鐘。實作到一半,AI 回報:

【交付】F1-1、F1-2(報價幣別切換)
【改動】quote.py、currency.py
【執行】pytest:8 項通過
【未驗證】匯率服務連線失敗時的行為(Q3:要停止報價,還是用昨天的匯率?)

B 看到【未驗證】,回答:「Q3:停止報價並顯示『匯率暫時無法取得』,不可用舊匯率(參考第 4.4 節的原則)。」接著他親自用業務的身分試了三筆詢價,才在進度狀態寫上「F1 完成」。

這一次(教學情境),B 在時間內完成了,指令數也少了一大半。


伍、判斷看看:這些訊息好不好?

給 AI 的訊息 評價 理由
「整體看起來不錯,有些地方再調一下。」 ❌ 沒有編號、沒有對象,AI 只能猜哪裡要調
「D1 否決,理由:主要客戶要求以歐元報價;D2、D3 同意。」 ✅ 逐項批示並附理由,理由也能寫進設計文件的「被否決方案」(第 2.8 節)
「測試都過了嗎?」 ⚠️ AI 會回答「是」,但你不知道它跑了哪些測試。改問:「列出你實際執行的指令與結果。」
「F2 做好了嗎?好了就幫我把 F3、F4 一起做完。」 ⚠️ 還沒驗證 F2 就往下做,錯誤會一路累積。一次一個功能
「你剛剛提到的 F7 是什麼?SPEC.md 只到 F4。」 ✅ 抓到 AI 自創編號,及早阻止它偏離規格

陸、限制與銜接

限制 後果 在哪一節處理
AI 可能在回報格式裡誠實地寫錯(例如以為跑過其實沒跑) 回報本身也要抽查 第 4.5 節審查;第 9.6 節:完成與否要由事先寫好的檢查判斷
編號系統需要維護 專案一大,編號會混亂 用設計文件(第 2.8 節)作為唯一的編號來源
溝通協定只能管「說的話」 AI 仍可能執行危險動作 第 9.2 節權限隔離、第 9.6 節核准關卡

本節小結

  1. 與 AI 協作時,做決定、親眼看結果、決定告訴 AI 什麼這三件事要留在自己手上。
  2. 「宣稱」與「驗證」在對話中看起來一樣;記住哪些已驗證,是人的責任。
  3. 四個溝通協定:參照點命名、D/O/Q 決策編號、交付/改動/執行/未驗證回報、一行進度狀態。
  4. 回報問題要給「我做了什麼、預期什麼、實際看到什麼」,而不是「修好它」。

柒、練習

  1. 改寫訊息(10 分鐘):把下面三句改寫成符合溝通協定的版本:(a)「報價單格式怪怪的,弄好看一點」;(b)「那個折扣的規則你再想想」;(c)「應該都好了吧?」
  2. 寫規則檔(20 分鐘):替你自己的一個 AI 專案(可以是課堂報告助理)寫一份 5 行以內的 AGENTS.md,至少包含決策編號與回報格式兩條規則。實際用一次,記錄 AI 的回報裡【未驗證】欄出現了什麼。
  3. 管理反思(討論):「宣稱 vs. 驗證」在人類組織裡也常見,例如業務回報「客戶已經答應了」、廠商回報「貨已經出了」。你在打工或實習時看過哪些例子?公司用什麼制度把「宣稱」變成「驗證」(例如簽收單、提單、對帳)?這些制度可以怎麼搬到 AI 協作上?

📚 觀念出處:參照點、決策編號與「宣稱 vs. 驗證」的觀念,參考美國密西根大學 EECS 498「Applied Agentic Software Engineering」課程(2026 秋季)的教學內容;開場對比案例依該課程觀察到的兩種工作方式改編為商業情境。本節內容為重新撰寫。

國立臺中科技大學 國際貿易系 / 企業管理系 專用教材

《現代軟體工程:商學院的 AI 系統思維與 Agent 實踐》

作者:陳俊智 博士 Dr. Chun-Chih Chen

本書章節架構改編自陳鍾誠教授(金門大學)開源課程《現代軟體工程》(github.com/ccc115a/se,MIT 授權),內容針對商學院全面改寫與擴充。