<?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/%E7%B4%A2%E5%BC%95/</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/%E7%B4%A2%E5%BC%95/index.xml" rel="self" type="application/rss+xml"/><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>