B.3 規劃模式(Planning Mode):運用 /plan 將商業痛點轉化為精確架構藍圖

學完本節,你能夠:

  1. 判斷一項任務該用規劃模式(Planning)還是快速模式(Fast)。
  2. 用 /plan 下達一個商務任務,並要求計畫涵蓋問題、目標、資料流、里程碑、驗收標準、內控六個面向。
  3. 依檢核表審核 Agent 產出的計畫,用留言修正後再按 Proceed 放行。

壹、開場情境:AI 很快做完了一個沒人要的系統

📌 以下為教學情境(依實務改編)。

一家跨境電商的物流經理說:「旺季貨櫃常常卡在港口,滯櫃費(demurrage)付到心痛,幫我做一個預警系統。」去年旺季,公司在美西港口共付了約 US$ 18 萬的滯櫃費與延滯費。

實習生小陳把這句話直接丟給 Agent。20 分鐘後,Agent 交出一個漂亮的網頁:能輸入貨櫃號碼、顯示船舶位置。但經理看了搖頭:

  • 他要的是「免費期快到了」的警報,不是船在哪裡的地圖;
  • 每份合約的免費天數不同,系統裡根本沒有這個資料;
  • 警報該發給誰、發了之後誰有權決定改走其他港口,完全沒提。

程式本身沒有錯,錯在沒有人在動手前確認「要解決的到底是什麼問題」。

本節要解決的問題: 怎麼讓 Agent 在寫第一行程式之前,先交出一份你能審核的計畫?


貳、概念:先規劃,再執行

1. 兩種工作模式

Antigravity 的對話可以選擇兩種模式:

Planning(規劃模式) Fast(快速模式)
做法 先研究、產出實作計畫與任務清單,等你審核 跳過規劃,直接執行
適合 牽涉多個檔案、多條商業規則、品質要求高的任務 改個欄位名稱、修一個小錯、跑一個簡單指令
代價 比較慢,產生較多 Artifacts 快,但錯了要事後才發現

另外,/plan 斜線指令會讓 Agent 先研究現有檔案、對你進行需求追問,再起草一份可審核的計畫 Artifact。

flowchart TB subgraph NoPlan ["直接執行"] A1["一句模糊願景"] --> B1["Agent 立刻寫程式"] --> C1["做完才發現
問題定義錯了"] --> D1["重做"] end subgraph WithPlan ["先 /plan"] A2["一句模糊願景"] --> B2["Agent 追問需求
產出計畫 Artifact"] --> C2["人審核、留言修正"] --> D2["Proceed 後執行"] end style C1 fill:#fee2e2,stroke:#ef4444 style C2 fill:#fef9c3,stroke:#ca8a04

修改計畫只要改幾行字;修改做好的系統,要改程式、重測、重新部署。錯誤越早發現越便宜,這是第 2 章需求工程的核心觀念。

2. 一份好計畫該有的六個面向

Agent 產出的計畫格式不一定固定,所以由你在指令中要求它涵蓋哪些面向。以下六項對應到本書前面各章:

面向 要回答的問題 對應章節
① 問題與根因 真正的痛點是什麼?為什麼會發生? 2.1、2.3(6W)
② 成功指標 做到什麼程度算成功?怎麼量? 2.1
③ 資料流 資料從哪來、經過什麼處理、輸出到哪? 3.1
④ 分階段里程碑 先做什麼、後做什麼?每階段可以單獨驗收嗎? 12.1
⑤ 驗收標準 用 Given-When-Then 寫出具體情境 5.2(BDD)
⑥ 內控護欄 哪些動作 AI 不能自己做、必須人批准? 9.2、12.4

💡 Given-When-Then:一種寫驗收標準的格式——「在某個前提下(Given),發生某件事(When),系統應該怎麼反應(Then)」。財務主管和工程師都看得懂,第 5.2 節會詳細練習。


參、應用到情境:用 /plan 重新來一次

1. 指令

/plan 旺季期間,我司從亞洲運往美西港口的貨櫃常超過免費期,產生滯櫃費。
請規劃一套「免費期到期預警」系統。

【已知資料】
- 出貨明細在 shipments.xlsx(櫃號、船名、卸貨港、預計到港日)
- 各船公司合約的免費天數不同,目前只存在 PDF 合約中

【計畫必須包含】
1. 問題與根因 2. 成功指標 3. 資料流 4. 分階段里程碑
5. Given-When-Then 驗收情境(至少 3 個,含 1 個例外)
6. 哪些動作必須由人批准

【限制】
- 第一階段不串接任何外部付費 API
- 系統只發警報與試算,不得自動變更任何訂艙或提單

2. Agent 產出的計畫(節錄,經人工整理)

# 實作計畫:貨櫃免費期到期預警

## 1. 問題與根因
- 痛點:貨櫃超過免費期才被發現,產生滯櫃費
- 根因:免費天數散落在 PDF 合約,沒有人每天比對「到港日 + 免費天數」

## 2. 成功指標
- 旺季期間,所有貨櫃在免費期到期前 48 小時內都有收到警報
- 滯櫃費金額較去年同期下降(由財務月報追蹤)

## 3. 資料流
shipments.xlsx + 免費天數對照表 → 每日比對程式 → 警報清單 → Email 通知物流經理

## 4. 分階段里程碑
- 第一階段:人工把合約免費天數整理成 free_days.csv(由物流部確認)
- 第二階段:每日比對程式,產出到期清單
- 第三階段:Email 通知(之後可改用 Apps Script 或 n8n)

## 5. 驗收情境
- 情境一(正常):Given 貨櫃 10/1 到港、免費期至 10/6;When 10/3 已提櫃;Then 不發警報
- 情境二(將到期):Given 免費期至 10/6 當天結束;When 10/5 早上尚未提櫃(剩餘不到 48 小時);Then 發出警報
- 情境三(例外):Given 某船公司不在 free_days.csv;When 執行比對;Then 該櫃標示「缺免費天數」並通知物流部,不得以預設值代替

## 6. 必須由人批准
- 任何改港、改提櫃日、增加費用的決定
- free_days.csv 的內容修改

3. 審核檢核表

放行之前,逐項檢查:

檢查項目 本例 需要留言修正嗎?
問題定義是否是經理真正要的? 是「免費期警報」,不是船舶地圖 ✅
成功指標可量測嗎? 「到期前 48 小時都有警報」可檢查 ✅
有沒有處理資料缺漏? 情境三有處理缺免費天數 ✅
警報發給誰?發了之後誰決定? 只寫物流經理,沒寫代理人 ⚠️ 留言:經理休假時改發副理
AI 有沒有被授權做不該做的事? 改港需人批准 ✅

留言後,Agent 會在原本的計畫 Artifact 上更新;確認無誤再按 Proceed,Agent 才開始執行並依任務清單逐項完成。


肆、判斷看看:該用哪一種模式?

任務 建議模式 理由
把報表的「Qty」欄名改成「數量」 Fast 單一、明確、出錯好修
建立新的應收帳款逾期提醒 Planning(/plan) 牽涉規則、資料來源與通知對象
老闆只說「做個客戶分級」,你也不確定要什麼 /grill-me,再 /plan 先被追問,把規格想清楚
計畫已審核通過、規則明確的批次轉檔 放行後讓它執行到完成(可考慮 /goal) 規則已被人確認,風險低

常見誤解: 「規劃模式比較慢,所以比較沒效率。」——如果把「做錯重來」的時間算進去,規劃通常比較快。真正要避免的是為小事寫大計畫,那才是浪費。


伍、限制與銜接

限制 後果 在哪裡處理
計畫只是文字,不保證程式真的照做 執行結果偏離計畫 驗收時對照完成說明與驗收情境逐條測(第 5 章)
Agent 產出的計畫格式不固定 每次審核重點不同 把六面向要求寫成 Skill 或規則,每次自動套用(B.4)
根因分析需要業務知識 Agent 只能從現有檔案推測 與實際使用者訪談(第 2.2 節)

本節小結

  1. 複雜任務用 Planning(或 /plan),簡單任務用 Fast;改計畫永遠比改系統便宜。
  2. 計畫該涵蓋什麼,由你在指令中要求:問題、指標、資料流、里程碑、驗收情境、內控。
  3. 審核時特別看三件事:問題定義對不對、例外有沒有處理、AI 被授權做了什麼。
  4. 按下 Proceed 是一個管理決策,代表你為這份計畫背書。

陸、練習

  1. 改情境(5 分鐘):如果經理說「警報要在免費期到期前 72 小時發」,計畫中哪幾處要改?情境二的日期要怎麼調整?
  2. 寫計畫指令(20 分鐘):替「每月自動提醒逾期 30 天以上的應收帳款」寫一段 /plan 指令,包含已知資料、六個面向要求與至少 2 條限制。
  3. 管理反思(討論):回想一次「大家急著做簡報,做完才發現沒回答老闆的問題」的經驗。如果當時有一份需要主管按 Proceed 才能開工的計畫,結果會不同嗎?誰應該有按 Proceed 的權限?

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

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

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

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