<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>教學模組 on Tarragon</title><link>https://tarrragon.github.io/blog/tags/%E6%95%99%E5%AD%B8%E6%A8%A1%E7%B5%84/</link><description>Recent content in 教學模組 on Tarragon</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><copyright>Tarragon (CC BY 4.0)</copyright><lastBuildDate>Fri, 03 Jul 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://tarrragon.github.io/blog/tags/%E6%95%99%E5%AD%B8%E6%A8%A1%E7%B5%84/index.xml" rel="self" type="application/rss+xml"/><item><title>#205 合成章的引力：框架章會把主寫章的案例細節吸走</title><link>https://tarrragon.github.io/blog/report/synthesis-chapter-gravity/</link><pubDate>Fri, 03 Jul 2026 00:00:00 +0000</pubDate><guid>https://tarrragon.github.io/blog/report/synthesis-chapter-gravity/</guid><description>&lt;h2 id="論述基礎與限制">論述基礎與限制&lt;/h2>
&lt;p>evidence 來自一個 10 章教學模組的跨章一致性 review：SSoT map 在寫作前明文定了 11 條「frame 對唯一主寫章」的分派、review 抓出 6 個 High 級重複展開 issue、其中 4 個的重複端都是同一章 — 模組的開頭框架章（從全案例庫合成推導、自身沒有專屬案例）。本卡限於「教學模組內含合成型章節」的情境；單篇文章或無合成章的模組不在範圍。&lt;/p>
&lt;h2 id="情境">情境&lt;/h2>
&lt;p>跨章節教學模組的第一章常是「框架章」：從整個案例庫合成出全模組的判讀框架（成本結構、判準軸、分類法）、自身沒有專屬案例、案例支撐標「合成（全庫）」。SSoT map 把各案例的完整展開分派給下游主寫章（版本機制歸版本章、清單歸紀律章、事故時序歸冪等章）、框架章理應只引用。&lt;/p>
&lt;p>實際寫作時、框架章的每個論點都需要例證、而全庫最強的 anchor 案例正好都能當它的例證 — 寫作壓力讓框架章把轉換層機制、相容清單六項、事故反例逐字吸進來完整展開、下游主寫章寫到同一案例時要嘛重複、要嘛反向寫「機制見框架章」、map 的主寫方向被靜默反轉。&lt;/p>
&lt;h2 id="理想做法">理想做法&lt;/h2>
&lt;p>SSoT map 對合成型章節加一條硬規則：&lt;strong>合成章引用任何案例、只允許「一句話結論 + 數字 + link 主寫章」、案例的機制、清單、時序展開一律留給主寫章&lt;/strong>。框架章的論證強度靠框架本身的推導、不靠例證的細節密度 — 例證細節放在框架章、讀者記住的是案例、不是框架。&lt;/p>
&lt;p>寫作順序上有一個配套技巧：合成章雖然編號在前、初稿可以最後寫或寫完後回頭壓縮 — 主寫章都成形後、合成章「該壓到多薄」有明確參照。&lt;/p>
&lt;h2 id="沒這樣做的麻煩">沒這樣做的麻煩&lt;/h2>
&lt;ul>
&lt;li>同一案例的機制描述在兩章逐字重複、後續修正要改兩處、必漏一處。&lt;/li>
&lt;li>下游主寫章被迫反向 link 回框架章、map 記載的方向跟正文相反、下一批寫作者按 map 找主寫位置會找錯。&lt;/li>
&lt;li>跨章 review 的重複展開 issue 集中湧現（實測 6 個 High 有 4 個同根因）、修正時要做「搬回 + 壓縮 + 回填索引」三段工、成本遠高於寫作時守住。&lt;/li>
&lt;/ul>
&lt;h2 id="判讀徵兆">判讀徵兆&lt;/h2>
&lt;ul>
&lt;li>模組裡有任何一章的案例支撐標「合成」、且它的初稿字數逼近或超過主寫章 — 引力已經發生。&lt;/li>
&lt;li>寫合成章時發現某段「需要一個好例子」、而想到的例子在 map 上分派給別章 — 這一刻就是規則生效點：寫一句話 + link、不寫細節。&lt;/li>
&lt;li>Review 前自掃：對每個 anchor 案例 &lt;code>rg&lt;/code> 它的關鍵數字（如「100 個升級」「1.4%」）、命中超過一章即候選。&lt;/li>
&lt;/ul>
&lt;h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係&lt;/h2>
&lt;ul>
&lt;li>&lt;a href="../single-source-of-truth/">#44 Single Source of Truth&lt;/a>：本卡是 SSoT 在「章節 × 案例」矩陣上的具體失效模式 — map 是 SSoT 的宣告、合成章引力是宣告被寫作壓力靜默推翻的機制。&lt;/li>
&lt;li>&lt;a href="../routing-entry-self-contained/">#204 路由條目要自包含&lt;/a>：對照組 — 路由條目為了跳讀自包含、重複完整連結合規；合成章不能用同一理由重複展開案例、因為案例細節是內容不是導航、重複的維護成本由全模組承擔。&lt;/li>
&lt;li>&lt;a href="../reference-by-semantic-title-not-number/">#155 引用章節用語意標題、不用位置編號&lt;/a>：同族的「寫前產物在寫後失真」問題 — #155 是引用端字串漂移、本卡是主寫方向漂移；兩者都在結構穩定前的高速寫作期發生、都需要寫後對齊輪。&lt;/li>
&lt;/ul></description><content:encoded><![CDATA[<h2 id="論述基礎與限制">論述基礎與限制</h2>
<p>evidence 來自一個 10 章教學模組的跨章一致性 review：SSoT map 在寫作前明文定了 11 條「frame 對唯一主寫章」的分派、review 抓出 6 個 High 級重複展開 issue、其中 4 個的重複端都是同一章 — 模組的開頭框架章（從全案例庫合成推導、自身沒有專屬案例）。本卡限於「教學模組內含合成型章節」的情境；單篇文章或無合成章的模組不在範圍。</p>
<h2 id="情境">情境</h2>
<p>跨章節教學模組的第一章常是「框架章」：從整個案例庫合成出全模組的判讀框架（成本結構、判準軸、分類法）、自身沒有專屬案例、案例支撐標「合成（全庫）」。SSoT map 把各案例的完整展開分派給下游主寫章（版本機制歸版本章、清單歸紀律章、事故時序歸冪等章）、框架章理應只引用。</p>
<p>實際寫作時、框架章的每個論點都需要例證、而全庫最強的 anchor 案例正好都能當它的例證 — 寫作壓力讓框架章把轉換層機制、相容清單六項、事故反例逐字吸進來完整展開、下游主寫章寫到同一案例時要嘛重複、要嘛反向寫「機制見框架章」、map 的主寫方向被靜默反轉。</p>
<h2 id="理想做法">理想做法</h2>
<p>SSoT map 對合成型章節加一條硬規則：<strong>合成章引用任何案例、只允許「一句話結論 + 數字 + link 主寫章」、案例的機制、清單、時序展開一律留給主寫章</strong>。框架章的論證強度靠框架本身的推導、不靠例證的細節密度 — 例證細節放在框架章、讀者記住的是案例、不是框架。</p>
<p>寫作順序上有一個配套技巧：合成章雖然編號在前、初稿可以最後寫或寫完後回頭壓縮 — 主寫章都成形後、合成章「該壓到多薄」有明確參照。</p>
<h2 id="沒這樣做的麻煩">沒這樣做的麻煩</h2>
<ul>
<li>同一案例的機制描述在兩章逐字重複、後續修正要改兩處、必漏一處。</li>
<li>下游主寫章被迫反向 link 回框架章、map 記載的方向跟正文相反、下一批寫作者按 map 找主寫位置會找錯。</li>
<li>跨章 review 的重複展開 issue 集中湧現（實測 6 個 High 有 4 個同根因）、修正時要做「搬回 + 壓縮 + 回填索引」三段工、成本遠高於寫作時守住。</li>
</ul>
<h2 id="判讀徵兆">判讀徵兆</h2>
<ul>
<li>模組裡有任何一章的案例支撐標「合成」、且它的初稿字數逼近或超過主寫章 — 引力已經發生。</li>
<li>寫合成章時發現某段「需要一個好例子」、而想到的例子在 map 上分派給別章 — 這一刻就是規則生效點：寫一句話 + link、不寫細節。</li>
<li>Review 前自掃：對每個 anchor 案例 <code>rg</code> 它的關鍵數字（如「100 個升級」「1.4%」）、命中超過一章即候選。</li>
</ul>
<h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係</h2>
<ul>
<li><a href="../single-source-of-truth/">#44 Single Source of Truth</a>：本卡是 SSoT 在「章節 × 案例」矩陣上的具體失效模式 — map 是 SSoT 的宣告、合成章引力是宣告被寫作壓力靜默推翻的機制。</li>
<li><a href="../routing-entry-self-contained/">#204 路由條目要自包含</a>：對照組 — 路由條目為了跳讀自包含、重複完整連結合規；合成章不能用同一理由重複展開案例、因為案例細節是內容不是導航、重複的維護成本由全模組承擔。</li>
<li><a href="../reference-by-semantic-title-not-number/">#155 引用章節用語意標題、不用位置編號</a>：同族的「寫前產物在寫後失真」問題 — #155 是引用端字串漂移、本卡是主寫方向漂移；兩者都在結構穩定前的高速寫作期發生、都需要寫後對齊輪。</li>
</ul>
]]></content:encoded></item><item><title>#206 預測性索引要有寫後回填輪</title><link>https://tarrragon.github.io/blog/report/predictive-index-needs-backfill-pass/</link><pubDate>Fri, 03 Jul 2026 00:00:00 +0000</pubDate><guid>https://tarrragon.github.io/blog/report/predictive-index-needs-backfill-pass/</guid><description>&lt;h2 id="論述基礎與限制">論述基礎與限制&lt;/h2>
&lt;p>evidence 來自一個 10 章教學模組的跨章一致性 review：22 個 issue 裡有 10 個是同一類 — 模組索引的「案例支撐」欄、章節表的「核心問題」欄、以及 54 個案例檔的「對應大綱」欄、記載的都是採集與規劃階段的預測、正文寫完後沒有回填、與實際引用狀況雙向脫節（漏列實際引用的、保留沒實現的預測）。本卡適用於任何「先建索引欄位、後寫正文」的內容生產流程；正文先於索引的流程不在範圍。&lt;/p>
&lt;h2 id="情境">情境&lt;/h2>
&lt;p>Case-first 流程在寫作前產出兩類預測性索引：模組大綱的每章「案例支撐」欄（預測哪些案例會支撐該章）、每個案例檔的「對應大綱」欄（預測該案例會被哪章引用）。寫作過程中實況必然偏離預測 — 有的案例臨場發現更適合別章、有的章節臨場需要規劃外的案例、有的預測交叉引用根本沒實現。偏離本身是健康的（寫作發現優於規劃）、問題在偏離後索引沒人回頭改。&lt;/p>
&lt;h2 id="理想做法">理想做法&lt;/h2>
&lt;p>把「回填輪」排成正文完成後的固定工序、跟 lint 同級：正文全部完成後、跑一輪機械性對照 — 對每一章 &lt;code>rg&lt;/code> 它實際引用的案例編號、更新大綱的案例支撐欄；對每個被引用的案例、更新它的對應大綱欄；沒被任何章引用的預測交叉、刪掉或明文標「未實現、候選」。回填是純機械工序、半小時內可完成、且可以部分自動化（從正文的引用連結反向生成對照表）。&lt;/p>
&lt;p>回填輪的存在讓寫作期可以放心偏離預測 — 偏離的成本從「記得回去改索引」（必忘）變成「回填輪自然收掉」。&lt;/p>
&lt;h2 id="沒這樣做的麻煩">沒這樣做的麻煩&lt;/h2>
&lt;ul>
&lt;li>索引失真是雙向的：讀者按案例支撐欄找不到宣稱的引用、按案例檔的對應大綱找不到宣稱的章節 — 索引從導航工具變成誤導來源。&lt;/li>
&lt;li>失真 issue 會塞爆跨章 review 的報告（實測 22 個 issue 佔 10 個）、稀釋 reviewer 對結構性問題的注意力。&lt;/li>
&lt;li>拖到 review 後修、每個欄位要先考證「實況是什麼」再改；寫完立即回填時實況還在腦中、成本差一個量級。&lt;/li>
&lt;/ul>
&lt;h2 id="判讀徵兆">判讀徵兆&lt;/h2>
&lt;ul>
&lt;li>流程裡存在「寫作前填的對應欄位」、且流程清單裡沒有一步叫「回填」— 失真已註定、只差被誰發現。&lt;/li>
&lt;li>Review 報告裡「對齊類」issue 佔比超過三分之一 — 缺的是工序、不是 reviewer。&lt;/li>
&lt;li>索引欄位寫著範圍式編號（如 C10-C16）而正文引用是離散集合 — 範圍式標法本身就是預測期的痕跡、回填時改成實際集合。&lt;/li>
&lt;/ul>
&lt;h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係&lt;/h2>
&lt;ul>
&lt;li>&lt;a href="../reference-by-semantic-title-not-number/">#155 引用章節用語意標題、不用位置編號&lt;/a>：同屬「derivation 會過期」家族 — #155 的編號是結構排列的 derivation、本卡的索引欄是寫作實況的 derivation；差別在 #155 靠改引用方式根治、本卡的預測欄位有規劃價值、不能刪、只能靠回填輪同步。&lt;/li>
&lt;li>&lt;a href="../name-collections-by-role-not-count/">#156 集合命名用角色、不內嵌數量&lt;/a>：sibling — 數量內嵌在名稱裡會隨成員增減失真、預測內嵌在索引裡會隨寫作實況失真；兩者的修法同構：把會變的 derivation 從穩定載體裡拆出來、或建立同步機制。&lt;/li>
&lt;li>&lt;a href="../synthesis-chapter-gravity/">#205 合成章的引力&lt;/a>：同一次 review 抽出的伴生卡 — #205 是寫作期的主寫方向漂移、本卡是寫作後的索引漂移；兩者合起來說明 SSoT map 是「宣告 + 寫作紀律 + 回填工序」三件套、只有宣告時另外兩件的缺口各自產生一半的 High / Medium issue。&lt;/li>
&lt;/ul></description><content:encoded><![CDATA[<h2 id="論述基礎與限制">論述基礎與限制</h2>
<p>evidence 來自一個 10 章教學模組的跨章一致性 review：22 個 issue 裡有 10 個是同一類 — 模組索引的「案例支撐」欄、章節表的「核心問題」欄、以及 54 個案例檔的「對應大綱」欄、記載的都是採集與規劃階段的預測、正文寫完後沒有回填、與實際引用狀況雙向脫節（漏列實際引用的、保留沒實現的預測）。本卡適用於任何「先建索引欄位、後寫正文」的內容生產流程；正文先於索引的流程不在範圍。</p>
<h2 id="情境">情境</h2>
<p>Case-first 流程在寫作前產出兩類預測性索引：模組大綱的每章「案例支撐」欄（預測哪些案例會支撐該章）、每個案例檔的「對應大綱」欄（預測該案例會被哪章引用）。寫作過程中實況必然偏離預測 — 有的案例臨場發現更適合別章、有的章節臨場需要規劃外的案例、有的預測交叉引用根本沒實現。偏離本身是健康的（寫作發現優於規劃）、問題在偏離後索引沒人回頭改。</p>
<h2 id="理想做法">理想做法</h2>
<p>把「回填輪」排成正文完成後的固定工序、跟 lint 同級：正文全部完成後、跑一輪機械性對照 — 對每一章 <code>rg</code> 它實際引用的案例編號、更新大綱的案例支撐欄；對每個被引用的案例、更新它的對應大綱欄；沒被任何章引用的預測交叉、刪掉或明文標「未實現、候選」。回填是純機械工序、半小時內可完成、且可以部分自動化（從正文的引用連結反向生成對照表）。</p>
<p>回填輪的存在讓寫作期可以放心偏離預測 — 偏離的成本從「記得回去改索引」（必忘）變成「回填輪自然收掉」。</p>
<h2 id="沒這樣做的麻煩">沒這樣做的麻煩</h2>
<ul>
<li>索引失真是雙向的：讀者按案例支撐欄找不到宣稱的引用、按案例檔的對應大綱找不到宣稱的章節 — 索引從導航工具變成誤導來源。</li>
<li>失真 issue 會塞爆跨章 review 的報告（實測 22 個 issue 佔 10 個）、稀釋 reviewer 對結構性問題的注意力。</li>
<li>拖到 review 後修、每個欄位要先考證「實況是什麼」再改；寫完立即回填時實況還在腦中、成本差一個量級。</li>
</ul>
<h2 id="判讀徵兆">判讀徵兆</h2>
<ul>
<li>流程裡存在「寫作前填的對應欄位」、且流程清單裡沒有一步叫「回填」— 失真已註定、只差被誰發現。</li>
<li>Review 報告裡「對齊類」issue 佔比超過三分之一 — 缺的是工序、不是 reviewer。</li>
<li>索引欄位寫著範圍式編號（如 C10-C16）而正文引用是離散集合 — 範圍式標法本身就是預測期的痕跡、回填時改成實際集合。</li>
</ul>
<h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係</h2>
<ul>
<li><a href="../reference-by-semantic-title-not-number/">#155 引用章節用語意標題、不用位置編號</a>：同屬「derivation 會過期」家族 — #155 的編號是結構排列的 derivation、本卡的索引欄是寫作實況的 derivation；差別在 #155 靠改引用方式根治、本卡的預測欄位有規劃價值、不能刪、只能靠回填輪同步。</li>
<li><a href="../name-collections-by-role-not-count/">#156 集合命名用角色、不內嵌數量</a>：sibling — 數量內嵌在名稱裡會隨成員增減失真、預測內嵌在索引裡會隨寫作實況失真；兩者的修法同構：把會變的 derivation 從穩定載體裡拆出來、或建立同步機制。</li>
<li><a href="../synthesis-chapter-gravity/">#205 合成章的引力</a>：同一次 review 抽出的伴生卡 — #205 是寫作期的主寫方向漂移、本卡是寫作後的索引漂移；兩者合起來說明 SSoT map 是「宣告 + 寫作紀律 + 回填工序」三件套、只有宣告時另外兩件的缺口各自產生一半的 High / Medium issue。</li>
</ul>
]]></content:encoded></item></channel></rss>