Files
Arcrun/docs/.wiki/component-pr-review-standard.md
T
uncle6me-web 30c9312c57 wiki: 拿真實的 docs/ 套新規範跑一次(27 張卡,兩個節點)
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>
2026-08-15 13:47:27 +08:00

35 lines
981 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
tags: [文件, 流程]
gloss: 零件與 binding 的 PR 審核規範,五段 checklist,任一否就打回。
created: 2026-06-03
updated: 2026-08-15
---
# component-pr-review-standard
← [[00-INDEX]]
## 摘要
它的開場白就是整份文件的論點:靠 AI 記住規則不 scale,所以把錯誤擋在結構上。
## 重點
- **論點**[[規則記不住]]
- **手法**:[[零件 PR 審核閘]],五段 A–E 逐條過
- 每一段都附了**真實反例**`km_wiki_card_parse` 被否、drainer 本地綠但撞 1042)——**反例比規則本身有用**
## 實體
- **component-pr-review-standard**(原稿)— 本卡對應的那一份交辦文件。
## 關聯
### 卡片關係
- component-pr-review-standard >> 涵蓋 >> [[規則記不住]]
- component-pr-review-standard >> 涵蓋 >> [[零件 PR 審核閘]]
### 出處(原文 >> 提及 >> 本卡,可多筆)
- `../component-pr-review-standard.md` >> 提及 >> component-pr-review-standard