vault-cleanup-auditor

vault-cleanup-auditor 技能總覽

vault-cleanup-auditor 的功能

vault-cleanup-auditor skill 會在 Claude Code 中稽核 Obsidian vault，並產出一份附日期的清理報告。它會找出過期草稿、不完整筆記、重複檔名與空資料夾，接著把這些發現整理成一份有優先順序的檢視清單，讓你能快速著手處理。

適合哪些人

如果你管理的是持續擴大的個人或團隊 vault，並且需要可重複執行的清理流程，而不是一次性的提示詞，那就很適合用 vault-cleanup-auditor skill。它特別適合已經有 vault 結構、但想用低摩擦、快速的方式找出內容偏移、雜亂與從未完成的筆記的人。

為什麼它不一樣

這不是一個泛用的「幫我整理筆記」提示詞。vault-cleanup-auditor 指南是圍繞固定的稽核流程、明確的輸入要求，以及會保存的報告檔而設計的。這讓它更適合週期性維護與 Workflow Automation，而不是主觀式的筆記重組。

如何使用 vault-cleanup-auditor skill

vault-cleanup-auditor 的安裝與設定

先把 vault-cleanup-auditor skill 安裝到 Claude Code，然後指定到你的 Obsidian vault 根目錄。它最核心需要的輸入是 vault 的絕對路徑，而不是 vault 裡面的某個子資料夾。如果你沒有提供，這個 skill 的設計是會先要求你補上缺少的路徑，再開始執行。

如何觸發稽核

實際使用 vault-cleanup-auditor 時，提示詞可以寫得簡單而明確：
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.

通常這樣就夠了，因為這個 skill 本來就知道要檢查什麼。如果你的 vault 有特殊的子資料夾結構，或你只想檢視其中一部分，請在一開始就說清楚，避免稽核範圍過大或過小。

先看哪些內容

在檢視 vault-cleanup-auditor 安裝時，先從 SKILL.md 和 SKILL-OC.md 看起。閱讀 SKILL.md 時，重點放在輸入階段與四項檢查，這樣你才能精確掌握實際會發生什麼事。也可以檢查 GitHub repo 的檔案樹來了解支援路徑，但這個 skill 沒有額外的 rules/、resources/ 或腳本需要解讀。

輸入越好，輸出越準

最好的 vault-cleanup-auditor 使用輸入，會包含清楚的絕對路徑，以及你工作流程裡對「雜亂」的明確定義。舉例來說，你可以指定超過 30 天的草稿才算過期、已歸檔內容要忽略，以及不同區段之間的重複檔名是否可接受。這些細節能減少誤判，讓報告更具行動性。

vault-cleanup-auditor skill 常見問題

vault-cleanup-auditor 只適用於 Obsidian 嗎？

是，這個 skill 是以 Obsidian vault 的結構為核心，並假設使用的是本機 markdown 檔案。它也可能對其他以資料夾為基礎的筆記系統有幫助，但內建檢查是針對 Obsidian 風格內容調整的，可能需要再微調。

這比一般提示詞更好嗎？

通常是的，前提是你希望每次都做同樣的稽核。一般提示詞可以要求清理建議，但 vault-cleanup-auditor 會加入固定的掃描模式、必要輸入處理，以及已保存的報告，讓結果更可重複，也更容易逐月比較。

新手需要懂 repo 結構嗎？

不用，但新手在執行前應該先讀過簡短的指示段落。最重要的是要知道 vault-cleanup-auditor 沒有 vault path 就不會啟動，而且它期待的是實際的 vault 根目錄，這樣檢查才能遍歷正確的資料夾。

什麼時候不該用它？

如果你想要的是大幅度的編輯改寫、內容策略建議，或對筆記品質做出類人判斷，就不適合用 vault-cleanup-auditor。它是清理稽核工具，不是寫作助理；當問題是「哪些內容過期、損壞、重複或空白」時，它最有價值。

如何改進 vault-cleanup-auditor skill

先把範圍定清楚

提升 vault-cleanup-auditor 結果的最大關鍵，是明確定義 vault 的邊界。如果你的 vault 裡包含封存區、同步備份、模板或產生內容，請直接說明。這能幫助 skill 避免把刻意保留的內容誤判成雜亂。

調整稽核條件

如果預設檢查太寬鬆或太嚴格，就在你的要求中把規則解讀講得更精準。比如說，告訴它「過期」是 30 天還是 90 天、模板系統底下的空資料夾是否應忽略，以及重複檔名是只在單一專案內算，還是整個 vault 都要算。

改善第一份報告

當 vault 路徑正確、筆記習慣又一致時，第一次輸出的報告通常最有參考價值。如果結果雜訊很多，問題往往出在輸入整理不佳：例如檔案沒有標題、草稿狀態混雜，或有些重複名稱其實是刻意如此。先修正慣例，或把例外情況說清楚，再重新執行 vault-cleanup-auditor 指南。

針對最重要的部分反覆調整

第一次執行後，先檢視最高優先順序的發現，再決定要不要改 skill 本身。大多數使用者最在意的是過期草稿和重複檔名，因為這兩類問題最容易造成後續維護負擔。如果報告漏掉了重要事項，請用一個具體例子補進你的指示，而不是泛泛要求更「好的稽核」。