Object spec:wiki/index.md

Object: wiki/index.md,wiki 的頂層索引

適用範圍:規範 wiki/index.md 的更新時機、區塊與條目格式、範圍宣告原則,以及路由頁拆分門檻。不含一般 wiki 頁面本身的規則(見 wiki-page.md)。

規格本體

Frontmatter

沿用 wiki-page.md 的六欄位 schema,其中 type 固定為 index、status 固定為 evergreen、sources 固定為 0。

更新時機

頁面新增、歸屬改變,或摘要/路由資訊受影響時,更新這裡。

區塊

固定四個區塊,依序:

  • ## 常青 — 自我 (evergreen/self)
  • ## 常青 — 興趣主題 (evergreen/topics)
  • ## 進行中專案
  • ## 已歸檔專案

條目格式

自我與兩個專案區塊為扁平清單,每筆 - [[完整路徑|顯示名稱]] — 一句摘要。

興趣主題區塊每個主題一個 ### <主題名> — 範圍:<收什麼>;<不收什麼> 標題,其下為同樣格式的頁面清單。

範圍宣告

每個常青主題都必須有一句範圍宣告,說明該主題「收什麼、不收什麼」。範圍宣告定義主題本身的邊界,不得依目前已有頁面反推;Ingest 判斷新內容歸屬時以此為主要依據。

連結約束

wiki/index.md 不需要被其他頁面連入,不視為孤兒頁面。

路由頁拆分

單一主題或專案區塊超過 2000 字元,或其中單一 bullet 超過 800 字元,就該考慮把該區塊的子頁清單搬至獨立路由頁——字元數是提醒,拆不拆由當下判斷。

搬移後頂層只保留主題/專案名稱、範圍宣告,以及指向路由頁的連結;路由頁負責維護各子頁的「連結+一句話摘要」。

驗證方式

  • 機械(可檢查,目前尚未實作):四個區塊是否齊全、每個常青主題是否有範圍宣告。
  • 不驗證:路由頁拆分門檻沒有機械檢查,也不打算補;字元數是寫給維護者的提醒,實際要不要拆由當下判斷。
  • 語意,不可自動化:範圍宣告是否真的講清楚「收什麼、不收什麼」、新內容歸屬是否依範圍宣告判斷而非反推既有頁面、條目摘要是否仍準確。