首頁 Tags
"原則" 2026-04-26
Feature 操作要跟 Source 同層合成
Filter / sort / count / transform / search 是 stream 操作、必須跟 stream 的 materialization 同層或更上游合成。在下游做 = 操作 subset 不是 stream。本原則跨前端 UI、後端 API、演算法管線通用、不只是視覺層 vs 資料層。 2026-04-26
寫作便利度跟意圖對齊反相關
寫程式時最容易寫出的版本、通常是離意圖最遠的版本。便利度建立在「現有上下文 / 已 materialize 資料 / 已存在 API」上、而意圖對齊需要找到正確的層、處理上游、跨抽象層 — 兩者方向相反。識別這個反相關 = 識別自己掉進「容易寫的陷阱」。 2026-04-26
驗收的時間軸:四個 checkpoint
驗收不是單一動作、是分散在四個時點(寫之前 / 開發中 / ship 前 / ship 後)的累積判斷。每個 checkpoint 能 catch 不同類型的失敗、成本不同。早期 checkpoint 抓越多、晚期 checkpoint 越輕鬆。實務上常常 collapse 成「寫的時候 + ship 後出問題才修」、跳過寫之前 / ship 前。 2026-04-26
Test-First:先看到 RED 才相信 GREEN
一個只看過 GREEN 的測試是「未驗證的訊號」、不是「會抓回歸的測試」。必須先在「該失敗的版本」上看到 RED、再在「該通過的版本」上看到 GREEN — 兩次跑都對、才能相信測試真的 catch 到該 catch 的東西。跳過 RED 等於把驗收標準降到「跑得通」、漏掉「測試自己有沒有 bug」這層。 2026-04-26
URL 是 stateful UI 的儲存層 — 哪些 state 該寫進 URL
互動式 UI 的 state 散落在多層(in-memory / URL / localStorage / server / index)、每層有不同特性。可分享 / 可恢復 / 可導航的 state 該寫進 URL — 不寫進 = silent 把這些特性犧牲掉。本文展開「state 的儲存層選擇」協議與 URL 的具體位置。 2026-04-26
Tab Order = DOM Order = Mental Model 三者對齊
Tab 順序由 DOM 順序決定(除非用 tabindex 強制覆寫)。三者該對齊:DOM 順序、tab 順序、使用者 mental model 的互動順序。三者不一致時、優先重排 DOM 而非用 tabindex — tabindex > 0 是反模式([#52])。 2026-04-26
高 ROI 無外部觸發的工作會被結構性跳過
工作有兩個獨立維度:ROI 高低 + 是否有外部觸發。高 ROI + 無觸發 = ROI 的承諾、拖延的現實。靠紀律不可行 — 結構性偏差需要結構性對策(外部觸發 / CI / hook / 排程 / pair)。本卡是 #67 便利反相關、#68 checkpoint 跳過、#69 RED 跳過的共同上位原則。 2026-04-26
主策略 + 補強策略:選擇不必互斥
多策略並非「五選一」、可分層疊加:root-cause fix(解結構問題) + UX 補強(解使用者感知)通常雙打比單選更穩。判斷標準三條:解不同層 / 沒副作用衝突 / 增量成本可接受。把「策略選擇」預設成單選、會放掉互補可能、產生「結構修了但使用者體驗仍差」或「UX 蓋過去但結構還壞」。 2026-04-26
分批 ship:低風險可見價值先行、結構性下輪
「一次 ship 全部」的衝動 vs 「分批 ship」的設計:判斷標準三軸(使用者可見性 / 風險暴露面 / 驗證需求)。低風險 + 高可見 = 立刻 ship;高風險 + 需驗證 = 下輪。對抗「完整才完整」的全做衝動、避免一次塞太多 review surface 拖延上線。 2026-04-26
決策對話的五個維度:保持完整選擇空間
對話中的「決策」不是單一動作、是多維度選擇空間:呈現格式 / 策略疊加 / 批次邊界 / 時間軸 / 選項類型。預設多半 collapse 到最窄格(開放問 + 單策略 + 一次完成 + 立刻決 + 單選)、塞使用者進最少自由度的盒子。本卡是 #74-#78 的上層串連 — 五張卡各對應一個維度的鬆綁。 2026-04-26
卡片系統的迭代浮現:原子卡 → meta-卡 → reference 三層展開
知識卡片系統不是一次寫成、是 dialogue → 原子卡 → meta-卡 → reference 的迭代浮現。每一輪迭代解決上一輪的 over-fit / under-fit、串連分散的卡片、抽出 meta-原則、最後沉澱成可直接套用的 reference 文件。本卡是 cards-skills 系統設計的 process-level 元原則。 2026-04-26
字面攔截 vs 行為精煉:驗證手段跟錯誤層次的對齊
驗證手段必須跟錯誤層次對齊:字面錯誤(typo / syntax / 缺欄位)用 hook / lint / CI 攔截;行為錯誤(思考偏差 / 判斷錯位 / collapse 反模式)用 multi-pass spiral 收斂。強行用 hook 蓋行為錯誤 = 給出 false confidence、反而比沒保護危險。本卡是 #72 結構性對策在「驗證粒度」維度的 ceiling — 不是所有錯誤都該被攔截。 2026-04-26
Methodology 的 multi-pass 該升級為 pillar 層:核心結構才會被執行
任何「教做事方法」的 methodology / SKILL / playbook、應該把 multi-pass refinement 放在 pillar / 核心原則層、不是放在末尾「附帶提醒」段。Pillar 層 = 結構性必跑、appendix 層 = 看心情選擇 = 永遠不跑。本卡是 #82 行為驗證 + #72 結構性對策在「方法論設計本身」這一層的展現。 2026-04-26
Capability gap 的對策三層階梯:expectation → augment → rebuild
系統有 capability gap(功能不滿足使用者預期)時、對策有三層階梯:L1 expectation alignment(UX hint、訊息精準)、L2 augmenting computation(補一層計算 close gap)、L3 structural rebuild(換 index / engine / 演算法)。三層成本、覆蓋率、脆弱度遞增、不必每次跳到 L3。本卡是 #75 主+補強策略的「不疊加、選層級」變種、跟 #59 五策略矩陣可疊加使用。 2026-04-26
Build-time 預處理 vs Runtime 計算的光譜:何時把成本前置
計算可放 build-time(預處理一次、runtime 0)或 runtime(per query 算)— 兩極之間有 hybrid 段(hot path 預算、cold path runtime)。判斷標準四軸:query 頻率 / dataset 大小 / freshness 需求 / build pipeline 複雜度。Build-time 不是「永遠較好」、freshness / 多樣性高時 runtime 反而對。本卡把 #59 五策略中「query-side pushdown vs client-side fallback」的取捨抽象化、跨領域適用。 2026-04-26
Dataset 規模改變什麼可行:「需要 index」依 scale 而定
工程師習慣以「production scale」為預設、自動假設「O(N) scan 不可行、需要 index」。但小 dataset 內、O(N) 甚至 O(N²) 都 trivial、不該過度工程。本卡列具體 threshold(< 1MB / < 10MB / < 100MB / > 1GB)對應的可行操作、跟「猜測 production scale 過度設計」的反模式對照。本卡是 #43 最小必要範圍在「規模假設」維度的展現。 2026-04-26
升級 trigger 的量化設計:「不夠就升 Y」需要明確的「不夠」指標
「先做 L1、不夠時升 L2、再不夠升 L3」這個分批 ship 順序看似合理、但「不夠」沒量化就會 #72 結構性跳過 — 永遠覺得「再觀察一下」、永遠不升級。本卡定升級 trigger 的量化設計:閾值、觀測窗口、決策週期、自動 vs 人工觸發。預設是寫 L1 ship 時就同步定 L2 升級的 trigger 條件、不是 ship 後才想。 2026-04-28
視覺手段對齊錯誤層次:CSS / emoji 修不到語意 / 邏輯問題
修視覺問題的工具(CSS、emoji、顏色、排版)只能擋視覺層、不能修語意 / 邏輯層。把語意 / 邏輯問題當成視覺問題修 = 蓋住症狀根因不動 + false confidence、跟 #82 用 hook 蓋行為錯誤同骨。三層優先序:邏輯 → 語意 → 視覺、修法從深層往淺層走、不從症狀往回推。本卡是 #82 在「呈現層」的具體實例、是 #83 multi-pass review 缺的 vertical 軸。 2026-04-28
URL slug 必須顯式定義為 fact:跨工具 identifier 用單一定義源
URL slug 在 Hugo 預設下從 title 自動推導、在 mdtools lint 下從檔名讀、在跨檔連結時又要寫第三個值 — 一個 identifier 散落在三個推導鏈、典型 SSoT 違反。當多個工具共用一個 identifier、推導不一致 = silent broken link。修法:把 slug 從 derivation(runtime 推導)升級成 fact(frontmatter 顯式定義)、檔名 / 連結都基於這個 fact。本卡是 #44 在 toolchain integration 情境的具體實例、是 #82 字面 vs 行為在 identifier 維度的展現。 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-05-01
資安教學的審查標準要對應風險不對稱
一般教學寫不清楚、讀者學不到、損失停在學習端;資安教學寫不清楚、讀者照做後在系統上產生破口、損失轉嫁到生產端。兩者風險不對稱、審查嚴格度應該對應下游實作代價、不是讀者讀懂程度。資安內容的 audit bar 預設要拉到「讀者會 implement」、不是「讀者會 read」、否則所有寫作便利選擇(含糊敘述、省略邊界、引用而不驗證版本)都會 silent 變成實作端破口。 2026-05-01
False sense of security 是資安寫作的主要失敗模式
資安教學內容的失敗模式不是「讀者學不到」、是「讀者以為學到了並照做、實際還有破口」。讀者實作後沒警覺 = 後續驗證、修補、事件偵測都不會被觸發、破口在生產系統長期 silent 累積。識別 false sense of security 句子的判斷標準:讀者讀完後會說「我做了 X 防護所以安全」、卻無法回答「對什麼 threat 安全 / 什麼 deployment 條件 / 什麼前提失效」。 2026-05-01
Threat model 明確性:「防什麼」與「不防什麼」必須對稱
資安 mitigation 的論述要對稱寫「防什麼 threat」+「不防什麼 threat」。只寫前者、讀者會自行 universal 詮釋(防所有相關攻擊)、實際只擋作者腦中 subset、是 false sense of security 的主要產地。對稱論述不是讓文章變負面、是讓 mitigation 的 scope qualifier 顯式化、讓讀者能驗證實作覆蓋邊界。 2026-05-01
Mitigation 對位:防護對應到具體 threat 的驗證
資安寫作裡 mitigation 寫得乾淨不代表對到 threat、必須讓「mitigation X → 防 threat Y」的對應鏈可被反向驗證。常見失效模式:mitigation 攔的是 threat 的 surface artifact、不是 mechanism;mitigation 跟 threat 在不同抽象層;mitigation 假設 threat 已被上層擋掉但上層沒擋。對位驗證的 audit 模板:每個 mitigation 列出「設計攔的 threat」+「驗證 mechanism」+「失效訊號」三欄、缺一即 false sense of security 產地。 2026-05-01
Mitigation 的 context-dependence:deployment 條件改變有效性
同一個資安 mitigation 在不同 deployment / runtime / scale / config 條件下、有效性差異很大、甚至完全失效。寫作時把 mitigation 描述成 universal(「使用 HTTPS 保護傳輸」「JWT 用簽章驗身分」)會跳過 context、讀者實作時用單一條件詮釋、deployment 條件不對時 mitigation silent 失效。每個 mitigation 必須附帶「成立條件」+「失效條件」+「deployment 變數列表」。 2026-05-01
Security 標準引用的時效性與精確度
資安 citation 跟一般技術引用不同——best practice 時效短(MD5 / SHA-1 / bcrypt 100k / TLS 1.0 都曾是 best practice)、原文常被引用扭曲(conditional → unconditional drift)、版本不標 reader 會套用過時 spec。citation 同時涵蓋外部標準(OWASP / RFC / NIST / CIS)跟內部 citation(knowledge-cards / 跨章引用作為 control-of-record);後者因無版本號 anchor 反而更易 silent drift / broken。每條 citation 必須附:版本 / 年份、引用句意可回溯、deprecated / superseded 標記、強度參數對應 actor 能力的 review trigger(外部)/ last-checked + sync owner(內部)。 2026-05-01
Audit recommendation 層級:accept / minor / major / 教錯不可保留
資安 audit 的產出不該是「OK / 不 OK」二選、要分層給 ship 決策用:accept(無 weakness)/ minor revise(補 boundary 級小改)/ major revise(結構性 false sense、需重寫)/ withdraw(教錯主動誤導、必須移除或全換)。前三層對應學術 peer review、第四層是資安 audit 特有——當內容會 silent 把 reader 帶向破口時、保留是淨負面、不存在「先 ship 後改」的選項。 2026-05-01
用 Next-action frame 取代 Disclaimer:把 prohibition 翻成 actionable chain
當 audit / risk 識別 reader 不該做 X、寫作回應若停在 disclaimer 段(告訴 reader 不要 X)、整段自然產出 negative phrasing(不是 / ≠ / 不要)、即使逐句翻正向句法仍是 disclaimer。Reframe 成 next-action 段(告訴 reader 沿 chain 做 Y / Z)整段自然 positive、不需 contrast。Frame 選擇是 #94 正向改寫的上游問題——逐句正向化處理不到 frame 層、reframe 整段才會根治。 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-18
Collapse 是隱形預設:多維空間被壓成單格的三類典型
決策對話、決策呈現、批量輸出三個 surface 都有同一個 pattern — 高維選擇空間預設被 collapse 到 1-2 個窄格、且這個 collapse 因為「便利 / 合規 / 簡潔」被當成中性預設、不被覺察;#80 是 decision surface 上的極致 collapse、#79 是 dialogue 五維 collapse、#123 是 output framing 在 constraint 下 collapse;三者共骨:*某個高自由度空間被便利驅動 reduce 到最少格子*;對策不是去除 collapse、是讓 collapse 變顯性、由設計者決定要 collapse 哪一維、不是預設全 collapse 2026-05-18
寫作 review 是多軸完整性、不是單軸深度
寫作 review 的完整性不是單一軸越做越深、是多軸交集都對齊;#83 frame 軸 + #121 instance 軸 + #97 surface 軸 + #95 scope 軸 + #122 cadence 軸 + #124 timing 軸 + #114 granularity 軸、七軸正交、缺任一軸都會 systematic miss;review 設計時要 enumerate 七軸覆蓋狀況、不是只跑一兩個維度做深;是 #79 五維決策對話在 review 工具設計的姊妹卡 2026-05-19
Process content 結構由最大差異維度決定、不是 universal phased
跨 X process content(migration / upgrade / rollout / playbook)的結構由 source / target 之間 *差異維度組合* 決定、不存在 universal phased 模板;6 種 migration / process type 實證(schema 差 / drop-in / operational / multi-tool / paradigm / topology re-layout)跑出 6 種不同結構;寫作前必須做 *6 維 diff dimension audit* 才能決定結構、跳過會套錯模板 2026-05-19
Data topology 是 process content 的第 6 audit 維度
Process content 的 diff dimension audit 原本 5 維(schema / operational / paradigm / components / application change)漏了 *data topology* — 資料在 cluster / partition / region 之間的分佈拓樸;topology 不在既有 5 維任一個、但決定 re-sharding / partition redesign / multi-region rollout 的結構;本卡擴 audit 到 6 維、新增 Type F「Topology re-layout」結構 2026-05-20
新增頂層 content 資料夾要同步首頁 _index.md 入口
Hugo 不會 auto-list 頂層資料夾、首頁的模組清單是 content/_index.md 的手動 curated markdown。新增 content/<module>/ 後若沒同步加入口、模組在首頁完全不可發現;讀者只能靠搜尋或直接打 URL 才進得去;大分類(如 content/devops/)底下新增或收進來的教學模組,入口同樣要寫進首頁那個大分類底下的子項。本卡把『新增頂層資料夾 + 首頁入口』綁成同 commit 的雙生動作、避免下次再漏。是 #44 SSoT 在『首頁清單』維度 + #97 metadata surface 在『上層索引』維度的具體案例。 2026-05-20
WRAP Widen Options 容易塌成稻草人 framing、要改 evidence weight 結構
WRAP 框架的 Widen Options 段在案例寫作中容易塌成「列爛選項 → 打掉 → 留正解」的修辭結構、變成稻草人 setup。問題不在框架本身、在於寫作時把 Widen Options → Reality Test 當作全文 narrative 主軸。修法是把 Widen Options 從「對抗稻草人」改成「並陳合理因果鏈用 evidence 配重」、Reality Test 從 binary verdict 改成 weight assessment + Falsifier。是 #125 Collapse 在 WRAP 寫作 surface 的具體 instance、#79 多軸決策的姊妹卡。 2026-05-20
WRAP 是寫作者的內部工具、不是文章章節結構
WRAP 框架(Anchor Check / Step 0 / Widen Options / Reality Test / Attain Distance / Prepare to be Wrong / Tripwire)是寫作者背後做 hypothesis 探索與認知偏誤防護的內部工具。當把這些 process 標籤暴露成文章章節標題、讀者會踩三個壞 effect:預設讀者認知、塞滿 meta dialogue、同論點重複預告。修法是把 WRAP 工作內嵌進教學 narrative、章節順序服從教學流程。是 #140 WRAP Widen Options 稻草人的上位原則、跟 #125 Collapse 同骨。 2026-05-20
文章主體要對齊標題承諾、WRAP 內部分析不該喧賓奪主
文章標題對讀者做了承諾、文章主體必須對齊這個承諾。WRAP 內部分析(Widen Options + Reality Test 含 prior 引用 + evidence weight)即使方法論做得好、如果不是標題承諾的內容、就不該佔文章主體—屬於 scope mismatch、跟 process metadata 暴露(#141)的議題分開。附帶議題:當 WRAP 內部分析喧賓奪主、為了支撐 prior 容易引入沒實際出處的 source citation;把 WRAP 內部分析從主體移除、hallucination 風險自然降低。是 #141 的姊妹卡—#141 處理章節標題 surface、本卡處理章節內容 scope。 2026-05-20
外部分析文章要先拆成事實、作者判讀、本文推導
把外部分析師文章轉成教學型商業分析時、原文不是可直接搬進正文的 case fact。寫作者要先把材料拆成三層:可驗證事實、原作者判讀、本文推導。三層混寫會讓分析師 frame 被讀者誤當事實、也會讓本文自己的結論失去可回溯性。修法是先做 source layering、再決定哪些內容進事件段、哪些內容只作為 hypothesis prior、哪些內容要標為本文合成。 2026-05-20
跨領域分析要先定位讀者層級、再決定術語密度
把商業分析寫給工程背景讀者時、不能繼承原分析文章的 VC / founder / industry insider 讀者假設。跨領域寫作要先定位來源文章與目標讀者的層級差,再決定術語密度、因果鏈步長與例子粒度。若直接沿用高密度商業語言,文章看似專業、但讀者只能記名詞,無法複製判讀。 2026-05-20
外部分析改寫的交付物是可遷移框架、不是風格轉換
把其他分析師文章交給 AI 改寫時、任務目標不能停在語氣、段落與措辭符合本站風格。教學型商業分析的交付物是讀者可帶到下一個事件使用的判讀框架。若只做風格轉換,文章會像摘要或二次評論;若做框架轉換,文章會把事件拆成訊號、機制、風險、預警與下一步路由。 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-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
語意錨用單一字串、同義雙名讓引用修復退回人腦對應
引用錨在語意標題之後、語意名稱本身要是單一字串。同一個結構單位有兩個同義名稱(標題寫「決策記錄 + scaffold 建議」、引用寫「決策收斂階段」)時、語意引用的兩個核心收益同時失效:grep 要掃兩套 pattern 才完整(漏配置一個就漏一半引用點)、重排時的引用修復回到人腦對應。是 #155 引用端、#156 命名端之後的第三塊:命名唯一性。 2026-06-11
決策表兩列同時命中且結論相反:缺的是一個上游區分維度
判讀表 / 決策表的兩列規則被同一個真實案例同時命中、且指向相反結論時、問題通常出在表外:案例承載著兩種身分、而表缺少把身分拆開的上游維度 — 修法是補前置澄清問、把維度抬到表之前;拆不出身分的矛盾才是規則真衝突、回表內改規則。偵測方法是用真實案例 dry-run、不是逐列檢查 — 單列都正確的表仍可能整體矛盾。 2026-06-11
入口分流要放在詞彙牆之前、門外讀者要在門外就拿到岔路
一個模組為「還沒進門的讀者」補了專屬章節、但模組入口頁的開頭全是門內讀者的詞彙、分流句埋在數十行後 — 目標讀者在抵達分流點之前就跳出了。分流的位置要依「最外圈讀者的存活範圍」決定:他讀得懂的區域有多長、分流就要出現在多早。內容寫得再友善、入口斷路就等於沒寫。 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-06-11
多階段流程的 artifact 欄位契約:下游宣稱的輸入要能從上游產出推導、推導規則要明文
多階段流程裡、下游階段宣稱「以上游的 X 為輸入」時、X 需要的每個欄位要嘛直接存在於上游的產出格式、要嘛有明文的推導規則。上游表七欄、下游要求的「失敗語意」欄不在其中也沒有推導說明 — 執行者只能自由心證、每次推得不一樣、漏標的欄位剛好是下游分支的開關。檢查方法是逐欄走查:把下游輸入格式的每一欄、對到上游產出格式的欄或一條明文推導。 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-14
修法是新違規的來源、且常引入同類變體
修法(改寫違規句、補 lint 規則、改 pattern)這個動作本身會引入新違規、而且引入的常是同一類問題的變體——修「不是 X、而是 Y」就暴露「不是 X — 是 Y」、補一個 pattern 就漏下一個變體。所以 review 的 scope 要涵蓋修法後的產物、不只原始內容;停止判斷不能停在「修完這批」、因為修法本身產生新一批。同類變體靠判斷標準(重點位置)收斂、不靠窮舉 pattern;補 pattern 永遠追不上變體(打地鼠)。 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
技術教材要內嵌管理層可彙報的資訊
技術文章的讀者不只要知道怎麼做,還要能向上彙報為什麼做、花多久、花多少。成本量級、時程估算、進度指標與需簽核的決策點應該嵌在技術段落旁邊,而非集中在另一篇溝通指南裡。 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
跨 surface 鏡像的連結轉換 mapping 要窮盡、不能靠猜
skill 鏡像從 .claude/skills/ 複製到 content/skills/ 時,references/principles/ 的相對連結要轉成 /report/ 的真實路徑。mapping table 不完整會讓 CI 反覆 broken link,每次修一批漏一批。窮盡 mapping 的方法是列出所有 principle 檔案再逐一找對應 report 卡,不是靠 slug 精確匹配碰運氣。 2026-06-26
先建 report 卡再進 skill、不是先改 skill 再補 report
report 卡是原則的 SSoT(有情境、根因、理想做法),skill 是 report 的操作化引用。先有 report 才有 skill 引用的依據。反過來做會讓 skill 裡的規則缺乏可追溯的根據,且 report 容易被跳過。 2026-06-26
常識是相對於讀者背景的、不是作者背景的
知識卡的建卡標準不能用「這個夠不夠常見」——對 PHP 工程師是常識的 .htaccess,對 Node.js 工程師完全陌生;對後端工程師是常識的 DNS TTL,對前端工程師需要解釋。建卡看的是目標讀者群裡最不熟悉的那個人能不能理解,不是作者自己覺得夠不夠普遍。 2026-06-29
一篇文章只承擔一種功能:SOP 跟 retrospective 混寫兩邊都做不好
文章同時塞操作步驟(SOP)和批次驗證紀錄(retrospective)時,機器讀者找不到可執行的步驟、人類讀者不知道哪段是給自己看的。 2026-06-29
Log 時間真空是 silent hang 訊號、happy log 是 anti-signal
非互動 process(CI / cron / container init)的最後一行 log 是成功訊息、到被 cancel 之間有大段時間無輸出時回來。判讀靠訊息時序的真空、不是最後一行的成功訊息。 2026-06-29
Report 卡的論述基礎記結論和 evidence 來源、不記檢討過程
report 卡的論述基礎與限制段寫「從哪來、evidence 邊界是什麼」,不寫「怎麼發起的、用了什麼工具分析」。過程是作者的工作紀錄、結論才是讀者需要的判讀前提。 2026-07-03
避免濫用泛用詞:具體詞讓文章更深刻(以「坑」為例)
寫作時同一個泛用詞反覆出現、想依情境換成精確詞、或不確定繁中該不該用「坑」時回來讀 2026-07-03
路由條目要自包含:跳轉單位不依賴鄰條上下文
路由段落(下一步 / 依情境讀法 / MOC)的每條 bullet 是獨立跳轉單位、讀者只讀命中自己情境的那條;用「同篇 / 上一條 / 前述文章」指代鄰條的目標、或為了避免重複連結而壓縮引用、會讓讀者在錯的文章裡找不到目標。拆分標準是讀者情境數、不是目標文章數 — 兩個情境路由到同一篇文章時重複完整連結合規。是 #155 引用錨點在「容器層」的 sibling、#113 self-contained 在 navigation surface 的對應。 2026-07-03
地區慣用語直譯:keyword grep 抓不到、同源讀得懂會放行
地區用語不只有單詞漂移(屏 / 螢幕),還有慣用語直譯(拍腦袋 / 靠譜 / 接地氣)。慣用語是開放集合、列舉式的 keyword grep 抓不到片語,且語意讀得懂讓同源審查者合理化放行——跟 register 違規的同源盲區同構。偵測靠在地讀者冷讀,不是把 grep 清單加長。回來讀的情境:擴充地區用語掃描、review 回報字句層 clean 卻被在地讀者抓到用語、判斷偵測缺口是 design 還是 execution。 2026-07-04
修同質化的手法本身會同質化:均勻套用的生成端修法複製出新模具
為打破一個 cadence 模具而立的生成端規則(例如『段首一律目標詞先行』),均勻套用到整批會收斂成一個新模具、常比原模具更密;因為『我套了破模具規則』的自我感覺遮住『這規則本身就是單一模板』。修法要輪替多個 framing、不換成統一模板;生成端規則要當成 cadence 候選、交給整組跨卡異源 review——同源自審在『已修好』的錯覺下看不到。 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-10
檢查規則的作用域要顯式列舉:零 error 可能是沒被檢查
新增與既有受檢目錄同類的內容目錄時、或工具鏈長期零 error 卻累積出違規時使用。規則的作用域由路徑常數決定、該常數常同時被多個檢查共用,擴作用域會連帶擴語意;作用域是獨立於規則內容的 fact,驗收方式是先確認新規則對已知違規報錯。 2026-07-10
約束要讓違反路徑走不通:只寫在文件層的設計意圖是沒關的逃生口
設計 entity 的變更路徑、或審查「請走 X」類慣例時使用。約束有文件、型別、執行三個落點;只落在文件層的意圖對繞過路徑沒有任何阻力,而註解宣稱的約束比沒有約束更糟——讓讀者以為有防護。判斷標準是讓違反意圖的路徑走不通、不是寫文件請大家不要走。 2026-07-10
逃生口吸收建構路徑的缺陷:修工廠的表達力、不是修拼裝點
同族語意錯誤重複出現、或測試 Arrange 段大量用萬能拼裝工具建物件時使用。全欄位 copyWith 這類逃生口總有辦法把物件拼出來,於是建構路徑的表達力缺陷永遠不被迫修好——需求被逃生口吸收、以語意錯誤的形式在別處復發。修上游的表達力、不是修每一個拼裝點。 2026-07-17
等比縮放不管空間分配:用了 sizing 套件、版面仍會擠壓
用了響應式 / 等比縮放套件、版面仍然溢出或內容被壓縮,懷疑套件失效時使用。換算工具工作在常數層、空間分配發生在 layout 協商層,兩層獨立 — 工具靜默不等於該層無問題,「有用 X 套件」不構成該維度的品質保證 2026-07-20
分析文章開頭定位分析問題、不講創辦敘事
寫商業分析 / 案例判讀文章的引言時,如果開頭在講品牌創辦故事而非定位分析問題,讀者要讀完整段才知道這篇要分析什麼 2026-07-20
寫作動機是編輯資訊、不屬正文
文章引言出現「因為 A 文章缺了這個分析」「為了補齊系列覆蓋」這類寫作理由時,讀者不在乎文章系列的覆蓋缺口——改回答「這篇分析什麼」 2026-07-20
案例文章跟跨公司比較是兩個分析責任
案例分析文章裡嵌了跨公司結構比較時,兩個責任互相擠壓——案例深度被比較段佔空間、比較段被鎖在單一公司的脈絡裡無法擴充;拆成各自獨立的文章後兩邊都能深化 2026-07-20
自審 sweep 的偵測方法要對齊規則類型:grep 對無關鍵詞的規則是看不見、不是 clean
用 grep sweep 對一批內容自我檢查一組規則、要回報某規則 clean 時,判斷這個 clean 是真的沒違規、還是 grep 對這條規則的違反形態本來就看不見 2026-07-20
知識卡的缺 / 孤 / 錯住在卡↔文章的關係裡:要從消費側 audit
審查知識卡系統的完整性時,判斷一個卡片問題(缺卡 / 孤兒 / 分類過時)能不能靠單卡檢查或建卡當下的術語掃描抓到、還是要另跑一輪從使用文章反向驗證的消費側 audit 2026-07-20
描述抽象概念要用貼合屬性的謂語:分析角度不會「說話」、證據不會「撐得住」
寫作描述抽象概念(分析角度、框架、判讀訊號、證據與論證)時,判斷搭配的動詞與形容詞是真的貼合這個概念的屬性、還是只是順口但語義錯位;以及寫出「撐得住」「扛不住」這類足夠性斷言、而沒說要滿足什麼需求與判斷標準時 2026-07-21
整合互斥規則集:抽共用 base、按層分離、把衝突顯性化成解析規則
多個規則集 / 契約 / 需求彼此部分重疊、部分衝突、要整合成一套不自我矛盾的規則時,判斷該抽什麼進共用底層、差異怎麼分層、衝突怎麼顯性化,以及為什麼『衝突只剩一組』常是搜尋不完整的錯覺 2026-07-21
承重論點先對抗驗證、再建下游:核心宣稱的錯誤會等比傳播
一批工作建立在某個承重論點(方法論主張、核心假設、共用 spec)上時,判斷該在動筆蓋下游之前先對抗驗證那個論點、還是照常先產出再事後審查;以及為什麼「先寫再 steelman」讓核心錯誤散進 N 個檔 2026-07-21
任務累積成基礎設施前先亮出 anchor:escalation 逐層加工具、anchor 卻最後才浮現
一個任務經過連續幾次「再加一層」的請求(模組 → skill → 審查 → 卡)滾大時,判斷該不該先把 anchor(這東西最終為誰、為什麼而做)講出來、按它決定要蓋多少基礎設施,還是順著每次請求平順執行下去 2026-07-21
承重事實要對到 primary source:自己的舊分析是 secondary、不是 ground truth
分析建立在某個事實上、而那個事實來自二手來源(新聞、彙整站、甚至自己先前寫的內容)時,判斷該不該回到 primary source(原始申報書 / 紀錄)核對,以及更正一個錯誤事實時該驗到哪一層才停 2026-07-21
宣告的組合不等於執行的組合:顯著的那半擠掉費力的那半
同時啟用兩個行為 / 規則 / skill、並宣告「都在」時,判斷該不該在每次輸出點驗證兩半都真的現形——因為顯著省力的那半會執行、費力不顯眼的那半會靜默掉,而自審只查『有沒有宣告啟用』抓不到 2026-07-28
跨模組路由要驗證目的地承接該主題、不只驗證目的地存在
把讀者從本文送到別的模組或章節時,判斷該路由是否成立——目的地存在不代表它承接這個主題,而連結檢查與 review frame 都只驗存在 2026-07-28
判讀層只給機制屬性時,可用程度隨讀者既有經驗遞減
寫判讀 / 選型 / 決策類內容時,判斷它對沒有相關經驗的讀者可不可用——機制屬性要配上「什麼系統會遇到」與「什麼事件會逼出這個動作」才成為判斷標準 2026-07-28
形態讓讀者對號入座,微案例才讓他想像得出後果
教學內容補完系統形態之後,判斷讀者是否還缺「出事會長什麼樣」——用無身分的短敘事補上,而不是搬運真實 case 的帳目 2026-07-28
要求執行者做判定的規則,要一併規定判定留下什麼痕跡
寫下一條「先判斷 X、再依判斷做 Y」的規則時,判斷它可不可證偽——判定過與沒判定過的產物相同時,規則會沿著零後續的那個結論塌陷 2026-07-29
範例讓最後一類出口缺口現形,而盤點要跨兩個階段各跑一次
教學內容補完情境與範例之後,判斷每個被提出的問題有沒有解決出口 2026-07-29
原則層與操作層是兩份會漂移的副本,而漂移只往一個方向
一條原則同時存在於抽象卡片與操作手冊時,判斷執行者手上那一份是不是最新——套用率低看起來像自審失效,實際可能是規則根本沒傳到 2026-07-29
被多篇當成前提的判斷缺的是住址,而每一篇的檢查都看不到
多篇教學內容各自交代了同一個概念的一角時,判斷它該不該有自己的篇章——每一篇都完整,缺口只在把幾篇並置之後才出現 2026-07-30
多次局部正確的修法會合成缺陷,而合成的缺陷對每一次修法的 frame 都不可見
同一份內容經過多輪審查各自修法之後,判斷它有沒有累積出誰都沒看見的缺陷——每一次修法單獨看都正確,缺陷在它們的合成上 2026-07-30
推翻一個假說之後,替補者是在驗屍的空檔裡上位的
剛推翻一個假說、手上已經有替代解釋時,判斷那個替代解釋憑什麼被接受——殺死前任的那個問題,替補者多半還沒被問過 2026-07-31
對當下段落沒有收益的標註不會自發發生
內容裡的數字、事實與判斷標準缺來源、版本或適用邊界時,判斷該補檢查表還是補觸發點——這類標註的收益全部落在未來的讀者身上,不標當下也讀得通 2026-08-03
資料多出一種形狀時,既有分析邏輯靜默換語意
資料模型新增一種列或事件型別後,判斷既有的公式、查詢與聚合是否還在算同一件事——它們不報錯,只是漏掉或重複整類資料 2026-08-03
清單過時的代價要落在精度、不落在覆蓋
判定依賴一份會過時的清單(已知名稱、白名單、簽章)時,決定清單失效之後還剩下什麼——只比對清單的設計會讓偵測能力隨時間下降,而數字看起來變好 2026-08-03
配額耗盡的症狀落在申請最頻繁的元件、成因在持有最久的那個
共享配額耗盡型故障要歸因時使用。症狀的位置由申請頻率決定,佔用量由申請頻率乘持有時間決定,而持有時間主導後者;系統保存的持有者紀錄能把搜尋範圍縮到一個元件 2026-08-07
寫註解的動機是怕被改壞時,要處理的是那個約束、不是那行文字
準備為一段程式寫註解、而動機是怕有人改壞它時使用。註解不參與執行、改壞的當下不產生訊號;防護需求要先問這個約束能不能被消除,不能消除才交給會發聲的機制,而判定靠當場破壞。 2026-08-08
教學與檢討內容寫給帶問題來的讀者,不是要被吸引的聽眾
為教學文章、work-log 檢討或 report 卡決定標題形式與敘事視角時使用;或審查時判斷問句標題、懸念段標、第一人稱事件敘事該不該改。判斷標準取決於受眾狀態:讀者自帶問題來,演講技巧服務的是注意力會流失的聽眾。 2026-08-08
讀者重建不了的斷言清單,展開成讀者位置的走查
寫作或審查時撞到條列式斷言(三個毛病、幾個問題)、要判斷這段說明讀者是否讀得懂時使用。判定用重建測試:讀者只憑文中已給的材料能不能自己得出每一條;重建不了的清單只輸出了結論,修法是把讀者放到使用位置、逐項給材料走查。 2026-08-08
多份文件必然漂移:同步期待要嘛有機制承接、要嘛明示降級
設計開發流程的文件鏈(proposal、spec、UC、設計文件、追溯表、測試、註解)、或審查一套流程的文件模型時使用。判斷標準是每份文件的同步期待與守護機制是否匹配:期待最新就要有機制守著、沒有機制就降級為一次性 scaffold 或 append-only 記錄。 2026-08-12
軸名取了次好的代理變數,而正確的機制寫在括號裡
一組判斷標準讀起來都對、套到個案上卻分不開時,判斷問題是不是出在軸的名字——真正在做功的機制常常已經寫在括號或下一句的理由裡 2026-08-12
軸是對的,而它底下有一個從未被當成選擇的實作前提
一套判斷標準的推導每一步都成立、結論卻很費力時,判斷費力是不是來自一個沒被寫出來的實作假設——它不是論點,所以對抗性檢驗打不到它 2026-08-17
誇飾的合法性由段落位置的功能決定
同一份文件裡、誇飾的合法性會分區——README 的 tagline 可以誇、feature 清單誇一條就失實。審查或閱讀時撞到誇飾、疑似超譯或強度異常的用詞,用段落位置的功能判斷它是合法修辭還是失實訊號;把嚴重的事寫得雲淡風輕同樣失實,強度的要求是對齊。 2026-08-17
語句要在它的消費單位內資訊自足
寫或審查會被抽離消費的句子(checklist 項、表格格、判斷標準句、給 LLM 讀的規範)時,判斷句子的資訊量夠不夠。判斷標準是正向的資訊充足定義加抽離重讀;壓縮的合法性由消費單位決定,敘事段可以壓、單句消費位要自足。 2026-08-17
內容超出容器時擴充結構、不壓縮內容
寫作時判斷標準裝不進表格格、概念裝不進標題、範例讓段落過長,想裁內容遷就容器時讀。出口在結構層——就地展開、拆卡外部化、或換成指向既有落點的連結;內容量不是可裁的變數,壓縮遷就容器的終點是簡報式文章。 2026-08-17
同一個對象被兩篇各自分解一次時,不相容會長得像互補
兩篇平行章節各自給同一個對象一套階段表、欄位組或分類法時,判斷它們是分工還是衝突。判斷標準是雙向對映與動作測試;互相連結、語彙不同、各自宣稱處理另一半,都不是分工的證據。 2026-08-19
規則用數量當門檻時,先問那個數量在代理什麼判斷
訂規則時想寫「累積 N 個再做 X」的當下,判斷這個 N 是證據本身還是某個判斷的代理。代理型門檻在維護者角度成立、在使用者角度失效,而它代理的判斷通常可以直接檢查。 2026-08-19
查不查的判定要在查之前做完:被丟棄的查詢不會在成品裡留下痕跡
外部查證有配額或時間成本時,判斷哪些事實值得查、查不到該換什麼動作,以及為什麼事後檢討抓不到這類浪費 2026-08-19
可核對的錨要跟它該偵測的狀態連動:會下降只是連動的一種形態
要為一批自己做的判定補一個作者以外可核對的東西時,用來檢查它會不會在該偵測的事情發生時毫無反應 2026-08-19
入口由違規形態寫不寫得成 pattern 決定,佔比只決定能不能原樣進清單
某個用詞規則已經有 grep 清單、而漏抓的實例一直從外部指正進來時,用來判斷該擴充清單還是該換偵測方式 2026-08-19
要維持當期的內容,只能放在更新到得了讀者的載體上
某一類判定怎麼做都會過期、而直覺是把判定做得更細時,用來分辨該加深判定還是該換載體 2026-08-21
舉證要求會把誠實的那個輸出定價成最貴的:檢查梯度指向哪裡
一條規則已經要求判定留下依據、而執行者仍然寫得含糊時讀;問的是這條規則把哪一種輸出定價得最貴 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-08-24
通過關卡不等於通過的是同一個程式
把驗證交給一組自動化關卡、並據此不再逐行讀產出時,用來判斷這組關卡實際固定住了什麼、放過了哪些維度 2026-08-24
機械約束買到被量測的那個數字,代價落在沒被量測的維度
用函式長度、圈複雜度、覆蓋率門檻這類可自動檢查的品質約束時,用來判斷達成它換到了什麼、又付出了什麼 2026-08-25
句子成分缺失會被讀成脈絡不足,而兩者的修法相反
冷讀回報讀不懂、審查建議補充脈絡時,用來判斷缺的是背景知識還是句子的主詞受詞,兩者的修法方向相反 2026-08-25
多輪審查要有一輪回到寫作動機,檢查主題有沒有發散
多輪審查每輪都在加東西、而每一項單看都正確時,用來判斷文章是否已經離開它原本要解決的問題 2026-08-25
理解檢查用低階 model 取樣讀者的實際理解,不靠單一 reviewer 的判斷
要驗文章的脈絡與表達是否會被誤解時,用來決定派什麼樣的 reviewer、問什麼問題、以及判斷標準放在哪裡 2026-08-25
規則要指到一個打得開的東西:名字錯了跟根本沒指名,後果都是那一步不會被執行
寫或審一份規則文件時,用來檢查每個步驟落不落得到實體上;也用在規則明明存在、執行卻反覆停在同一步的時候 2026-08-25
替補結構的豁免來自它修掉的清單,重問殺死前任的問題驗不到它
採納一個為了修掉既有問題而生的替代結構時,用來判斷該怎麼驗它——重問上一輪的問題不夠 2026-08-25
文章的連貫靠鞏固形狀、不靠讀者的記憶:每一節攜帶它與其他節的內容關係
每一節單獨讀都對、整篇卻讀起來割裂,或讀者中斷後找不回脈絡時,用來判斷連貫該由什麼承載、哪些指涉方式把脈絡寄存在讀者的工作記憶裡 2026-08-25
連貫靠句句推進:讀者付出的每一次閱讀成本都要換到內容
段落讀起來不連貫、或發現自己在寫過場句把前文摘一次再出發時,用來判斷哪些字該刪、譬喻該不該留、說明順序該由什麼驅動 2026-08-25
翻譯探針:中文可以不決定的,英文強制決定,多份譯本的分歧就是歧義的位置
中文稿件通過理解探針與多輪審查之後,用來找出詞與語法層還沒收斂的位置;也用在判斷一個詞是不是譬喻、一句話有沒有實際內容 2026-08-26
重算的觸發要綁在會改變那個數字的事件上:內部自洽會蓋住外部失準
頁面上放了一個可以被第三方重算的數字、而它會隨內容變動時,用來檢查什麼事件發生時會有人回頭重算它 2026-08-26
關鍵詞清單換一個體裁就失準,而健康的命中數會蓋住這件事
既有的字句層 pattern 要套到一批新體裁的內容上時,用來檢查它抓到的是不是這個體裁的主流違規形態 2026-08-26
一個詞是不是通用術語,用多份獨立定義的收斂度量,控制詞決定這批算不算數
站內反覆使用的某個詞讀起來可能不通用時,用來量它在目標語域裡有沒有穩定所指,以及量完之後怎麼歸因 2026-08-26
譯者拿得到作者的意圖時,最該被偵測的那一類歧義會被安靜譯對
考慮在寫作當下同時產出中英文來提早抓歧義時,用來判斷哪一類歧義抓得到、哪一類會被這個做法蓋住 2026-08-26
掃描指令壞掉時不會報錯,它報一個數字——而那個數字經常是自洽的
要用一條指令的輸出決定接下來怎麼改一批內容時,用來先確認那條指令量到的是不是你以為的東西 2026-08-27
更新一個可數宣稱時,加法不算重算:總數自洽會讓分項的錯誤通過驗算
一批內容改完之後要更新頁面上那幾個可數宣稱時,用來檢查你做的是重新數一遍還是把新增的加上去 2026-08-27
撰文脈絡以兩種尺度洩漏,而掃得到的那一種修完之後量測不動
把作者的工作紀錄從讀者頁面清掉之後,讀者帶走的東西沒有變多時,用來定位還沒被碰到的是哪一層 2026-08-27
非互動環境裡,要人停下來看的關卡表現成當機,而繞過它的旗標看起來像環境適配
一條會改動別人也在用的東西的指令跑不完、或印了警告仍然成功時,用來判斷剛才繞過的是故障還是關卡 2026-08-28
查不到的反證要換一個維度,同一維度上多加來源只是冗餘
寫下「查不到」「沒有」「不存在」這類宣告之前,用來判斷已經做的反證夠不夠 2026-08-28
同一個 session 派出的 reviewer 共用它的盲區,規模買不到異源視角
跑完多輪審查、字句層掃描回報乾淨,而外部一眼就看到違規時,用來判斷該加輪次還是該換來源 2026-08-30
判斷標準只收表徵,把產生表徵的那個條件從輸入端折疊掉
判斷標準寫完、各條件的後果也齊全,而讀者帶著具體個案走一遍卻得不出判定時,用來檢查輸入端少收了哪個維度 2026-08-30
finding 清單列的是抽樣位置,照著逐處修會留下同一類在沒被點名的地方
拿到 reviewer 的 finding 清單準備動手修時,用來決定掃描的單位是被列出的那幾處還是那一整類 2026-08-30
文章寫題目本身,不寫作者怎麼認識它、也不寫從它推出了什麼
寫完一段而覺得需要說明它為什麼成立、或段標帶著推導的連接詞、或一整節在講比題目更泛的東西時,用來判斷該刪還是該另開一篇 2026-08-31
查證回報的單位是宣稱,而失效的單位可能是整個框架
事實查核回報某個宣稱查不到來源或與來源牴觸時,用來判斷該改的是那一句話、還是建立在它上面的那一層結構 2026-08-31
限制類宣稱的錯誤會自我保存,因為它勸阻的正是唯一能推翻它的那個動作
準備把一次失敗記成「這個工具不能用」「這個站擋抓」「這條路走不通」時,或稽核既有的環境限制清單時 2026-08-31
定位決定體例,而共用的寫作規範會把一個 surface 的體例搬到另一個上
同一套寫作規範同時服務 agent 指令、人類教材與程式碼註解時,用來判斷某一條規則該不該套在手上這份稿件上 2026-08-31
串連佔掉的是本篇的篇幅,順序要先自足再往外開門
一個內容集合裡各篇互相引用,而單篇讀起來薄、說不出自己要交付什麼時,用來判斷篇幅被鄰居佔走了多少 2026-08-31
探針的收斂度分不出無主的詞與已經有主人的詞,要讀有把握那幾份給的定義
術語探針回報某個詞多數人沒把握、少數人有把握時,用來判斷這個詞是沒人用過還是在同一個領域裡已經歸別的東西所有 2026-09-01
把 description 寫成觸發條件,文章就變成那個問題的答案
教材的 description 與文章開場寫成「什麼情況下需要這篇」時,這個框架會反過來決定文章的形狀,本卡處理它造成的知識網絡斷點與改法 2026-09-01
術語探針讀得到定義那個詞的規範檔時,收斂度量到的是詞頻
在有專案規範檔的 repo 裡派 subagent 跑術語探針時,這個配置量到的是提示裡的詞頻,本卡處理它的偵測方式與可用的控制設計 2026-09-01
以名字為鍵的偵測程序,漏掉的正是名字被改過的那幾份
偵測「同一份內容散在幾處」的程序拿一個 slug 去掃時,本卡處理它對不同名副本的系統性失明,以及對應表通常已經在 repo 裡的哪個位置 2026-09-01
reviewer 給的數字要用被審對象宣告的口徑重跑一次
審查報告裡有一條量測要驅動改動時,用來確認那個數字量的是不是被審對象自己宣告的那個範圍 2026-09-01
判斷標準指對了路,而它給的理由在這個個案上不成立
判斷標準推薦的做法正確、讀者也判斷得出自己落在哪個條件,而想確認它給的理由是不是每個個案都成立時 2026-09-01
稽核推導完整度時,稽核者自己的答案也是待測物
拿一道具體題目驗教學集合推不推得出結論、而集合的判斷標準指向另一個落點時,決定該信哪一邊 2026-09-02
逐輪修法掛回原句,累積出來的腫脹只有跨輪比對看得見
多輪審查的修正每次都接進被指出問題的那一句時,量什麼、以及為什麼單輪的 frame 看不到 2026-09-02
真值住在稿件之外的宣稱,讀多少遍都驗不出來
審查一批含引擎輸出、錯誤訊息或量測數字的內容時,判斷哪些宣稱該用讀的、哪些只能用跑的 2026-09-02
收斂度要等預定份數全部到齊才讀,N-1 份看起來一定比實際收斂
多份獨立探針的報告陸續回來時,判斷什麼時候可以開始下結論 2026-09-02
已經記錄過的失效仍然重演,因為記錄住在要人先起疑才會打開的地方
同一類錯誤第二次發生、而它已經寫進卡或 memory 時,用來判斷該補的是記錄還是動作的前置步驟 2026-09-02
每一格都驗過,不代表由格子導出的那句話驗過了
一份逐格核對的查核報告回報全數相符時,用來判斷它有沒有驗到那張表的總結句 2026-09-02
判斷標準少一條獨立的軸時,它不會停下來,它會篤定地指向錯的答案
一條判斷標準拿具體個案走得完、答案也明確時,用來檢查它是不是漏了一條在某些個案上才存在的軸 2026-09-02
標題涵蓋不了內容時,該問的是這篇裝了幾個概念,而範圍寫在開場也算數
審查回報某篇的標題只涵蓋了部分章節時,用來判斷該拆分、該放寬標題、還是該在開場補上這篇討論的內容 2026-09-02
從名字出發的術語檢查,抓不到被反覆使用而從未命名的概念
外部讀者帶著一個標準術語來問,而剛審完的模組查不到那個詞、卻處處在做那件事時,用來判斷缺口的成因與該補的檢查方向 2026-09-02
比對回報零差異時,那個零只證明這個粒度看不到差異
兩個版本的計畫、輸出或掃描結果比對後宣告「相同」,而手上還有一層更細的檢視工具沒跑時,用來判斷這個零差異能不能當結論 2026-09-04
報告被長度上限截斷時,先丟掉的是設計在尾端的那個產出
派出的 frame 其產出排在報告尾端時,用來判斷回收到的報告是不是已經缺了派它的理由 2026-09-04
判斷清單裡有一條永遠不會成立時,「任二齊備」實際上是在三條裡取二
一組並列的停止或放行訊號寫成「任 N 齊備」時,用來檢查有沒有一條在實務上達不成 2026-09-04
散文裡指向一組成員的數字,在結構改動之後不會跟著動
一批內容經過多輪結構改動後,用來找出正文裡指向某一組成員的數字,並決定該把數字改對還是拿掉 2026-09-04
位置指涉用失效條件判,同檔緊鄰而目標不動的那些留著
稿件裡出現「上節」「下方」「末段」這類指涉時,用來判斷哪幾處要換成具名,以及為什麼多數是修法自己寫進去的 2026-09-04
一組並列的括號各裝不同東西時,讀者會先找一條統一規則
一列項目後面接著形式相同的括號時,用來檢查每個括號跟它前面那個詞的關係是不是同一種 2026-09-04
宣稱可機械執行的條文,要先把中文允許不決定的那幾項決定掉
一條規則自稱是存在性檢查或可機械執行時,用來檢查它的量詞與否定轄域有沒有留給執行者去決定 2026-09-04
掃描的作用域會默默對齊「我這次動過什麼」,而該問的是「這個成品是什麼」
跑完一輪全面替換或清理、回報命中歸零時,用來確認那個零涵蓋的是整個成品還是這一輪改過的檔 2026-09-04
要求揭露只擋得住省略,要分層得改成要求分類
一份契約要求執行者揭露某個彙總狀態(零命中、已檢查、無發現)時,用來判斷那份回報會不會把證據力不同的東西寫成同一句 2026-09-04
要交出物件,不要交出關於物件的判斷
一份回報宣稱某件事不可能、超標或不成立時,用來決定該追問什麼才讓那個宣稱可以被驗證 2026-09-04
一次修法會對同一件事寫出兩種形式,而兩種都不命中舊 pattern
一批修法完成、準備收尾時,用來抓出這一批自己引入而類別掃描走不到的形式不一致 2026-09-04
「我以為觀測到的」躲在「引用的」那一欄裡,因為它看起來有來源
要為一份報告的宣稱分配查核責任時,用來檢查分類法有沒有把虛構的觀測歸進可查的那一欄 2026-09-04
代理比本體便宜,所以成本壓力最高的階段一定伸手拿代理
收尾階段反覆出現表面不同的失效、而「下次更仔細」沒有改善時,用來判斷那些失效有沒有共同的成本結構 2026-09-04
審查的 frame 全部在問規則的效力,沒有一個問它的代價
一輪審查結案、finding 數量可觀時,用來檢查那些 frame 的提問方向是不是全部朝同一邊 2026-09-07
盤點出來的缺口,處置要看補上它需要哪一種資源
盤點出流程還有哪些維度沒被覆蓋之後,用來判斷該再跑一輪、還是該建票等另一種資源 2026-09-07
審查的射程只涵蓋被審查的對象,工具與共用產物在射程外
一輪多 frame 的審查全部通過之後,用來找出從頭到尾沒有任何一個 frame 會碰到的那幾類對象 2026-09-07
廢除一項共用資產時,它的前提與它的效果都在自己看不到的那一側
刪掉一個被別的專案裝過的檢查、腳本或設定之前,用來確認哪些判斷本地驗得到、哪些驗不到 2026-09-08
壓縮標籤省下的字數是一次,展開成本乘以引用點數
替表格列名、欄位標籤或章節標題取短名,而那個名字會被別處逐字引用時,判斷它該不該把省略掉的限定語補回來 2026-09-08
版號擋不住並行覆蓋,因為兩個作者會從同一基底取到同一個號
多個作者各自把改動推上同一份共用資產,而推送工具以版號判斷新舊時,判斷那個比對能不能當閘門用 2026-09-08
讀者定位擋住科普化的同一句話,供應了省略解釋的理由
教材裡的基本名詞用縮寫帶過、術語只提而沒有補卡,而作者的理由是讀者已經是專業人士時,判斷那個理由成不成立 2026-09-09
寫出特定實例的值,就取代了讀者本來要做的查證
文章要寫某個機型、環境或安裝的具體值與處理方式,而讀者本來應該在自己的系統上查它時,判斷該不該寫進去 2026-09-11
拆分產生的缺陷落在檔與檔的交界,每一份單獨讀都是對的
一份文件拆成多檔之後,讀者回報跳躍、割裂、或不知道還有哪幾份檔案時,用來找出拆分自己造出來的那幾類缺陷 2026-09-11
修法要落在缺陷所在的那一層,而看起來做得最多的那個修法通常不在
審查指出一處歧義、修過之後同一處又被指出來時,用來判斷修法動到的是不是缺陷所在的那一層 2026-09-11
修法沒有寫進檔案,而同一輪的無關改善替它簽了名
一項處置判定生效結案、兩輪之後同一個位置復發時,用來查那次修法有沒有真的寫進檔案 2026-09-11
門檻要在派發之前寫死,否則「不處置」會被事後合理化
跑多輪量測而每一輪都要決定哪些命中該修時,用來訂出何時處置、何時換手段的門檻 2026-09-18
審查的產出是判定還是歸因要先宣告,因為歸因在累積式產物上沒有收斂點
一輪審查的待辦越修越多、關閉速度追不上新增時,用來判斷問錯的是哪一種問題 2026-09-18
規範文字的效力由它在讀者程序裡的位置決定,逐字讀過也不保證綁定
寫進規範的一句話反覆不生效、而讀者確實讀過那一段時,用來判斷該改的是措辭還是位置 2026-09-18
量測的前置步驟決定了分母,而所有檢查都落在分母之後
一具檢查工具報出的每個數字都正確、而據以得到的結論仍然錯時,用來查它實際量了哪個子集 2026-09-18
以讀者主觀狀態為要件的條款,在最需要它的人身上不觸發
規則寫了處理不確定情形的條款、而該處理從來沒有被執行過時,用來判斷該改的是措辭還是要件的形式 2026-09-18
條文可以有負效力,而禁止某條捷徑的那句話自己就是捷徑的地圖
一款條文量到零引用、準備刪掉或搬位置時,用來先判斷它被引用會發生什麼 2026-09-18
表單缺一格,填表人就得把不合格式的事實改寫成合格式的
設計自檢表、審查報告或盤點表的欄位時,用來判斷這組欄位會不會逼出不實的填寫 2026-09-18
從原則卡壓出來的操作形要獨立驗一次,而本體正確正是它不被檢查的原因
把原則卡壓成 checklist、規範段落或 skill 條目之後,用來判斷壓出來的那一份要不要獨立量測 2026-09-18
一道題通過不代表它驗到了那一款:把受測的條文遮起來,正解仍推得出來就是零鑑別力
一組題目在某份條文上拿到滿分、而想確認那個滿分是不是這份條文換來的時候讀 2026-09-22
教學定位被讀成教室講課,產出的是經營注意力的障礙而非有序的說明
技術文章或 work-log 的開場寫成情境故事、正文裡省略主詞受詞、或出現模擬互動的語句(這裡容易搞錯、該問誰、前面提到的四種)時回來讀 2026-09-22
先備知識與環境陷阱跟在所屬的指令旁邊,用結構承接
操作指引裡的補充說明(為什麼要這樣做、特定環境的陷阱)散落在正文裡像是講課時的即興補充時回來讀 2026-09-22
口語的語氣強調寫進文章後變成讀者的解碼成本
技術文章裡一句話的受詞或量詞單位在領域裡不存在(「一個字都沒有執行」的字、「走到解析」的走到)時回來讀 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
排比句的變動格填了話題自己的定義:同義反覆的形態、兩個檢查與改寫方向
一句工整的排比讀起來像在交代分工,讀者卻覺得是廢話;或總覽句先把各類缺口由誰處理排成並列句、具體的對象要到後文才出現時回來讀 2026-10-14
「問題」與「回答」當框架詞:一個詞蓋住問句、故障、議題與需求,以及系統被寫成應答的一方
文章用「X 回答的問題是」「這是 Y 的問題」組織內容,讀者分不出那個「問題」是一句問句、一個故障、一個要處理的事項還是一項需求;或審查時看到監控、檢查、元件被寫成在回答問題時回來讀;「撐得住」這類足夠性斷言與「對不對」這類評價謂語是同一類詞 2026-10-14
物理動詞佔住的內容:撐、扛、垮、掛在、站得住各自要寫出什麼,以及這些詞在負載情境裡的意思
文章裡出現「撐得住」「拖垮」「扛起」「掛在」「站得住」這類借來的物理動詞,要判斷它佔住的是需求、失效的形態、關係、負擔還是可信度,以及改寫時要寫出什麼;或要處理負載情境裡「撐不住」「壓垮」「撐過尖峰」這類句子時回來讀 2026-10-19
段落的範圍由標題與所屬分類共同限定:標題沒寫出分類的條件時,題目範圍檢查放行的那一節
一節內容落在標題的範圍內、各項檢查也都通過,而讀者指出它不屬於這個分類;或標題沒寫出分類已經限定的條件(語言、層級、處理對象)時,用來判斷那一節該留在原處還是移到另一個分類 2026-10-19
文件的職責數從修改紀錄讀出:長度當拆分訊號的誤判、加段落之前的檢查與拆完之後的外部引用
要往既有的文件或規則檔加一節、懷疑一份文件塞了多種職責、或剛拆完一份文件要處理原檔與指向它的引用時,用來判斷是否拆分、沿哪條軸拆與拆完要補什麼 2026-10-19
以對象起手的句子:缺少的動作者、時機與觸發原因,審查修正寫出這類句子的成因與偵測方式
句子以被討論的對象起手(「一個檔案被幾個需求修改過」「一個檔案同時對上兩列時,依……來分」),讀者說不出是誰在做這件事、在工作流程的哪一步碰到、為什麼會發生,或審查修正補進去的句子讀起來像條文時回來讀 2026-10-24
平常不動作的防護機制的部署驗證:設定被接受、元件狀態正常、執行失敗被吞掉與測試從中途注入這些提早出現的成功訊號,驗證查詢與處置指令的假陰性,以及合成觸發本身有損害時的分段驗證
部署停損開關、稽核紀錄、告警或自動處置這類平常不動作的防護機制之後,要判斷它算不算部署完成時讀;也用在驗收紀錄寫著「部署成功」「狀態 ACTIVE」「設定已套用」、或驗證查詢回傳零筆就被當成結論的時候 2026-10-25
規則檔的修法逐輪製造新歧義:程序寫成有測試的工具,共用的概念只定義一次
規則檔經過多輪審查、每一輪都照 finding 逐條修補,而下一輪的歧義數不降反升時讀;也用在規則檔裡寫了 shell 管線或 git 程序、同一個例外在幾條規則裡各寫一份、或出現「只有兩種情形」這類宣告的時候 2026-10-25
規則的修法逐句驗證會通過、套到案例上才互撞:改完才查得到的事實管不了動手之前的步驟,修完要拿任務重走
照審查或探針的 finding 修規則檔,下一輪的新歧義大多落在這一輪剛寫的句子上時讀;也用在要定義一個給好幾條規則共用的概念、或要替一條規則補例外的時候 2026-10-25
要理解探針列出「有兩種讀法的位置」是審查題:同一份檔案兩批的總數差得比輪與輪之間還大,改用封閉案例題加預期答案
用低階模型探針量規則檔或文章的歧義,拿每一輪回報的歧義總數判斷有沒有收斂時讀;也用在設計探針的題目、決定什麼時候可以停止審查的時候 2026-10-25
判定改動是誰做的檢查:重播差異而不拿全文、證據綁定這個 session、比對要提交的那一份內容
多個 session 或 agent 共用同一個工作樹,要在提交前確認 diff 都是自己的改動,或寫一支工具用編輯紀錄判定改動屬於誰時讀;也用在檢查工具的測試全過而審查仍找出漏報的時候 2026-10-25
只能在建立時決定的設定:支援組合在建立之前讀文件確認、兩條登入路徑各自依賴的元件,以及寫死參數的重送把舊判斷帶進新的一次
規劃一台雲端主機、一個叢集或任何建好之後只能重建才改得了設定的資源時讀;也用在資源建好之後登不進去、元件狀態都正常而功能不成立,或一支跑了很久的重送腳本建成資源的時候 2026-10-27
同一個工具在兩個模組各有一頁:兩頁從工具往外寫就會重疊,從各自模組讀者要做的判斷往回推才分得開,原封不動搬到另一頁仍成立的段落抽成知識卡
同一個工具或元件在兩個教學模組各有一頁,兩頁的段落大量重疊,正在考慮合併成一頁、指定其中一邊當唯一的家,或判斷兩頁各該寫什麼時讀 2026-10-29
破壞性指令的目標用變數的字串截取組出來時,審核的人看不到要刪什麼;空值、尾斜線與截取對不上會改變刪除範圍,而這類清理夾在檢查指令裡時,核准一次檢查就核准了一次刪除
要寫或核准一條含 rm、清理或覆蓋動作的 shell 指令,而它的目標路徑來自變數或字串截取,或那個刪除動作夾在一條檢查、正對照指令的結尾時讀 2026-10-29
結構譬喻頂替主詞與動詞:分類寫成「線」、書「承接」一個「面」、讀者「走」到某篇、判定「住在」某篇,新稿與集合裡的舊文章用的是同一組詞
一個內容集合用「這條線」「各接一個面」「由 X 承接」「走 [某篇]」「判定住在某篇」「X 的決定落在 Y 上」這類詞組織自己,或要以集合裡的舊文章為範本寫新文章時讀 2026-10-29
替讀者假設他可能沒經歷過的情境或頻率:「這個位置每週都會遇到的那場對話」把一個條件寫成讀者的日常,改寫成職責或條件並寫出發生的前提
文章寫出「每週都會遇到」「躲不掉的」「天天開會」「你一定遇過」這類替讀者決定他經歷過什麼、多常發生的句子,或用一個情境帶出一本書的用途時讀 Tarragon (CC BY 4.0) | 使用 hugo 製作