5.2 測試驅動思維(TDD)與商業驗收測試(BDD)
學完本節,你能夠:
- 說明 TDD「紅燈 → 綠燈 → 重構」三個步驟各自的商業意義。
- 用 Given-When-Then(假設—當—那麼)寫出業務人員看得懂、電腦也能執行的驗收情境。
- 以信用狀審單為例,先寫測試、確認失敗,再讓 AI 寫出程式並通過全部測試。
壹、開場情境:審單程式寫完了,大家才開始吵規則
📌 以下為教學情境(依外貿實務改編)。
一家自行車零件出口商用信用狀(L/C,Letter of Credit)收款:只要提交的單據與信用狀條款相符,開狀銀行就保證付款。上季有一筆貨的提單(B/L,Bill of Lading,船公司開的裝運證明)日期晚了三天,銀行判定不符點(discrepancy),拒絕付款,公司花了一個多月才和買方談妥。
財務經理請同事做一個「交單前自動審單」的小工具。程式很快寫好了,拿去試用時卻吵了起來:
- 「最遲裝運日當天裝船,算不算逾期?」
- 「交單期限是裝運後 21 天,第 21 天交還可以嗎?」
- 「信用狀過期了,但裝運日沒問題,要報哪一個不符點?」
這些問題在寫程式之前就該有答案。程式寫完才問,就是在改已經蓋好的房子。
本節要解決的問題: 能不能先把「什麼叫做對」寫成可以執行的檢查,再讓 AI 去寫程式?
貳、為什麼會這樣:先寫驗收標準,再寫程式
1. TDD:測試驅動開發
TDD(Test-Driven Development)是 Kent Beck 在 2000 年代初推廣的做法,核心是一個短循環:
| 步驟 | 做什麼 | 商業意義 |
|---|---|---|
| 🔴 紅燈 | 先寫一個測試,執行後一定失敗(因為功能還不存在) | 證明這是一個「尚未被滿足」的需求,也證明測試真的會抓錯 |
| 🟢 綠燈 | 寫出剛好讓測試通過的程式 | 需求被滿足,不多做 |
| 🔧 重構 | 在測試全部通過的前提下,整理程式(例如把數字抽成常數) | 改善品質而不怕改壞,因為測試在旁邊盯著 |
為什麼一定要先看到紅燈?如果測試一寫好就通過,你無法確定它是「程式對了」還是「測試根本沒在檢查」。
2. BDD:讓業務人員也看得懂的測試
assert check_lc(...) == ["LATE_SHIPMENT"] 對財務經理來說仍然難讀。BDD(Behavior-Driven Development,行為驅動開發)用接近口語的 Gherkin 語法寫驗收情境:
| 關鍵字 | 意思 | 例子 |
|---|---|---|
| 假設(Given) | 事前條件 | 信用狀最遲裝運日為 2026-10-15 |
| 當(When) | 發生的動作 | 提單裝運日為 2026-10-18 |
| 那麼(Then) | 應該得到的結果 | 審查結果應為「逾期裝運」 |
| TDD | BDD | |
|---|---|---|
| 寫給誰看 | 工程師(與 AI) | 業務、財務、法務也看得懂 |
| 長什麼樣 | 程式碼 | 結構化的中文/英文句子 |
| 檢查的粒度 | 一個函式 | 一個業務情境 |
| 關係 | BDD 情境底下,通常由 TDD 的測試與程式支撐 |
參、把規則寫下來:審單規格
國際商會《跟單信用狀統一慣例》(UCP600)是銀行審單的共同依據。實務審單項目很多,本節只取三條與日期有關的規則:
| 業務說法 | 需要追問 | 寫成規格 |
|---|---|---|
| 「不能晚於最遲裝運日」 | 當天裝運算不算逾期? | 提單日 > 最遲裝運日才算 LATE_SHIPMENT;當天可以 |
| 「裝運後 21 天內要交單」 | 第 21 天可以嗎? | 交單日 > 提單日 + 21 天才算 LATE_PRESENTATION(UCP600 第 14 條 c 項:不得晚於裝運日後 21 個曆日) |
| 「信用狀過期就不能交」 | 跟其他不符點同時發生怎麼辦? | 交單日 > 有效期限 → LC_EXPIRED;所有不符點都列出來,不是只報第一個 |
| (沒人提) | 全部沒問題要回傳什麼? | 回傳空清單,畫面顯示「PASSED」 |
⚠️ 提醒:提單日原則上以簽發日為裝運日;若有裝船批註(on board notation)則以批註日為準。真實信用狀也可能另訂交單天數。本節為教學簡化版。
肆、讓 AI 做出來:一步一步走紅綠燈
1. 給 AI 的 Prompt
我們用 TDD 開發 Python 函式 check_lc(latest_shipment, expiry, bl_date, presentation_date),
參數都是 date,回傳不符點代碼清單(空清單代表相符)。
【規則】
1. bl_date > latest_shipment → "LATE_SHIPMENT"(當天不算逾期)
2. presentation_date > bl_date + 21 天 → "LATE_PRESENTATION"(第 21 天不算逾期)
3. presentation_date > expiry → "LC_EXPIRED"
4. 多個不符點時全部列出,順序同上;21 宣告為常數 PRESENTATION_DAYS
【工作方式】
第一步:只寫 pytest 測試檔,不要寫實作。測試名稱用中文寫出情境與預期。
第二步:執行測試,把失敗訊息貼給我看。
第三步:寫實作,執行到全部通過,再把結果貼給我。
2. 🔴 紅燈:先寫第一個測試
函式還沒實作(只回傳空清單),先寫一個「逾期裝運」的測試:
from datetime import date
from lc_check import check_lc
def test_提單日晚於最遲裝運日_應判逾期裝運():
result = check_lc(latest_shipment=date(2026, 10, 15),
expiry=date(2026, 11, 15),
bl_date=date(2026, 10, 18),
presentation_date=date(2026, 10, 25))
assert result == ["LATE_SHIPMENT"]
執行 python -m pytest -q,結果是 1 failed。這個紅燈是好消息:測試確實會抓到「沒做這件事」。
3. 🟢 綠燈 → 再加測試 → 🔧 重構
只寫第 1 條規則,測試變成 1 passed。接著把第參段其餘情境都寫成測試(共 6 個),只有第 1 條規則的程式會得到 2 failed, 4 passed(逾期交單、信用狀過期兩個沒抓到)。補完規則、把 21 抽成常數之後:
from datetime import timedelta
# ===== 商業規則 =====
PRESENTATION_DAYS = 21 # UCP600 第 14 條 c 項:裝運日後 21 個曆日內交單
def check_lc(latest_shipment, expiry, bl_date, presentation_date):
"""回傳不符點代碼清單;空清單代表單證相符。"""
problems = []
# 規則 1:提單日不可晚於信用狀最遲裝運日(當天裝運可以)
if bl_date > latest_shipment:
problems.append("LATE_SHIPMENT")
# 規則 2:交單日不可晚於裝運日後 21 天
if presentation_date > bl_date + timedelta(days=PRESENTATION_DAYS):
problems.append("LATE_PRESENTATION")
# 規則 3:交單日不可晚於信用狀有效期限
if presentation_date > expiry:
problems.append("LC_EXPIRED")
return problems
完整測試檔(test_lc.py):
from datetime import date
from lc_check import check_lc
LC = dict(latest_shipment=date(2026, 10, 15), expiry=date(2026, 11, 15))
def test_提單日晚於最遲裝運日_應判逾期裝運():
assert check_lc(**LC, bl_date=date(2026, 10, 18),
presentation_date=date(2026, 10, 25)) == ["LATE_SHIPMENT"]
def test_單證相符_應放行():
assert check_lc(**LC, bl_date=date(2026, 10, 12),
presentation_date=date(2026, 10, 20)) == []
def test_最遲裝運日當天裝運_應放行():
assert check_lc(**LC, bl_date=date(2026, 10, 15),
presentation_date=date(2026, 10, 20)) == []
def test_裝運後第22天才交單_應判逾期交單():
assert check_lc(**LC, bl_date=date(2026, 10, 12),
presentation_date=date(2026, 11, 3)) == ["LATE_PRESENTATION"]
def test_裝運後第21天交單_應放行():
assert check_lc(**LC, bl_date=date(2026, 10, 12),
presentation_date=date(2026, 11, 2)) == []
def test_超過信用狀有效期限_應判過期():
assert check_lc(**LC, bl_date=date(2026, 10, 30),
presentation_date=date(2026, 11, 16)) == ["LATE_SHIPMENT", "LC_EXPIRED"]
執行結果:6 passed。
🔍 驗收重點 - 10/12 裝運,11/2 是第 21 天、11/3 是第 22 天。日期你自己數過了嗎? - 每條規則都有「剛好在邊界上」的測試嗎?(當天裝運、第 21 天交單) - 最後一個測試同時有兩個不符點,結果有沒有全部列出?
4. 同一份規格,寫成 BDD 情境
用 Python 的 behave 套件(pip install behave),可以直接執行中文的 Gherkin 檔。第一行 # language: zh-TW 告訴它使用繁體中文關鍵字。
features/lc_check.feature:
# language: zh-TW
功能: 信用狀交單前的單證審查
作為外貿部的財務人員
我希望在向銀行交單前自動比對提單與信用狀
以便事先發現不符點,避免銀行拒付
背景:
假設 信用狀最遲裝運日為 "2026-10-15"
而且 信用狀有效期限為 "2026-11-15"
場景: 提單日晚於最遲裝運日
當 提單裝運日為 "2026-10-18",交單日為 "2026-10-25"
那麼 審查結果應為 "LATE_SHIPMENT"
場景: 單證相符
當 提單裝運日為 "2026-10-12",交單日為 "2026-10-20"
那麼 審查結果應為 "PASSED"
場景: 裝運後第 22 天才交單
當 提單裝運日為 "2026-10-12",交單日為 "2026-11-03"
那麼 審查結果應為 "LATE_PRESENTATION"
每一句話要對應到一段程式(稱為 step),這部分可以交給 AI 產生。features/steps/lc_steps.py:
import sys, os
from datetime import date
from behave import given, when, then
sys.path.insert(0, os.path.abspath("."))
from lc_check import check_lc
@given('信用狀最遲裝運日為 "{d}"')
def step_latest(context, d):
context.latest = date.fromisoformat(d)
@given('信用狀有效期限為 "{d}"')
def step_expiry(context, d):
context.expiry = date.fromisoformat(d)
@when('提單裝運日為 "{bl}",交單日為 "{pres}"')
def step_check(context, bl, pres):
context.result = check_lc(context.latest, context.expiry,
date.fromisoformat(bl), date.fromisoformat(pres))
@then('審查結果應為 "{expected}"')
def step_result(context, expected):
actual = ",".join(context.result) or "PASSED"
assert actual == expected, f"實際結果:{actual}"
在 lc_check.py 所在的資料夾執行 behave,結果為 3 scenarios passed。之後財務經理只要照格式新增一段場景,不必碰程式,就能多一條驗收標準。
伍、跑跑看、壞給你看
以下對 lc_check.py 動手腳,再執行 python -m pytest -q。每次做完改回原狀。
| 實驗 | 操作 | 預期結果 | 想想看 |
|---|---|---|---|
| ① 邊界寫錯 | 規則 1 的 > 改成 >= |
1 failed:「最遲裝運日當天裝運」被判逾期 |
這正是第壹段吵架的那一題。如果沒先寫測試,誰會發現? |
| ② 期限算錯 | PRESENTATION_DAYS 改成 20 |
1 failed:「第 21 天交單」被判逾期 |
如果某張信用狀約定 15 天,程式該怎麼設計? |
| ③ 漏一條規則 | 刪掉規則 3 的兩行 | 1 failed:信用狀過期沒被抓到 |
只報「逾期裝運」,業務會不會誤以為只要修約就好? |
| ④ BDD 也會抓 | 保持實驗①的錯,在 .feature 新增「最遲裝運日當天裝運 → PASSED」場景後執行 behave |
1 failed,訊息「實際結果:LATE_SHIPMENT」 |
業務人員寫的一句話,就抓到了工程上的錯 |
陸、回到情境
先寫測試,逼著大家在寫程式之前回答「當天算不算」「第 21 天可不可以」。答案一旦寫進測試,之後不論是同事還是 AI 改程式,邊界都不會被悄悄改掉。
這也是使用 AI 寫程式時最有效的指揮方式:你負責定義「什麼叫做對」(測試與情境),AI 負責寫出通過的程式。但要記得,AI 也可能為了讓測試通過而去改測試,所以測試檔的變更一定要由人審核(第 4.5 節)。
| 限制 | 後果 | 在哪一節解決 |
|---|---|---|
| 只審日期,沒審金額、品名、受益人 | 其他不符點仍會被拒付 | 練習 2;實務上需與銀行審單人員一起定規格 |
| 測試案例是人想出來的 | 沒想到的邊界一樣會漏 | 5.4 AI 協助產生極端案例 |
| 日期由人輸入 | 輸入錯,審查結果就錯 | 第 2.4 節的輸入防呆 |
本節小結
- TDD:紅燈證明需求存在、測試有效;綠燈代表需求被滿足;重構在測試保護下改善程式。
- BDD 用「假設—當—那麼」把驗收標準寫成業務人員看得懂、電腦能執行的情境。
- 邊界(當天、第 21 天)要在寫程式前講清楚,並各寫一個測試。
- 指揮 AI 時,先給測試再要程式;測試檔的修改要由人把關。
柒、練習
- 改數字(5 分鐘):某張信用狀約定「裝運後 15 天內交單」。修改常數後,哪個測試會失敗?請新增「第 15 天交單放行、第 16 天逾期」兩個測試。
- 加功能(20 分鐘):新增規則「發票金額不得超過信用狀金額」,代碼
OVER_AMOUNT。請先寫出 BDD 場景(至少含「剛好等於」與「超過 1 美元」),確認behave失敗,再請 AI 補程式直到通過。 - 管理反思(討論):專案經理說:「寫測試要多花時間,會拖慢上線。」請從「規則爭議在何時被發現」與「之後每次修改的風險」兩個角度回應。哪些情況下你會同意少寫測試?