"寫作規範" 2026-06-11
引用章節用語意標題、不用位置編號:編號是結構排列的 derivation、會隨版本漂移
跨段落、跨檔引用結構單位(章節 / 階段 / 條列項)時、引用語意標題(副標題)、不引用位置編號(Stage 3、第 5 章、第 3 點)。編號是「目前結構排列」的 derivation、不是 fact;結構重排時編號全部位移、引用點不會報錯、而是 silent 指向錯的內容 — 比 broken link 更難偵測。標題的存在意義就是承載可被引用的語意。是 #44 SSoT 在結構引用維度的實例、#93 identifier-as-fact 家族的 sibling、#84 命名承載語意的引用面延伸。 2026-06-11
集合命名用角色、不內嵌數量:「核心七問」的七是成員數的 derivation、加一問就全面失真
「核心七問」「成長六階段」「四大支柱」這類名稱把成員數量烤進名字裡 — 數量是集合當前成員的 derivation、不是集合的語意身分;成員增減時名稱失真、且名稱是被複製最多次的字串、缺陷隨每次引用繁殖。修法:命名只承載角色與層級(核心問題 / 次要問題 / 撞牆階段)、數量讓清單自己呈現。本卡是 #155 的命名端 sibling(#155 修引用端、本卡讓「語意標題是穩定錨」的前提真正成立)、#44 SSoT 在名稱內容的實例、#84 命名檢驗的數量維度。 2026-06-11
跨 surface 同主題內容要重新語境化、不是搬運:逐字相同句是未語境化的訊號
同一個原則要同時存在於兩個 surface(教材章節與 agent 協議、blog 卡與 skill 卡)時、規範說「各寫一份、語境化在各 surface 內」— 語境化的可操作判準是:句子要跟著該 surface 的讀者與用途改寫、兩邊逐字相同的句子是未語境化的候選訊號、命中後逐處判讀。逐字搬運讓兩份內容形成沒人宣告的隱性同源、改一邊另一邊 silent 漂移、且兩邊都沒有為自己的讀者最佳化。 2026-06-11
摘要壓縮可以丟細節、不可以改模態
description、索引 hook、目錄註解這些壓縮層在濃縮規則時、最容易丟失的是約束的模態 — 「可延後、但不可沉默」是帶條件出口的設計、壓成「不可跳過」變成絕對禁令。模態失真比內容遺漏更糟:讀者從壓縮層建立的預期跟本體矛盾、規則的彈性設計(出口、條件、記錄義務)被摘要抹掉。壓縮丟細節是本職、丟模態是失真 — 判準是讀者只依摘要行動、會不會做出本體不要求、或錯過本體允許的事。 2026-06-11
引用卡片用被引卡自己的分類詞彙:改寫對方的 taxonomy 是隱性錯引
宣告「本卡是 X 卡在某維度的延伸」時、描述 X 卡的詞彙要用 X 卡自己的分類體系。被引卡把 link label 歸在 navigation surface、引用方寫成「metadata surface 的一種」— 關係精神成立、詞彙錯位:讀者循連結過去、發現被引卡的分類表跟引用句對不上、引用的可信度連帶整張卡的可信度一起折損。引用前重讀被引卡的分類段、用它的詞彙描述它。 2026-04-17
技術文章撰寫規範
技術文章的結構準則:階段分層、商業邏輯先於 CASE、用內在屬性評估、事後檢視看判讀品質。附正反例對照。 Tarragon (CC BY 4.0) | 使用 hugo 製作