30c9312c57
leo 2026-08-15:「我是說不是要用真實的資料夾套新規範做一次?」 對 matrix/arcrun/docs 的兩個節點做了真的萃取(不是模擬): · docs/ 5 篇原稿 → 5 文件卡 + 9 概念卡 + 1 主題(結構性閘) · user_requirements/ 4 篇 → 2 文件卡 + 7 概念卡 + 1 主題(讓生態自己長) 踩到並如實處理的四個邊緣案例: ① arcrun-landing-page/ 只有 .jsx/.html/.css ⇒ 依規範不是節點,不建 .wiki(index 說明有寫) ② credential_parts.md 29KB、12 個 H2,超過 20KB 分段門檻 ⇒ 只萃 §0–§2,其餘八段在文件卡上如實標明未做——一張卡蓋不住 29KB ③ wishlist.md 是「空」的第三種:指針檔(不是沒東西、不是紀錄) ⇒ 標 no_concept 不產卡。我第一版給它產了卡,wiki-lint 當場報孤島卡抓到 ④ 三個子節點未萃,在 index 標「未萃」——標出來使用者才分得出「沒東西」和「還沒做」 並依 leo 的判準拿掉 type 欄位: 「在這個類似 Logseq 的結構裡根本不分,你要想的是在寫函式時是否不同」 逐一檢查 place_card/patch_card/promote_hub/split_hub/渲染/三個信號/lint ——沒有任何函式需要類型欄位,需要的全是結構屬性(有無父/有無子/有無判斷), 而那三個都是現算的。⇒ type: hub 與 hub_kind 拿掉,wiki-lint 改成用算的。 promote_hub 因此不是改型別,是在有子的卡上補一段判斷,型別自己就變了。 實測:docs 樹 節點 2|卡片 27|卡外邊 62,十五項全 0,退出碼 0 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
tags, gloss, created, updated
| tags | gloss | created | updated | |||
|---|---|---|---|---|---|---|
|
把錯誤路徑做成「根本碰不到」,而不是叮嚀人不要走。 | 2026-06-03 | 2026-08-15 |
結構性閘
← 00-INDEX
摘要
這個主題把三張卡收在一起,因為它們是同一個手法的三個場合:不靠自覺,靠結構。
重點
- 把 零件 PR 審核閘 收進來,是因為它明講了理由——零件本來就要走 PR,所以把檢查放在那裡,錯誤路徑就碰不到
- 而 規則記不住 是這個手法的前提:規定說幾次都沒用,這不是紀律問題是機制缺席
- AI 讀不到的隱形分層 則是同一件事的反面——規則沒被放在會被讀到的地方,等於不存在
- ⇒ 三張卡合起來給出一條可複用的判準:看到「說過很多次還是會犯」,就去找那個缺席的閘
實體
- 結構性閘(手法)— 讓錯誤路徑在結構上碰不到,而非靠遵守。
關聯
卡片關係
- 結構性閘 >> 收攏 >> AI 讀不到的隱形分層
- 結構性閘 >> 收攏 >> 規則記不住
- 結構性閘 >> 收攏 >> 零件 PR 審核閘
出處(原文 >> 提及 >> 本卡,可多筆)
../component-pr-review-standard.md>> 提及 >> 結構性閘../HANDOFF-config-scope-and-vectorize.md>> 提及 >> 結構性閘