hoard-ingest

DragonsHoard Ingest

步驟

1. 讀取來源：讀取本次要收錄的文字、檔案、連結或其他來源；只有資訊不足且會影響收錄判斷時，才向使用者釐清。

2. 決定歸屬：

   • 先依內容性質對照 wiki/index.md 的主題範圍宣告（格式與原則見 .claude/specs/wiki-index.md）。
   • 有既有主題涵蓋 → 決定更新既有頁面或建立新頁面。
   • 沒有既有主題涵蓋 → 建立新主題，並依 .claude/specs/wiki-index.md 建立其範圍宣告。
   • 同時涉及多個主題 → 選一個主要歸屬，其餘以交叉引用處理，不重複寫入。
   • 只有在歸屬候選成立後，才考慮內容量、命名與後續維護成本等因素。

3. 報告收錄計畫：正式寫入前，向使用者說明：

   • 預計的主要歸屬與頁面路徑；
   • 需要建立的交叉引用；
   • raw/ 保存路徑；
   • 預計寫入內容的概要。

   取得明確確認後才開始寫入；使用者要求調整時，依新方案重新報告並確認。

4. 保存來源：讀取 .claude/specs/raw-lifecycle.md，依目前規則確保原始來源保存於主要歸屬對應的 raw/ 路徑。保存內容直接取自來源，不重新生成、改寫、精簡或增添；已合法存在於 raw/ 的來源不重複處理。

5. 寫入 wiki：依步驟 2 的歸屬更新既有頁面或建立新頁面。

   • 建立或修改頁面時讀取 .claude/specs/wiki-page.md，依目前頁面規格處理。
   • sources 依頁面實際使用且不重複的 raw/ 路徑計算。
   • 補上本次新增內容所必要的交叉引用，只修改因本次 Ingest 確實需要同步的既有頁面。
   • 依 .claude/specs/wiki-index.md 處理路由頁門檻。

6. 維護索引與紀錄：依 .claude/specs/wiki-index.md 更新 wiki/index.md；依 .claude/specs/wiki-log.md 在 wiki/log.md 末尾追加本次收錄紀錄。

7. 處理圖片資訊：來源含圖片時，若圖片承載理解或收錄所需資訊則讀取；純裝飾或與內容判斷無關的圖片不必處理。