用途
Vault Cleanup Auditor 用于审计 Obsidian 仓库，帮助发现陈旧草稿、空文件夹、重复文件名和不完整文件，并将结果保存为带日期的报告。它运行 4 项定向检查，耗时不到 30 秒，不使用 API、不依赖付费服务。建议每月运行一次，或在仓库开始变得杂乱时使用。
主要能力
该技能执行以下 4 项检查：
- 陈旧草稿（30 天以上、未发布）：在
content/ready-to-post目录中查找修改时间超过 30 天、且标记为未发布（**Posted:** ❌）的 Markdown 文件，并计算其已存在天数。 - 不完整文件（无标题、5 行以上）：查找仓库中不含 Markdown 标题（
#至######）且行数超过 5 行的.md文件，排除.git、.obsidian、.openclaw目录。 - 重复文件名：查找仓库中文件名重复的
.md文件，并列出每个重复文件名的所有路径。 - 空文件夹：查找仓库中的空目录，排除
.git、.obsidian、.openclaw目录。
使用方式
在 Claude Code 中打开并输入：
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.
技能被调用后按以下阶段执行：
阶段 1：信息收集
检查用户是否提供了 vault_path（Obsidian 仓库根目录的绝对路径）。如果缺失，则询问：
What's the absolute path to your Obsidian vault? (e.g. /root/obsidian-vault)
在确认之前不继续执行。
阶段 2：分析
运行全部 4 项检查，在写报告前先捕获每项检查的原始输出。检查 1 使用 find 与 grep 定位陈旧草稿；检查 2 使用 find、grep、wc 定位不完整文件；检查 3 使用 find、sort、uniq 定位重复文件名；检查 4 使用 find -type d -empty 定位空文件夹。
阶段 3：输出 创建报告目录和文件：
VAULT="VAULT_PATH_HERE"
DATE=$(date +%Y-%m-%d)
mkdir -p "$VAULT/vault-audit"
REPORT="$VAULT/vault-audit/${DATE}-audit.md"
echo "Report path: $REPORT"
报告结构包含：标题（Vault Cleanup Audit — YYYY-MM-DD）、生成时间、摘要行（🔴 陈旧 | 🟡 不完整 | 🟡 重复 | 🟢 空文件夹），以及四个分节，每节最多列出 15 项，超出时添加 "...and N more"。报告末尾附有处理建议：陈旧草稿可发布、删除或归档到 content/posted/；不完整文件可完成或丢弃；重复文件可合并或重命名较不重要的一个；空文件夹可安全删除（或保留以备即将使用）。最后将摘要打印到终端。
阶段 4：自我检查
在最终确定前确认：全部 4 项检查均已运行（若某项无输出，在报告中注明 "0 issues found"，不跳过该节）；摘要计数与实际列出的条目一致；报告已正确保存到 vault-audit/YYYY-MM-DD-audit.md（若写入失败，报告错误并内联提供报告内容）；没有空白分节（每节要么列出条目，要么写 "No issues found."）。修复任何失败后再交付最终输出。
适用场景
- 定期（如每月）维护 Obsidian 仓库整洁。
- 仓库内容开始变得杂乱时进行清理。
- 需要快速了解仓库中待处理问题（陈旧草稿、不完整文件、重复文件名、空文件夹）的优先级清单。
限制
- 需要 Claude Code 并具备 bash 工具访问权限。
- 需要 Bash 及标准 Unix 工具：find、grep、wc、stat、date、awk。
- 需要对仓库目录的读取权限。
- 需要对仓库内
vault-audit/的写入权限（自动创建）。 - 不使用 API、无付费服务、无外部依赖。
- 检查 1 仅针对
content/ready-to-post目录下的文件。 - 报告每节最多列出 15 项，超出部分仅显示数量。