B.3 規劃模式(Planning Mode):運用 /plan 將商業痛點轉化為精確架構藍圖
學完本節,你能夠:
- 判斷一項任務該用規劃模式(Planning)還是快速模式(Fast)。
- 用
/plan下達一個商務任務,並要求計畫涵蓋問題、目標、資料流、里程碑、驗收標準、內控六個面向。 - 依檢核表審核 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
問題定義錯了"] --> 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 節) |
本節小結
- 複雜任務用 Planning(或
/plan),簡單任務用 Fast;改計畫永遠比改系統便宜。 - 計畫該涵蓋什麼,由你在指令中要求:問題、指標、資料流、里程碑、驗收情境、內控。
- 審核時特別看三件事:問題定義對不對、例外有沒有處理、AI 被授權做了什麼。
- 按下 Proceed 是一個管理決策,代表你為這份計畫背書。
陸、練習
- 改情境(5 分鐘):如果經理說「警報要在免費期到期前 72 小時發」,計畫中哪幾處要改?情境二的日期要怎麼調整?
- 寫計畫指令(20 分鐘):替「每月自動提醒逾期 30 天以上的應收帳款」寫一段
/plan指令,包含已知資料、六個面向要求與至少 2 條限制。 - 管理反思(討論):回想一次「大家急著做簡報,做完才發現沒回答老闆的問題」的經驗。如果當時有一份需要主管按 Proceed 才能開工的計畫,結果會不同嗎?誰應該有按 Proceed 的權限?