import-content

import-content 技能是 Kurt 內容流水線中關鍵的手動備援與操作工具。它專為需要繞過自動 Web 攝取失敗的技術用戶而設計，透過直接將預處理過的 Markdown 文件從本地來源目錄導入 Kurt SQLite 資料庫。即使在 WebFetch 或自動化鉤子遇到網路問題或解析失敗時，也能確保內容同步。它連接了原始本地檔案與下游工作流程（如內容撰寫技能）所需的資料庫索引內容，並透過 YAML Frontmatter 確保高品質的元數據提取。

• 修復 Kurt 資料庫中的 ERROR 紀錄，將其連結至修正後的本地 Markdown 來源檔案。

• 透過 Shell 腳本為大型資料集、遷移或備份恢復執行批次導入。

• 自動從 YAML Frontmatter 提取元數據，支援 title、description、author 及 published_date 等欄位。

• 與 PostToolUse 鉤子整合，監控 /sources/ 目錄，並在手動編輯後自動更新文件紀錄。

• 支援針對原始爬蟲未捕獲的手動建立檔案進行精確索引。

• 請確保所有 Markdown 檔案頂部包含有效的 YAML Frontmatter，以正確填充資料庫架構。

• 在批次恢復操作中，使用 .claude/scripts/ 下提供的 Python 腳本連結文件 ID 與本地路徑。

• 進行手動攝取後，請務必執行 kurt index 指令，以觸發新導入內容的文檔智慧處理流水線。

• 此工具嚴格限制在本地來源路徑內的檔案；請確保檔案權限允許代理存取來源檔案。

• 若缺少 pyyaml 函式庫，元數據提取將會靜默失敗；請確保透過 pip install kurt-core 完成 Kurt 環境的完整初始化。

• 此工具旨在進行進階內容管理與恢復；執行批次操作後，務必使用 kurt content list 確認資料庫狀態。