Object spec:wiki 頁面

Object: wiki 頁面(wiki/ 底下的一般內容頁;不含 wiki/index.md、wiki/log.md、wiki/log-archive.md 這三份有自己規格的特殊角色檔案)

適用範圍:規範單一 wiki 頁面本身的 frontmatter、連結與命名規則。不含目錄層級的命名——topics/<topic-name>/ 主題名稱、projects/<project-name>/ 專案名稱不受這裡「唯一且具體」的限制。

規格本體

編輯權

wiki/ 底下任何檔案使用者都可以直接編輯,不限由 AI 寫入。

Frontmatter

每個 wiki 頁面使用 YAML frontmatter:

---
type: index | topic | decision-log | article
status: evergreen | active | archived
tags: [tag1, tag2]
created: 2026-07-29
updated: 2026-07-29
sources: 3
---
  • type 描述頁面的內容形態,可擴充;只有當新類型需要不同的實際處理方式時才新增。

    • index:路由/樞紐頁
    • topic:主題參考或框架頁
    • decision-log:依時間或編號累積的決策紀錄
    • article:對外發表的創作正文
  • status 只表示頁面所屬的 track 層級,值固定為 evergreen、active、archived,不得自行擴充,語意對應 evergreen/wiki 專案 active/archived 三種軌道;文件本身寫完了沒屬於另一條獨立軸線,不由這個欄位承擔,需要追蹤時另用專案路由頁的進度表。

  • sources 表示這個頁面目前內容所源自的、不重複 raw/ 路徑數量,由 Ingest 於寫入或更新頁面時依實際用到的來源計算並維護。

連結慣例

交叉引用使用 Obsidian Wikilink [[頁面名稱]],不用相對路徑 Markdown link。
新頁面至少要有一個既有頁面連入,並至少連向一個既有頁面,避免成為孤立節點。
頁面名稱應盡量唯一且具體,避免使用 [[研究]] 這類泛稱——再次強調,這條只管頁面命名,不管主題/專案目錄命名。

交叉引用硬性要求

不論內容如何加入,最終都必須補齊相關交叉引用;缺漏可由 Lint 與後續維護補正。

驗證方式

  • 機械:frontmatter 六欄位是否齊全、type/status 是否在允許列舉值內、tags 語法、created/updated 日期格式、sources 是否非負整數、新頁面最低連結數——hoard-lint 已實作這些檢查,檢查當下應直接讀這份 spec 取得允許值,不要憑記憶硬寫。
  • 語意,不可自動化:頁面名稱是否「唯一且具體」;sources 計數是否正確反映實際用到的來源(Lint 只驗證型別是非負整數,不驗證數字是否精確)。