寫作規範 | Tarragon

"寫作規範"

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-07-03 路由條目要自包含：跳轉單位不依賴鄰條上下文路由段落（下一步 / 依情境讀法 / MOC）的每條 bullet 是獨立跳轉單位、讀者只讀命中自己情境的那條；用「同篇 / 上一條 / 前述文章」指代鄰條的目標、或為了避免重複連結而壓縮引用、會讓讀者在錯的文章裡找不到目標。拆分判準是讀者情境數、不是目標文章數 — 兩個情境路由到同一篇文章時重複完整連結合規。是 #155 引用錨點在「容器層」的 sibling、#113 self-contained 在 navigation surface 的對應。
2026-08-17 同一個對象被兩篇各自分解一次時，不相容會長得像互補兩篇平行章節各自給同一個對象一套階段表、欄位組或分類法時，判斷它們是分工還是衝突。判準是雙向對映與動作測試；互相連結、語彙不同、各自宣稱處理另一半，都不是分工的證據。
2026-08-19 入口由違規形態寫不寫得成 pattern 決定，佔比只決定能不能原樣進清單某個用詞規則已經有 grep 清單、而漏抓的實例一直從外部指正進來時，用來判斷該擴充清單還是該換偵測方式
2026-08-21 敘事的解碼材料要在讀者已讀的文本裡，不在作者的地圖裡教學敘事出現不具名的指涉、只給一面的對比或留給讀者自推的結論時，用來判定哪些壓縮手法把解碼成本轉嫁給了讀者、以及各自怎麼展開
2026-08-21 收錄取捨的結果進正文，判準運算不進策展型內容（書單、精選、系列）的條目裡出現「按某判準仍不到否決」「雖然有此缺點但仍收錄」這類句子時，用來分辨哪些取捨資訊該給讀者、哪些屬編輯後台
2026-08-21 教學內容不預設考核情境，檢核動詞用識別與應用的動詞教學文字用「說得出 / 答得出」檢核讀者或團隊的能力時，用來判定這個對答框架在描述的情境裡存不存在、以及該換成哪一類動詞
2026-08-21 寫作除了表達意義，還要設計閱讀的節奏、壓力與引導文章意義正確、審查也回報看得懂，讀者仍反應讀起來累或跟不上時，用來診斷節奏、壓力與引導三個閱讀過程的設計面
2026-08-24 書單條目引導知識需求，不寫書評觀察書單或任何策展條目裡出現厚薄、頁數、作者姿態、文筆這類對象觀察時，用來判定這個資訊改變讀者的哪個決定、改變不了就不進條目
2026-08-24 評價由讀者自己形成：寫作交付材料，不交付速成印象文章或註解裡出現「優雅、出色、經典、值得、必讀」這類評價語時，用來判定它是可檢驗的取捨陳述還是速成印象、以及怎麼換成讓讀者自己形成評價的材料
2026-08-24 AI 生成的內容不虛構經驗與出處 AI 生成的文章出現第一人稱團隊經驗（我們團隊曾經）或精確出處宣稱（某書第 N 頁寫道）時，用來判定它是可指認的事實還是被文章形態需求生成的虛構
2026-07-28 教學模組的 Backlog 段格式規範要在模組大綱記錄未完成工作、或要跨模組盤點還有什麼沒寫時，用來決定段名、欄位與哪些內容不進 backlog
2026-04-17 技術文章撰寫規範技術文章的結構準則：階段分層、商業邏輯先於 CASE、用內在屬性評估、事後檢視看判讀品質。附正反例對照。