From 31ba3f490a0714d27efb777969390693217cfecc Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 26 Aug 2026 19:00:17 +0800 Subject: [PATCH] =?UTF-8?q?feat(tdd):=20TDD=20=E5=BE=AA=E7=92=B0=E8=A6=8F?= =?UTF-8?q?=E5=89=87=E6=96=B0=E5=A2=9E=E8=A8=BB=E8=A7=A3=E5=8F=AA=E5=AF=AB?= =?UTF-8?q?=E5=8E=9F=E5=9B=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What：references/tdd.md 的循環規則新增第 4 項「註解只寫原因」，並寫成單一待辦的完成條件。 Why：註解界線要在紅綠循環當下就守住，不能等到審查階段才回頭清，否則追蹤編號早已散進整包 diff。 How：規則只寫一句界線加完成條件，完整清單與白名單指向 jsc-review 的 references/comment-scope.md。 Who：jsc-sdlc 的 TDD 參考文件，implement 與 maintain 兩支技能共用。 --- references/tdd.md | 1 + 1 file changed, 1 insertion(+) diff --git a/references/tdd.md b/references/tdd.md index 9a1acc8..b75b54c 100644 --- a/references/tdd.md +++ b/references/tdd.md @@ -9,6 +9,7 @@ 1. **先紅後綠**：先寫會失敗的測試，再寫剛好通過的實作；不預寫未來的測試、不加投機功能。 2. **一次一片（vertical slice）**：一個接縫、一個測試、一個最小實作為一個循環；下一片依上一片學到的調整。 3. **重構不在循環內**：重構屬於審查階段（`jsc-review:code-review`），不混入紅綠循環。 +4. **註解只寫原因**：一個待辦要算完成，該次 diff 的註解不得夾帶追蹤編號與文件位置。完整清單與白名單見 `jsc-review` 的 `references/comment-scope.md`。 ## 反模式（發現即重寫該測試）