案例引用三段式段落結構:概念定義 → case 引用 → 通用展開
結論
Case 引用段落要走三段式結構紀律 — 段首是概念定義句、case 引用退到第二位置、最後通用工程知識展開。讓段落結構反映「概念 → 案例 → 操作」的論證流、不是「案例 → 概念 → 操作」的反向流。
| 段位 | 內容 | 反模式 |
|---|---|---|
| 段首 | 概念定義句:該概念是什麼、承擔什麼責任 | 「對應 [case] 揭露 X」段首取代核心概念 |
| 第二位置 | Case 引用:「對應 [case]:揭露 N 個機制 — …」 | 跨章 13+ 段同句構、case 引用變儀式 |
| 通用展開 | 「以下基於通用工程知識補充」+ 具體操作 | 通用知識直接掛在 case 名下、沒明示分層 |
違反三段式最常見的形式是「概念定義句缺位、case 引用直接當段首」— 讀者尚未理解概念就被丟入案例細節。
跟其他 case 引用紀律的差別
本卡跟 #115 / #116 / #117 是 case 引用紀律的不同 axis、互相正交:
| 卡 | Axis | 看什麼 |
|---|---|---|
| #115 案例引用深度跟著 case 類型走 | 引用「深度」 | Case 整體類型(skeleton / medium / rich)決定承接深度 |
| #116 Fact vs Derive 分層引用 | 引用「分層」 | Case 內部結構(觀察層 / 判讀層)決定要不要分層標明 |
| #117 跨 case 合成 frame 必須標明 | 引用「合成」 | 跨多 case 抽象 frame 時要 explicit 標「本章合成」 |
| #120 案例引用三段式(本卡) | 引用「結構」 | 段落順序:概念 → case → 通用 |
四 axis 組合起來覆蓋 case 引用的完整紀律。寫每段 case 引用時、四個 axis 都要過一遍。
為什麼這層紀律重要
backend/06 模組 reviewer 抓出 11/12 新段都犯「case 引用取代概念定義」的問題、屬最大宗 systemic 違規。原因:
- LLM 從 case 反推內容時、容易把 case 揭露當概念出發點
- Case 引用句構單一(「對應 [X]:揭露 N 個機制」)、跨章讀感同質
- 概念定義被推到第二段、商業邏輯先於 case 的原則被推翻
三段式紀律的價值是把「概念」「案例」「展開」三層分離、讓讀者依層級理解。
三段式範例
正確結構
1## 失效局部化:cell 邊界跟 shuffle sharding
2
3失效局部化是把單一依賴退化限制在最小可影響範圍的能力。把「依賴 budget」
4從統一全域帳本拆成 per-cell 可用度結構、是這層治理的核心責任。失效局部
5化要解四個子問題:擴散邊界、熱點重疊、控制面解耦、失敗模式工作量恆定。
6
7對應 [A1 Amazon Shuffle Sharding 與 Cell 邊界](.../shuffle-sharding-and-cell-boundary/):
8揭露四個機制對應上述四個子問題 — cell 邊界(擴散邊界)、shuffle sharding
9(熱點重疊)、static stability(控制面解耦)、constant work(失敗模式工作
10量恆定)。這四個機制把恢復策略從「全域搶救」轉為「分批收斂」。
11
12以下基於通用工程知識補充的具體操作 ...錯誤結構
1## 失效局部化:cell 邊界跟 shuffle sharding
2
3依賴 budget 的另一個面向是把失效影響限制在局部、不擴散到全域。多租戶
4服務跟共享資源服務若沒有明確邊界,單一依賴退化會觸發整體退化。
5
6對應 [A1 Amazon Shuffle Sharding 與 Cell 邊界]:
7揭露四個機制 — cell 邊界、shuffle sharding、static stability、constant work。差異:
- 正確:段首「失效局部化是…的能力」直接給概念定義、case 揭露的四機制對應到「四個子問題」、讀者懂概念才看到案例
- 錯誤:段首用「另一個面向」鋪墊、case 直接列四機制、讀者尚未理解就被丟入案例細節
案例引用句構分流(07 模組強化)
即使遵守三段式紀律、跨章 case 引用句構仍會同質化。07 batch 1 驗證 13 處 case 引用 11 處用同一句構「揭露 N 層失效控制面 — A、B、C」、讀者跨章連讀時把 case 引用當儀式而非論證。
分流原則:句構跟著 case 類型走、用 case 自身結構決定引用方式:
| Case 結構 | 適用句構 |
|---|---|
| Case 直接列 N 個 mechanism | 「揭露 N 層失效控制面 — A、B、C」 |
| Case 主寫單一壓力場景 | 「補的失效訊號是 X、mechanism 是 Y」 |
| Case 揭露歷史轉折 | 「從 X 改成 Y 的關鍵架構決策」 |
| Case 揭露對比結構 | 「揭露兩個層次的對照:A vs B」 |
| 多 case 並列補不同層 | 「A case 補 X、B case 補 Y」 |
| Case 揭露 mechanism 可引用範圍 | 「案例『可落地檢查點』直接列出 mechanism 屬可引用範圍」 |
寫多章時刻意變化句構、避免讀者連讀數章感「每段開頭都長一樣」。
反模式
| 反模式 | 後果 |
|---|---|
| 段首直接是「對應 [case]」、沒概念定義句 | 商業邏輯先於 case 原則被推翻、讀者尚未理解就被丟入案例細節 |
| 段首用「另一個面向」「不只是 X、是 Y」鋪墊取代概念定義 | 推進論證骨架取代概念先行 |
| 三段式中段(case 引用)擴寫成具體實作細節 | 把通用工程知識掛在 case 名下、case fidelity 失分 |
| 通用展開段沒明示「以下基於通用工程知識補充」 | 讀者誤以為展開內容也來自 case |
| 跨章 5+ 段用同一句構「揭露 N 層失效控制面」 | Case 引用變儀式、讀者連讀感同質 |
Stage 2 自查清單
寫完每章 case 引用後、檢查:
- 段首是否是概念定義句?(不是 case 引用、不是「另一個面向」鋪墊)
- Case 引用是否在第二位置?(不是段首)
- 通用展開是否有「以下基於通用工程知識補充」承接?
- 句構是否跟前面章節相同?(同模組超過 3 章用同句構就該變化)
掃描指令:
1# 找段首是 case 引用的段(最嚴格)
2rg -n "^對應 \[" <module-paths>
3
4# 找 ## 標題後緊接 case 引用的段(要手動 review)
5rg -B0 -A3 -n "^## " <file> | rg "對應 \["
6
7# 找句構同質化(跨檔抓「揭露 N 層失效控制面」出現次數)
8rg -c "揭露[^。]*失效控制面" <module-paths>False positive 警示:^對應 \[ 在三段分離結構(概念定義段 → 空行 → case 引用獨立段)下會 false positive、要用 awk 看 prev line 是否為實質概念段:
1awk '/^對應 \[/{prev_blank=(prev==""); print FILENAME ":" NR ": prev_blank=" prev_blank} {prev=$0}' <file>prev_blank=1 + 前段有實質概念定義 → 屬規範允許(三段分離)。
Polish pass 修法
如果 stage 3 reviewer 抓出大量「case 引用段首」issue、polish pass 的修法:
- 每個有 issue 的段、在 case 引用前補一句「概念定義 + 核心責任」
- 不重寫整段、只加 lead sentence(保留 case 引用本身)
- 變化 case 引用句構:把 11/12 段同一句構打散成 3-4 種變化
- 修完跑自掃描確認段首不再是 case 引用
修法成本:每段補 1-2 句概念定義、單章約 5-10 分鐘、整模組 1-2 小時。
跟其他抽象層原則的關係
| 原則 | 關係 |
|---|---|
| #115 案例引用深度跟著 case 類型走 | 互補 — 不同 axis、#115 看引用深度、本卡看引用結構 |
| #116 Fact vs Derive 分層引用 | 互補 — 不同 axis、#116 看 case 內部分層、本卡看段落順序 |
| #117 跨 case 合成 frame 必須標明 | 互補 — 不同 axis、#117 看跨 case 合成、本卡看單段結構 |
| #83 Writing multi-pass review | 互補 — #83 是 review 流程跨輪 frame、本卡是寫作當下段落順序 |
| #67 寫作便利度跟意圖對齊反相關 | 同骨 pattern — 「對應 [case]」當段首最順、不寫概念定義最省字、便利跟意圖對齊反向 |
| #114 Multi-pass review 的 frame 顆粒度盲點 | 句構同質化是 #114 在 case 引用 surface 的具體展現 |
判讀徵兆
| 訊號 | 該做的事 |
|---|---|
| 段首是「對應 [case] 揭露 X」 | 補概念定義句、case 引用退到第二位置 |
| 段首用「另一個面向」「不只是 X、是 Y」鋪墊 | 改成概念定義先行、不用對比骨架推進 |
| 跨章 5+ 段用同句構「揭露 N 層失效控制面」 | Stage 5 polish pass 句構分流 |
| Reviewer A 抓出「case 引用段首」issue 多 | 三段式紀律失效、整模組重審 |
| 通用展開段沒明示「以下基於通用工程知識補充」 | 補承接句、讓讀者知道展開內容是通用知識 |
核心:三段式紀律的價值是把「概念 → 案例 → 操作」三層分離、讓讀者依層級理解。段首被 case 引用取代會推翻商業邏輯先於 case 的原則、是 LLM 寫教學內容的系統性傾向。
#report #事後檢討 #工程方法論 #writing #case-driven #case-first-workflow