寫作 | Tarragon

"寫作"

2026-04-29 正向改寫要保留對照論據、不能空降結論把「X、不是 Y」改成正向陳述時、若直接刪除「不是 Y」會讓結論失去推理依據、變成空降斷言。對照論據（Y 是讀者直覺會想到的替代方案）跟結論（X）是同一個推理單元、抽掉一半就不成立。正向改寫的合法做法是補解釋、改成對照表、或保留 Y 當對比錨點 — 直接拿掉是 worst。
2026-04-29 Multi-pass review 的 scope 要蓋『同類風險區』、不是『改動區』做 multi-pass review 時、預設用『我這次改過的檔』當 scope 是便利選擇；但同一原則違反通常分布在整個 corpus、改動區只是冰山一角。Scope 該由『同類風險的內容範圍』決定 — 跑某條原則的 pass、就要掃所有適用該原則的檔、不是只掃我自己改過的。改動區 scope 是 #67 在 review 流程的具體展現、會讓 multi-pass 退化成 self-edit pass。
2026-04-29 適用範圍要展開成 file enumeration、口語描述不夠原則的『適用範圍』寫成口語描述（『所有教學文件的論證段落』）時、執行 review 的人要當場推導『具體哪些檔屬於這個範圍』、推導步驟容易漏；改寫成 enumerated file list（具體列出 file paths）就能避免 enumeration 不完整。Enumerate 的合法形式是『可被 grep / find 重現的具體 file 集合』、不是『口語類型描述』。本卡是 #95 的下游具體化、跟 #82 互補：enumerate 是字面層、enumeration completeness 是行為層判斷標準。
2026-04-30 Metadata surface 要納入寫作 review 範圍寫作 review 的 surface 包含正文與 metadata surface：title、description、frontmatter、heading、link label、MOC 索引條。正文通過 positive wording 或 multi-pass review 只代表 body surface 收斂；讀者入口與索引入口也要跑同一套 frame，才能讓文章在第一眼、搜尋與跨篇路由上維持同一個概念錨點。
2026-04-30 素材庫比例要支撐主情境的反向驗證當文章只展示少量主情境時，素材庫需要保留更多 field cases 或 source cards 來支撐反向驗證、壓力變體與後續擴寫。合理比例是主文章情境 4-5 個、來源素材約 2-3 倍，讓每個主情境背後至少有 2-3 個來源可回查。
2026-05-06 設計檢討用當下三軸論證、不依賴 hindsight 本卡提倡用「當下成本對稱條件下選了限制更高的選項」當設計缺陷的判定方式、避免 hindsight 論述把需求演化誤判成設計缺陷。當下三軸論證（成本對稱性 / 可逆性 / 領域先驗）讓判斷不依賴結局發生、且歸因偏向工具預設與制度而非個人預見性。
2026-05-06 口語化修辭在判斷工具型段落會稀釋技術精度技術文章的「判斷工具型段落」（讀者用來判斷自己 case 的論述）用「一輩子」「碰巧能用」「立刻撞牆」「沒事」這類口語修辭、會稀釋精度。修法是把口語修辭翻譯回技術屬性語言。但 hook / 引言 / narrative 段落用口語仍然合理——這是情境化的取捨、不是精度永遠優於可讀性。
2026-05-06 地區用語對齊：寫作前先確定讀者的中文語料繁中 vs 簡中的用詞差異不只是字形（屏 / 螢幕、視頻 / 影片）、更是技術術語跟業務情境的精度差。寫作前要先確定讀者的中文語料、避免用對方語料中不存在或意思偏移的詞。常見漂移：硬體（屏 / 螢幕）、檔案系統（文件 / 檔案）、概念詞（默認 / 預設）、修辭詞（質量 / 品質）、混雜情境的英文中文比例。
2026-05-06 商業邏輯論述要 self-contained：不依賴 code 才能被理解技術文章在「不放 code 的段落」仍然要 self-contained——商業邏輯論述不能預設讀者已經看過 code、用「那個 payload 第二段」「剛才的變數」這類 reference 等於把理解門檻轉嫁給讀者去翻 code。修法是把 reference 翻譯成「用名詞 / 角色 / 條件描述」的 self-contained 句子、即使讀者跳過所有 code block 也能理解論述。
2026-05-06 Multi-pass review 的 frame 顆粒度盲點：抽象規則 → 具體訊號的轉譯不完整 Multi-pass review 跑了 4 輪、字句層問題（口語修辭 / 地區用語 / 依賴 code / 廢話前綴）仍漏 catch——揭露 frame 顆粒度盲點：抽象規則（如「機會成本語氣」「正向陳述」「最重要的話優先說」）沒被轉譯成具體訊號（如 grep keyword bank：「一輩子 / 碰巧 / 撞牆 / 下次 X 時 / 不是 A 而是 B」）。修法是把每條規則展開成可 grep 的 keyword bank、加 reader simulation 輪、加 self-criticism 輪。
2026-05-19 教材目標先於決策框架教材的核心目標是讓讀者學會某個領域的心智模型、操作語意與演進路徑；服務能力、風險、成本與決策是教學中的必要概念框架。當決策框架取代教材目標，文章會變成選型分析或治理文件，讀者知道怎麼判斷，卻仍缺少領域學習路線。
2026-05-19 教材完整性要用讀者旅程驗證教材完整性要用讀者旅程驗證；章節數、案例數或 vendor 覆蓋度只能判斷素材量。成熟教材要能回答不同讀者從哪裡開始、按什麼順序讀、讀完能做什麼。LLM 與 Go 目錄顯示，讀者旅程、學習梯度與主題導讀是教學設計完成度的核心訊號。
2026-05-19 貫穿式案例是服務教材的教學骨架服務型教材需要一條可重播的貫穿式案例，把資料庫、快取、queue、觀測、部署、可靠性、資安、事故與容量串成同一個服務演進路徑。沒有貫穿式案例時，章節會各自正確但讀者難以理解能力之間如何交接。
2026-05-19 服務頁教材合約服務頁是一篇能獨立教會讀者某個服務能力的教材，產品資訊與選型摘要只是教材材料。成熟服務頁要達到單篇技術教材的討論細節與漸進教學，但章節結構要依分類責任、服務對象與使用情境設計。
2026-05-19 Sibling Coverage Asymmetry Blindspot：Priority 評估漏掉的「對稱性維度」當批量 A 跟批量 B 是 sibling（同類 vendor / 同類角色）、A 後寫超過 B、心智模型容易 collapse 到「A 是 reference / B 是 baseline」、忽略 *B 才應該 ≥ A coverage* 的對稱性 priority。Case：MySQL 18 篇 / PG 11 篇後、推薦下一步把 PG 排除、列 DynamoDB / Aurora / SQLite 等「新領域擴張」、user 自己 catch 才發現 PG 還沒對齊。機制：sequential point-in-time coverage 評估 vs cross-sectional sibling symmetry 評估、後者預設不在 priority 列表維度。修法：priority candidate list 必須跑 sibling symmetry audit。
2026-05-19 Sibling Vendor Cross-Link 雙向性 Audit：寫 Vendor Batch 結束必跑當寫 sibling vendor batch（A vs B）、cross-link 容易單向 — A 提 B 多次、B 沒回提 A、形成 navigation asymmetry。Case：MySQL 18 篇對 PG sibling cross-link 9 條、PG 對 MySQL cross-link 0 條。機制：寫第二個 batch 時 reference 第一個 batch 是自然行為、但 reverse direction 必須主動補。修法：vendor batch 結束跑 bidirectional link audit、`A → B` 跟 `B → A` 對比、缺一邊就補。
2026-05-19 Vendor Feature 時間敏感性：Claim Verification 必跑、寫作日期必標寫 vendor article 時、feature limitation claim（『不支援 X』『最多 Y』『預設 Z』）有時間敏感性 — vendor 持續演進、寫作後 N 個月可能 invalidate 整段 audit 邏輯。Case：PlanetScale FK 不支援是 2022 年的事實、2023 末 Vitess 18 加 FK 支援、寫作時若不 verify、Phase 1 audit「FK audit + 全 drop」整段過時。機制：LLM training cutoff vs vendor changelog 速度差、且 LLM 預設不標 claim 的時間性。修法：每篇 vendor article 標 *Last verified* date、limitation claim 必要時加 *as of N* 註、claim 反轉 invalidates 整段 audit 時必須重寫不是修補。
2026-06-01 字句層 review：keyword bank 命中是候選、不是判決跑了字句層 grep keyword bank、命中『不是 A 而是 B』、卻把它判成『可接受的反例對照』放行；違規由讀者 catch。揭露 keyword bank 的第二層盲點：偵測（grep 命中）跟判定（這個命中是不是違規）是兩個認知步驟、reviewer 容易把命中合理化成合規而放行。判定準則：否定句構若在『建立核心概念』就改正向、只有在『明示反例段落』才保留。另有一類贅語（訴諸群體『很多人卡在』）連關鍵詞都沒有、keyword bank 結構上抓不到、要靠 reader-simulation 語意 pass。
2026-06-01 教材用中性陳述、不對讀者喊話教材的 register 是中性陳述概念、不是對讀者說話。三種對讀者喊話的形式 —— 安撫情緒（很多人卡在）、第二人稱代入（你天天寫）、祈使控制閱讀（先讀懂 / 別搞混）—— 表面不同、共同違反是把讀者當成要管理的對話對象、而非把概念講清楚。問題不在精度（「你天天寫的 int count」精度完全正確）、在 stance。修法是換成中性陳述（常見的 int count）或描述性名詞標題（簽章的型別與名字拆解）。邊界：hook / narrative 段落的輕度第二人稱可幫讀者進入、不一律禁。
2026-06-01 教材給技術理由、不替方案下品質評價教材該陳述「為什麼這樣設計」，不對方案下品質評價。自評誇飾（教科書級 / 堪稱經典 / 完美契合 / 漂亮地解決）讀起來像作者在誇自己方案、傳遞的是滿意度而非概念，且品質評價會頂替掉真正的技術理由 —— 寫了「X 是教科書級的適配」就少寫了「X 為什麼適配」。修法是把評價換成機制 / 條件。邊界：帶判讀條件的適配性陳述（三條件齊備時 HOF 比列舉更省）是判斷標準、不是誇飾，保留。
2026-06-01 教材把設計選擇講成選擇、不講成必然或天性本質主義 / 必然性框架（天生 / 本質就是 / 必然 / 唯一）把一個設計選擇講成自然法則、抹掉設計能動性，讓讀者以為沒得選。它是『機會成本語氣 vs 絕對主義』違反的一個 subtype —— 不是命令式絕對（應該做 X）、而是必然性絕對（X 本來就這樣）、更隱形。sharp feature 是常局部牴觸作者自己在別處的條件性立場。修法是把必然框架還原成條件性：X 在『選了某前提』之後才以此形式成立。邊界：物理 / 法律 / 合規事實可講必然。
2026-06-01 Review 漏抓先分 design gap 與 execution gap、再決定改框架還是改執行 Review 漏抓某類問題時，有兩個不同成因：design gap（框架根本沒有對應 frame）跟 execution gap（框架有 frame、但 reviewer 沒跑）。修法相反 —— design gap 要改框架（補 frame / keyword）、execution gap 要改執行（真的跑完該跑的輪）。診斷前先分清：把 execution gap 誤判成 design gap 會 framework bloat（一直加 frame 卻沒解決偷跑子集）、把 design gap 誤判成 execution gap 會永遠漏同類。常見陷阱是『加 keyword』感覺像進步、但對沒跑的輪毫無幫助。
2026-06-05 教材的『重點 / 總結』段是內容發散的訊號、該重組正文不該補丁教材尾端的『重點』『一句話總結』段、若功能是重述前面已講過的內容、就是正文組織不佳的補丁。讀者需要回頭被提醒、代表概念在正文裡散掉了 —— 該做的是重拆正文段落、把概念在它該出現的位置一次講清、而不是另開總結段替發散的正文善後。判斷標準：刪掉總結段後正文若仍自足、證明總結本就冗餘；若不自足、是正文要重組、不是總結要補。處理總結段內容時先分『提醒 vs 概念』—— 純提醒（養成習慣 / 回頭確認）刪、有概念價值的（為何這樣設計）併回它本該所屬的正文位置。
2026-06-14 register 違規：偵測可機械化、判定要靠文體異源的眼睛寫作規範的違規分兩類：形式違規（emoji / 編號 / broken link）可完全機械判定、該進工具鏈；register / 品味違規（概念前置 / 否定起手 / 喊話 / 誇飾）的判定有不可消除的品味核心。「不是 X、而是 Y」的陷阱是偵測可機械化（grep 抓得到句型）偽裝成判定可機械化、誘導無限投入更精緻的判定方法（grep → 概念位置 → 行為測試）、但判定始終在品味側、始終放水。更深一層：產出這類違規的 LLM 跟審查它的 LLM 共享文體直覺、同源自審對 register 違規有結構上限、加再多輪次都跨不過。結構解是引入文體異源的視角（人類冷讀 / reader-simulation / 對抗文體 reviewer）、並接受 100% 自動 catch 不可能。
2026-06-14 重點優先陳述是跨語言的資訊結構原則、不是中文句型問題正向陳述優先的本質是資訊結構效率：讀者拿到核心概念的認知步驟越少越好。「不是 X、而是 Y」表達能力差、是因為它讓讀者先處理一個被否定的錯誤理解 X 才拿到正確的 Y、重點後置多繞一步。這個缺陷跨語言成立——英文 not X but Y、日文 X ではなく Y 同樣高頻、換語言不打破（證偽過的反例假設）。判別線是「核心概念在不在最前」、統一了 #94（重點先行合法）與 #149（重點後置違規）、且可操作。LLM 系統性放水的根因是高頻偏置（把語料高頻句型評為表達好、高頻不等於資訊結構優、跨語言）。主解是強制執行重點位置判斷標準、#165 的異源視角降為補充。
2026-06-18 多輪審查要有冷讀者 frame：知情 reviewer 看不見行話洩漏多輪審查模擬讀者時要分兩種：知情讀者（讀完全部、走旅程）與冷讀者（經搜尋或直連落在單篇、零脈絡）。知情 reviewer 會自動腦補脈絡，結構性看不見洩漏撰寫者預設前提的行話。原子 / Zettelkasten / glossary 等可被直連抵達的內容，必須額外跑冷讀 frame。
2026-06-18 原子筆記要有向上的議題入口：讀者要知道為何讀這張、何時會撞到承載知識的原子筆記不是字典條目。每張卡（或其上層）要回答「你在討論什麼議題、撞到什麼問題，才需要這個知識」——從情境進入，而非從定義進入。做法是建『議題 hub』上層筆記討論問題、再分流到術語卡，術語卡頂部回指議題。
2026-06-29 查閱型內容的 description 是未來自己的 recall trigger 排錯記錄、工具筆記這類使用者帶著症狀來的內容，它的 description 要讓未來的自己在掃列表時判斷該不該回來讀，本卡處理這一半的寫法與判斷標準；教材那一半另有專卡。
2026-06-25 列舉與數字殘留在定義型文件會製造維護債務定義型文件（規則、規格、常駐名單）中的冗餘列舉（A-G）和描述性數字（9 個函式、428 行）是撰寫過程中的推理殘留——作者先算出範圍再寫定義，但最終文件只需要定義本身。列舉讓每次擴充都要回頭更新引用處，數字讓每次重構都要校準計數，兩者都是維護成本但不增加閱讀價值。判斷標準：如果拿掉列舉或數字，讀者理解不受影響 → 刪除。
2026-06-26 讀者是缺經驗的專業人士、不是外行人技術教材的讀者定位應該是「在這個領域缺乏經驗的專業人士」，不是「完全不懂的外行人」。寫法是補足經驗缺口、不是從零科普。宣導式語氣（跑得好好的、你可能不知道）預設讀者無能，實際上會降低教材的可信度。
2026-06-26 技術教材要內嵌管理層可彙報的資訊技術文章的讀者不只要知道怎麼做，還要能向上彙報為什麼做、花多久、花多少。成本量級、時程估算、進度指標與需簽核的決策點應該嵌在技術段落旁邊，而非集中在另一篇溝通指南裡。
2026-06-26 多輪審查缺 outside-in 讀者 frame：六個系統性盲點 review 框架的所有 frame 從已寫的內容出發（inside-out），缺從讀者完整需求出發的 frame（outside-in）。六個盲點全部由使用者而非 reviewer 發現：宣導語氣、管理層資訊缺失、接手情境遺漏、工具指引缺失、深度不拆分、讀者定位未預設。
2026-06-26 操作指引的「怎麼做」要帶環境專屬的工具路徑操作型教材說「拍下現況」「匯出資料庫」「建立備份」時，不同執行環境（container / VM / 共享主機）的工具路徑完全不同。只寫動作不寫工具，讀者知道該做什麼但做不到。這個缺口在 fact-check 和 steelman 審查裡結構性隱形，因為動作本身在邏輯層是正確的。
2026-06-26 常識是相對於讀者背景的、不是作者背景的知識卡的建卡標準不能用「這個夠不夠常見」——對 PHP 工程師是常識的 .htaccess，對 Node.js 工程師完全陌生；對後端工程師是常識的 DNS TTL，對前端工程師需要解釋。建卡看的是目標讀者群裡最不熟悉的那個人能不能理解，不是作者自己覺得夠不夠普遍。
2026-06-29 一篇文章只承擔一種功能：SOP 跟 retrospective 混寫兩邊都做不好文章同時塞操作步驟（SOP）和批次驗證紀錄（retrospective）時，機器讀者找不到可執行的步驟、人類讀者不知道哪段是給自己看的。
2026-06-29 Report 卡的論述基礎記結論和 evidence 來源、不記檢討過程 report 卡的論述基礎與限制段寫「從哪來、evidence 邊界是什麼」，不寫「怎麼發起的、用了什麼工具分析」。過程是作者的工作紀錄、結論才是讀者需要的判讀前提。
2026-07-03 避免濫用泛用詞：具體詞讓文章更深刻（以「坑」為例）寫作時同一個泛用詞反覆出現、想依情境換成精確詞、或不確定繁中該不該用「坑」時回來讀
2026-07-03 地區慣用語直譯：keyword grep 抓不到、同源讀得懂會放行地區用語不只有單詞漂移（屏 / 螢幕），還有慣用語直譯（拍腦袋 / 靠譜 / 接地氣）。慣用語是開放集合、列舉式的 keyword grep 抓不到片語，且語意讀得懂讓同源審查者合理化放行——跟 register 違規的同源盲區同構。偵測靠在地讀者冷讀，不是把 grep 清單加長。回來讀的情境：擴充地區用語掃描、review 回報字句層 clean 卻被在地讀者抓到用語、判斷偵測缺口是 design 還是 execution。
2026-07-05 教鑑別能力、不教操作流程：知識目標決定文章結構技術文章寫完後讀者該帶走的是判斷能力（面對新情境能自己評估），還是操作步驟（照做能解決特定問題）——兩者需要不同的文章結構。判斷力導向的文章把機制理解當主線、操作當自然推導的結果。
2026-07-05 壓縮結論剝奪推導路徑：威脅、命令、教訓是三種壓縮形式寫完技術文章後發現威脅/命令/教訓式語句密集時，用來診斷是否把推導路徑壓縮成了結論。這是 #150 喊話 / #151 品質評價 / #152 必然框架的共同根因。
2026-07-05 複合問題先拆機制再談交互：多概念教學的展開結構問題由多個獨立概念交互導致時，文章先各自教 A/B/C 的機制再談 A×B×C 交互。讀者理解各元件後交互作用是自然推導的，認知負荷也更低。
2026-07-05 不屬於這篇文章的內容要找出路、不是刪除 Review 發現文章裡有不屬於當前主題的段落時，正確動作是幫這段內容找到該去的地方（另一篇文章、新文章、新分類），不是直接刪除。SRP 違反是路由訊號。
2026-07-05 分類從內容深度浮現、不從規劃建立文章拆分到獨立機制的深度後，主題群聚自然可見，這時建立新分類才有內容支撐。先建空分類再填文章會產生稀疏分類和錯誤歸屬。多輪審查中「多篇文章擠在兜底資料夾」是分類浮現的訊號。
2026-07-07 教學的解法排序依情境適用、不依作者採用順序教學文章介紹多種解法時，把作者自己的採用歷程（原本用 A、後來換 B）寫成價值序列，將先前的解法貶為最後手段。解法排序該依情境適用，不依作者採用時序。
2026-07-08 會誤解處補正向知識、不把誤會當敘事中心教材出現「這是最容易誤解的一點 / 常見的誤判 / 要抵抗…的直覺 / 值得記 / 會困惑的現象」這類把『讀者會誤解』當敘事中心的起手時。這類框架不是澄清、是知識缺口的訊號：若某處會讓人誤解、補救是補上讓誤解無從發生的正向心智模型與機制、而不是提醒讀者一個他本不需要有的困惑。界線是具體第一人稱實測敘事與真實診斷區分（逾時 vs 被拒、症狀層 vs 根因層）保留、只有把假想誤會當主題句起手的才改。
2026-07-09 經驗談來源要重建分析層、不是換敘述口吻把從業者經驗談（訪談、社群貼文、口述）轉成教學文章時，判斷轉換是否到位。經驗談的斷言是從業者壓縮過的結論、素材本身沒有自帶分析層；教學轉換的核心工作是用成本結構、誘因、市場結構把斷言還原成可推導的機制，讓讀者能質疑、能遷移。只做主題分類與書面化，會產出披著教學結構的經驗談。
2026-07-09 審查要有斷言支撐 frame：抓知識類型與分類定位的失配教學內容通過多輪審查後仍被判定深度不足、像經驗談或故事時，診斷審查框架的覆蓋缺口。字句、cadence、讀者旅程、steelman 都在文字表面與結構層操作，對「整個模組是錯的知識類型」結構性不可見。斷言支撐 frame 抽樣核心斷言問「靠什麼成立」、並對照模組跟分類 house style 的知識類型是否一致。
2026-07-09 文章按分析弧拆分、不按來源主題攤平教學模組規劃文章邊界、或發現整個模組讀起來每個主題都淺淺帶過時使用。文章邊界由「一個分析責任走完完整分析弧」決定：情境、機制、量化取捨、判斷標準、失效條件。把來源素材的主題聚類直接當文章邊界，會產出全模組均勻的多主題淺層節奏，沒有一個主題走到判斷力深度。
2026-07-10 教學模組要有推導源頭、不是主題集合規劃或檢討教學模組的整體結構時使用。模組級結構有兩種形態：主題集合把相關主題平行排開、推導體系讓每篇承擔同一個源頭機制的一條展開。分析教學要後者——源頭給各篇判斷標準一把共同的尺，跨篇矛盾才會現形、新篇才有掛載點、完整推導的閱讀路線才成立。
2026-07-10 判斷標準要寫到條件層：維度清單是判斷標準的空殼寫判斷標準段、或審查發現某段「列了要考慮什麼、卻判斷不出自己落在哪裡」時使用。判斷標準有口訣、維度清單、條件層三個成熟度，教學文章要到第三層：讀者判斷得出自己落在哪一個條件、各條件的後果與理由，加上條件失效的情境；驗收用重算測試。條件到行動的逐項對應是 skill 與手冊的形態，不寫進教學文章。
2026-07-13 內容去留由教學目標把關、素材量只調整寫法拆分或收斂討論裡出現「素材撐不起一篇」「等累積再說」時讀：檢查否決是否用錯層——教學目標層的問題被素材量層的答案回掉、討論永遠到不了「怎麼做」
2026-07-13 延伸層內容以讀者問題立篇：自我消解的段落是缺入口的訊號哲學面 / 跨域對照 / 思維模式這類延伸內容不知道該放哪、或延伸段寫成免責聲明式收尾時讀：切分單位是「哪種讀者帶著什麼問題來」、一問一篇、標題寫問題本身
2026-07-20 分析文章開頭定位分析問題、不講創辦敘事寫商業分析 / 案例判讀文章的引言時，如果開頭在講品牌創辦故事而非定位分析問題，讀者要讀完整段才知道這篇要分析什麼
2026-07-20 寫作動機是編輯資訊、不屬正文文章引言出現「因為 A 文章缺了這個分析」「為了補齊系列覆蓋」這類寫作理由時，讀者不在乎文章系列的覆蓋缺口——改回答「這篇分析什麼」
2026-07-20 案例文章跟跨公司比較是兩個分析責任案例分析文章裡嵌了跨公司結構比較時，兩個責任互相擠壓——案例深度被比較段佔空間、比較段被鎖在單一公司的脈絡裡無法擴充；拆成各自獨立的文章後兩邊都能深化
2026-07-20 自審 sweep 的偵測方法要對齊規則類型：grep 對無關鍵詞的規則是看不見、不是 clean 用 grep sweep 對一批內容自我檢查一組規則、要回報某規則 clean 時，判斷這個 clean 是真的沒違規、還是 grep 對這條規則的違反形態本來就看不見
2026-07-20 描述抽象概念要用貼合屬性的謂語：分析角度不會「說話」、證據不會「撐得住」寫作描述抽象概念（分析角度、框架、判讀訊號、證據與論證）時，判斷搭配的動詞與形容詞是真的貼合這個概念的屬性、還是只是順口但語義錯位；以及寫出「撐得住」「扛不住」這類足夠性斷言、而沒說要滿足什麼需求與判斷標準時
2026-08-08 教學與檢討內容寫給帶問題來的讀者，不是要被吸引的聽眾為教學文章、work-log 檢討或 report 卡決定標題形式與敘事視角時使用；或審查時判斷問句標題、懸念段標、第一人稱事件敘事該不該改。判斷標準取決於受眾狀態：讀者自帶問題來，演講技巧服務的是注意力會流失的聽眾。
2026-08-08 讀者重建不了的斷言清單，展開成讀者位置的走查寫作或審查時撞到條列式斷言（三個毛病、幾個問題）、要判斷這段說明讀者是否讀得懂時使用。判定用重建測試：讀者只憑文中已給的材料能不能自己得出每一條；重建不了的清單只輸出了結論，修法是把讀者放到使用位置、逐項給材料走查。
2026-08-12 軸名取了次好的代理變數，而正確的機制寫在括號裡一組判斷標準讀起來都對、套到個案上卻分不開時，判斷問題是不是出在軸的名字——真正在做功的機制常常已經寫在括號或下一句的理由裡
2026-08-17 誇飾的合法性由段落位置的功能決定同一份文件裡、誇飾的合法性會分區——README 的 tagline 可以誇、feature 清單誇一條就失實。審查或閱讀時撞到誇飾、疑似超譯或強度異常的用詞，用段落位置的功能判斷它是合法修辭還是失實訊號；把嚴重的事寫得雲淡風輕同樣失實，強度的要求是對齊。
2026-08-17 語句要在它的消費單位內資訊自足寫或審查會被抽離消費的句子（checklist 項、表格格、判斷標準句、給 LLM 讀的規範）時，判斷句子的資訊量夠不夠。判斷標準是正向的資訊充足定義加抽離重讀；壓縮的合法性由消費單位決定，敘事段可以壓、單句消費位要自足。
2026-08-17 內容超出容器時擴充結構、不壓縮內容寫作時判斷標準裝不進表格格、概念裝不進標題、範例讓段落過長，想裁內容遷就容器時讀。出口在結構層——就地展開、拆卡外部化、或換成指向既有落點的連結；內容量不是可裁的變數，壓縮遷就容器的終點是簡報式文章。
2026-08-25 句子成分缺失會被讀成脈絡不足，而兩者的修法相反冷讀回報讀不懂、審查建議補充脈絡時，用來判斷缺的是背景知識還是句子的主詞受詞，兩者的修法方向相反
2026-08-25 多輪審查要有一輪回到寫作動機，檢查主題有沒有發散多輪審查每輪都在加東西、而每一項單看都正確時，用來判斷文章是否已經離開它原本要解決的問題
2026-08-25 理解檢查用低階 model 取樣讀者的實際理解，不靠單一 reviewer 的判斷要驗文章的脈絡與表達是否會被誤解時，用來決定派什麼樣的 reviewer、問什麼問題、以及判斷標準放在哪裡
2026-08-25 規則要指到一個打得開的東西：名字錯了跟根本沒指名，後果都是那一步不會被執行寫或審一份規則文件時，用來檢查每個步驟落不落得到實體上；也用在規則明明存在、執行卻反覆停在同一步的時候
2026-08-27 撰文脈絡以兩種尺度洩漏，而掃得到的那一種修完之後量測不動把作者的工作紀錄從讀者頁面清掉之後，讀者帶走的東西沒有變多時，用來定位還沒被碰到的是哪一層
2026-08-28 同一個 session 派出的 reviewer 共用它的盲區，規模買不到異源視角跑完多輪審查、字句層掃描回報乾淨，而外部一眼就看到違規時，用來判斷該加輪次還是該換來源
2026-08-30 判斷標準只收表徵，把產生表徵的那個條件從輸入端折疊掉判斷標準寫完、各條件的後果也齊全，而讀者帶著具體個案走一遍卻得不出判定時，用來檢查輸入端少收了哪個維度
2026-08-30 finding 清單列的是抽樣位置，照著逐處修會留下同一類在沒被點名的地方拿到 reviewer 的 finding 清單準備動手修時，用來決定掃描的單位是被列出的那幾處還是那一整類
2026-08-30 文章寫題目本身，不寫作者怎麼認識它、也不寫從它推出了什麼寫完一段而覺得需要說明它為什麼成立、或段標帶著推導的連接詞、或一整節在講比題目更泛的東西時，用來判斷該刪還是該另開一篇
2026-08-31 定位決定體例，而共用的寫作規範會把一個 surface 的體例搬到另一個上同一套寫作規範同時服務 agent 指令、人類教材與程式碼註解時，用來判斷某一條規則該不該套在手上這份稿件上
2026-08-31 串連佔掉的是本篇的篇幅，順序要先自足再往外開門一個內容集合裡各篇互相引用，而單篇讀起來薄、說不出自己要交付什麼時，用來判斷篇幅被鄰居佔走了多少
2026-08-31 #305 基本功能衍生的問題不比進階議題簡單，而進階議題要從它推導規劃教材的深度分配、或決定一個進階主題該從哪裡講起時
2026-09-01 把 description 寫成觸發條件，文章就變成那個問題的答案教材的 description 與文章開場寫成「什麼情況下需要這篇」時，這個框架會反過來決定文章的形狀，本卡處理它造成的知識網絡斷點與改法
2026-09-01 判斷標準指對了路，而它給的理由在這個個案上不成立判斷標準推薦的做法正確、讀者也判斷得出自己落在哪個條件，而想確認它給的理由是不是每個個案都成立時
2026-09-01 稽核推導完整度時，稽核者自己的答案也是待測物拿一道具體題目驗教學集合推不推得出結論、而集合的判斷標準指向另一個落點時，決定該信哪一邊
2026-09-02 逐輪修法掛回原句，累積出來的腫脹只有跨輪比對看得見多輪審查的修正每次都接進被指出問題的那一句時，量什麼、以及為什麼單輪的 frame 看不到
2026-09-02 判斷標準少一條獨立的軸時，它不會停下來，它會篤定地指向錯的答案一條判斷標準拿具體個案走得完、答案也明確時，用來檢查它是不是漏了一條在某些個案上才存在的軸
2026-09-02 標題涵蓋不了內容時，該問的是這篇裝了幾個概念，而範圍寫在開場也算數審查回報某篇的標題只涵蓋了部分章節時，用來判斷該拆分、該放寬標題、還是該在開場補上這篇討論的內容
2026-09-02 從名字出發的術語檢查，抓不到被反覆使用而從未命名的概念外部讀者帶著一個標準術語來問，而剛審完的模組查不到那個詞、卻處處在做那件事時，用來判斷缺口的成因與該補的檢查方向
2026-09-08 壓縮標籤省下的字數是一次，展開成本乘以引用點數替表格列名、欄位標籤或章節標題取短名，而那個名字會被別處逐字引用時，判斷它該不該把省略掉的限定語補回來
2026-09-08 讀者定位擋住科普化的同一句話，供應了省略解釋的理由教材裡的基本名詞用縮寫帶過、術語只提而沒有補卡，而作者的理由是讀者已經是專業人士時，判斷那個理由成不成立
2026-09-09 寫出特定實例的值，就取代了讀者本來要做的查證文章要寫某個機型、環境或安裝的具體值與處理方式，而讀者本來應該在自己的系統上查它時，判斷該不該寫進去
2026-09-11 拆分產生的缺陷落在檔與檔的交界，每一份單獨讀都是對的一份文件拆成多檔之後，讀者回報跳躍、割裂、或不知道還有哪幾份檔案時，用來找出拆分自己造出來的那幾類缺陷
2026-09-11 修法要落在缺陷所在的那一層，而看起來做得最多的那個修法通常不在審查指出一處歧義、修過之後同一處又被指出來時，用來判斷修法動到的是不是缺陷所在的那一層
2026-09-22 教學定位被讀成教室講課，產出的是經營注意力的障礙而非有序的說明技術文章或 work-log 的開場寫成情境故事、正文裡省略主詞受詞、或出現模擬互動的語句（這裡容易搞錯、該問誰、前面提到的四種）時回來讀
2026-09-22 先備知識與環境陷阱跟在所屬的指令旁邊，用結構承接操作指引裡的補充說明（為什麼要這樣做、特定環境的陷阱）散落在正文裡像是講課時的即興補充時回來讀
2026-09-22 口語的語氣強調寫進文章後變成讀者的解碼成本技術文章裡一句話的受詞或量詞單位在領域裡不存在（「一個字都沒有執行」的字、「走到解析」的走到）時回來讀
2026-09-22 技術文章的每一句寫清楚誰對什麼做了什麼事一段技術說明讀完之後讀者說不出是哪一層在做事、對什麼資料做、做完變成什麼時回來讀
2026-09-22 示範指令的引數要說明，寫成字面值的那些最不像需要說明文章的指令讀者照抄跑得起來、換成自己的路徑或套件時卻不知道要改哪裡、也看不出兩種寫法差在哪時回來讀
2026-09-22 並排多種做法時，比較的軸要落在讀者接下來要交出的那份產出上教材並排了幾種做法、每一欄都正確而且量測過，讀者讀完仍不知道自己該怎麼辦時回來讀
2026-09-24 正文裡的對象要用它是什麼來命名，序數、計數與字母代號是作者腦中的索引文章裡出現「三支」「七步」「第三步」「第一級」「前提一」「A1 與 C」這類名字，讀者要回頭翻才知道指什麼時回來讀
2026-09-24 摘要另一份內容時寫出成員，計數只告訴讀者清單有多長介紹另一篇、寫 description、填目錄頁的交付欄時，寫出了「四個追問、三種寫法、四類邊界」這種句子，讀者仍要點進去才知道那些是什麼時回來讀
2026-09-24 逐段審查量讀者學不學得會，指稱解不解得開要問沒讀過前文的讀者教材走過逐段審查，仍殘留隔好幾段的「上面那一組」「兩者」、計數對不上成員、或解法只對列出的一部分成立的段落，而審查回報幾乎沒有這些項目時回來讀
2026-09-24 名詞要求的「誰的、什麼的」也是槽位，論斷句與段標的省略藏在名詞裡句子主詞謂語都在、讀起來通順，而讀者說不出「誰的輸出」「什麼的來源」；或段標、總結句用了只寫在目錄頁的框架詞時回來讀
2026-09-29 切開一個集合之前先寫切分的依據，再替每一塊命名；「一部分」「另一半」是還沒抽出來的變數文章用「一部分交得出去」「交不出去的那一半」「那一側」指稱一個被切開的集合，讀者說不出每一塊是什麼、為什麼這樣切時回來讀
2026-09-29 散文裡夾了一段程式，就把程式與逐行解釋移進區塊；推導留在散文一段散文把同一段查詢或指令的條件、子句、輸出一個個用行內程式碼嵌進句子，或描述一段頁面上沒出現的程式變體（改一列資料之後回什麼），讀者要在腦中把程式組回去時回來讀
2026-10-02 教學文章的標題與段標寫主旨，結論留在正文裡推導走完的位置替教學文章定標題或段標、或要拿另一篇的標題當連結文字時回來讀；也用在審查時撞到「X 決定 Y」「X 不是 Y」形式的標題。規則是標題與段標只寫對象與涵蓋的內容；檢查方法是把標題當成別篇裡的連結文字讀一次。
2026-10-06 借用中文日常詞當術語譯名的誤讀：以 cursor 譯成游標為例的譯名選法與量測要替一個外來的技術術語選中文譯名、或審查時看到一個譯名讀起來像日常用語時回來讀；也用在考慮「乾脆只寫英文」的時候。內容是日常詞譯名為什麼會被讀成另一個東西、只寫英文為什麼不是修法、怎麼找替代譯名並用術語探針量測，以及量測結果裡模型語料造成的偏差。
2026-10-14 正反問句嵌進句子當名詞：位置判讀、與高頻句型的撞形，以及謂語要寫出的判斷標準句子裡出現「連不連得到」「對不對」「讀不讀得到」這類正反問句，讀者覺得拗口卻說不出哪裡不對，或翻成英文時才發現原文沒說清楚判斷標準時回來讀
2026-10-14 排比句的變動格填了話題自己的定義：同義反覆的形態、兩個檢查與改寫方向一句工整的排比讀起來像在交代分工，讀者卻覺得是廢話；或總覽句先把各類缺口由誰處理排成並列句、具體的對象要到後文才出現時回來讀
2026-10-14 「問題」與「回答」當框架詞：一個詞蓋住問句、故障、議題與需求，以及系統被寫成應答的一方文章用「X 回答的問題是」「這是 Y 的問題」組織內容，讀者分不出那個「問題」是一句問句、一個故障、一個要處理的事項還是一項需求；或審查時看到監控、檢查、元件被寫成在回答問題時回來讀；「撐得住」這類足夠性斷言與「對不對」這類評價謂語是同一類詞
2026-10-14 物理動詞佔住的內容：撐、扛、垮、掛在、站得住各自要寫出什麼，以及這些詞在負載情境裡的意思文章裡出現「撐得住」「拖垮」「扛起」「掛在」「站得住」這類借來的物理動詞，要判斷它佔住的是需求、失效的形態、關係、負擔還是可信度，以及改寫時要寫出什麼；或要處理負載情境裡「撐不住」「壓垮」「撐過尖峰」這類句子時回來讀
2026-10-19 段落的範圍由標題與所屬分類共同限定：標題沒寫出分類的條件時，題目範圍檢查放行的那一節一節內容落在標題的範圍內、各項檢查也都通過，而讀者指出它不屬於這個分類；或標題沒寫出分類已經限定的條件（語言、層級、處理對象）時，用來判斷那一節該留在原處還是移到另一個分類
2026-10-19 文件的職責數從修改紀錄讀出：長度當拆分訊號的誤判、加段落之前的檢查與拆完之後的外部引用要往既有的文件或規則檔加一節、懷疑一份文件塞了多種職責、或剛拆完一份文件要處理原檔與指向它的引用時，用來判斷是否拆分、沿哪條軸拆與拆完要補什麼
2026-10-19 以對象起手的句子：缺少的動作者、時機與觸發原因，審查修正寫出這類句子的成因與偵測方式句子以被討論的對象起手（「一個檔案被幾個需求修改過」「一個檔案同時對上兩列時，依……來分」），讀者說不出是誰在做這件事、在工作流程的哪一步碰到、為什麼會發生，或審查修正補進去的句子讀起來像條文時回來讀
2026-10-25 規則檔的修法逐輪製造新歧義：程序寫成有測試的工具，共用的概念只定義一次規則檔經過多輪審查、每一輪都照 finding 逐條修補，而下一輪的歧義數不降反升時讀；也用在規則檔裡寫了 shell 管線或 git 程序、同一個例外在幾條規則裡各寫一份、或出現「只有兩種情形」這類宣告的時候
2026-10-25 規則的修法逐句驗證會通過、套到案例上才互撞：改完才查得到的事實管不了動手之前的步驟，修完要拿任務重走照審查或探針的 finding 修規則檔，下一輪的新歧義大多落在這一輪剛寫的句子上時讀；也用在要定義一個給好幾條規則共用的概念、或要替一條規則補例外的時候
2026-10-27 同一個工具在兩個模組各有一頁：兩頁從工具往外寫就會重疊，從各自模組讀者要做的判斷往回推才分得開，原封不動搬到另一頁仍成立的段落抽成知識卡同一個工具或元件在兩個教學模組各有一頁，兩頁的段落大量重疊，正在考慮合併成一頁、指定其中一邊當唯一的家，或判斷兩頁各該寫什麼時讀
2026-10-29 結構譬喻頂替主詞與動詞：分類寫成「線」、書「承接」一個「面」、讀者「走」到某篇、判定「住在」某篇，新稿與集合裡的舊文章用的是同一組詞一個內容集合用「這條線」「各接一個面」「由 X 承接」「走 [某篇]」「判定住在某篇」「X 的決定落在 Y 上」這類詞組織自己，或要以集合裡的舊文章為範本寫新文章時讀
2026-10-29 替讀者假設他可能沒經歷過的情境或頻率：「這個位置每週都會遇到的那場對話」把一個條件寫成讀者的日常，改寫成職責或條件並寫出發生的前提文章寫出「每週都會遇到」「躲不掉的」「天天開會」「你一定遇過」這類替讀者決定他經歷過什麼、多常發生的句子，或用一個情境帶出一本書的用途時讀
2026-10-19 依職責拆分文字文件：修改紀錄的訊號、切法與拆完之後的引用規則文件、操作手冊與範本的拆分：從版本歷史讀出一份文件承擔幾種職責，依職責而非長度決定切法，原檔保留導覽表、同一條規則只定義一次，以及拆完之後更新引用與檢查新檔之間的指引缺口
2026-09-01 教學文章的脈絡：一篇的位置、就地自足，與綁在模型上的串連從料理與 SQL 兩次全分類改寫抽出的教學寫法：一篇文章在序列裡的位置怎麼交代、哪些材料非得就地寫進去、跨篇連結該綁在什麼上面，以及這些為什麼靠自審檢查不到
2026-07-20 SOLID 寫作方法論：程式結構原則在文章體系的映射文章、模組、系列的結構決策（該不該拆篇、擴充點放哪裡、引用往哪個方向、讀者怎麼分流）缺乏統一判斷標準時，用 SOLID 原則的寫作映射做結構檢查；含五原則的寫作定義、實證案例、違反訊號與類比邊界
2026-07-20 術語解釋分層方法論：基線宣告與行內 / 連卡 / 裸用三級文章裡的專業術語該解釋到什麼程度、入門篇跟深度篇的解釋量怎麼分級時，用「術語角色 × 前置知識基線」判定矩陣決定行內展開、連知識卡或裸用；含基線的操作化定義、SOLID 對應、缺卡 audit 流程與 financial-analysis 模組的實測
2026-03-12 經驗分享文章的寫作準則整理自測試經驗記錄的多次修改過程，歸納六條寫作準則與檢查清單，避免常見的語氣、敘事與技術描述問題
2026-03-04 規則文件的精簡：用 Progressive Disclosure 分出常駐內容與參考細節規則文件膨脹之後的精簡：Progressive Disclosure 的四層分法（快查表、強制規則、決策流程、參考細節）、把參考細節移出常駐文件的做法、一次規則文件精簡的前後量測，以及過度精簡、只按章節切開與移出後未留入口這幾種失誤