wiki-log

Object spec：wiki/log.md 與 wiki/log-archive.md

Object: wiki/log.md（操作時間軸）與 wiki/log-archive.md（其歸檔區）

適用範圍：規範這兩份檔案的紀錄格式、append-only 規則、歸檔門檻與約束豁免。不含各 workflow 什麼時候該寫紀錄——那寫在對應的 skill 裡。

規格本體

格式

兩份檔案都不使用 frontmatter。每筆紀錄一行：

## [YYYY-MM-DD] 類型 | 範圍 | 說明

類型 限下列值：

• ingest：收錄新來源進 wiki
• infra：結構、規則、schema 或機制異動
• archive：專案封存

歸檔區的舊紀錄可能出現已不再使用的類型值，依 append-only 規則不回溯修正。

範圍 寫受影響的路徑或主題；沒有明確對象時寫 —。

Append-only

兩份檔案都只能在最下方追加新紀錄，不得修改既有紀錄。舊紀錄裡的路徑或連結即使之後改名或失效，也不回溯修正。

歸檔

wiki/log.md 超過 30KB 時觸發歸檔：取所有 ^## \[ 開頭的行號，數到倒數第 10 筆，以該行號切割——之前的部分依原順序附加到 wiki/log-archive.md 尾端（檔案不存在就新建），之後的部分（含最近 10 筆）連同檔首說明留在 wiki/log.md。純粹依行號切割，不需要讀懂內容。

約束豁免

兩份檔案都不需要被其他頁面連入，不視為孤兒頁面；其中的連結不論方向都不受死鏈檢查（舊紀錄依 append-only 不回溯修正，必然會累積指向已改名或已刪除頁面的連結）。

wiki/log-archive.md 另不受交叉引用與 index.md 收錄規則約束。

驗證方式

• 機械：紀錄行是否符合格式、類型 是否在允許值內、既有紀錄是否被修改、log.md 是否超過歸檔門檻——hoard-lint 已實作門檻檢查，格式與類型檢查尚未實作。
• 語意，不可自動化：說明欄位是否足以讓日後讀者理解當時實際做了什麼。