vault-cleanup-auditor
作者 BrianRWagnervault-cleanup-auditor 可在 Claude Code 中审计你的 Obsidian vault，找出过期草稿、未完成笔记、重复文件名和空文件夹。它会保存一份带日期的清理报告，便于重复执行 Workflow Automation 和月度维护。
该技能得分为 78/100，属于 Agent Skills Finder 中较扎实的候选项。目录用户可以清楚看出它能触发一套知识库审计流程，且具备足够的操作细节，便于理解它做什么、如何调用以及会输出什么；但它在环境依赖和缺少配套文档方面仍有一定采纳顾虑。
- 触发条件明确、输入要求清晰：Claude Code 提示词加上必填的绝对路径 `vault_path`，让调用方式很直接。
- 工作流价值具体：会执行 4 项明确检查，分别针对过期草稿、未完成文件、重复文件名和空文件夹，然后保存一份带日期的审计报告。
- 技能正文中的操作说明比较清楚：分阶段指令、bash 示例和报告保存位置都降低了代理执行时的猜测成本。
- 环境依赖很强：说明是围绕 Obsidian vault 结构以及 Claude Code/OpenClaw 的用法编写的，适用范围可能较窄。
- 没有配套文件或安装命令：除 markdown 说明外，没有脚本、引用或元数据可进一步验证其行为。
vault-cleanup-auditor 技能概览
vault-cleanup-auditor 的作用
vault-cleanup-auditor 技能会在 Claude Code 中审计一个 Obsidian vault，并生成一份带日期的清理报告。它会查找过期草稿、未完成的笔记、重复文件名和空文件夹，然后把这些发现整理成一份按优先级排序的复查清单，方便你快速处理。
适合谁使用
如果你在管理一个不断扩大的个人或团队 vault，而且需要可重复执行的清理流程，而不是一次性的提示词，那么就适合用 vault-cleanup-auditor 技能。它尤其适合那些已经有 vault 结构、但想快速、低摩擦地发现内容漂移、杂乱和从未完成的内容的人。
它为什么不一样
这不是一个泛泛的“帮我整理笔记”提示词。vault-cleanup-auditor 指南围绕固定的审计流程、明确的输入要求和保存后的报告文件来设计，因此它更适合周期性维护和 Workflow Automation，而不是主观性的笔记重构。
如何使用 vault-cleanup-auditor 技能
vault-cleanup-auditor 的安装与设置
先在 Claude Code 中安装 vault-cleanup-auditor 技能，然后把它指向你的 Obsidian vault 根目录。它最核心需要的输入是 vault 的绝对路径，而不是其中某个子文件夹。如果你没有提供，技能会先要求补齐路径，再继续运行。
如何触发审计
一个实用的 vault-cleanup-auditor 使用提示应该简洁而具体：
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.
通常这样就够了，因为这个技能本身已经知道要检查什么。如果你的 vault 有特殊子目录，或者你只想审计其中一部分，请在一开始就说明，避免审计范围过大或过小。
先读什么最有帮助
在查看 vault-cleanup-auditor 的安装与评估时，先看 SKILL.md 和 SKILL-OC.md。在 SKILL.md 里，重点关注 intake 阶段和四项检查，这样你能准确知道接下来会发生什么。同时也可以查看 GitHub repo 里的文件树，了解是否有辅助路径；不过这个技能没有额外的 rules/、resources/ 或脚本需要解释。
想要更好结果，最好怎么输入
更好的 vault-cleanup-auditor 使用输入，应同时包含清晰的绝对路径和对“杂乱”在你工作流里的定义。例如，说明超过 30 天的草稿是否算过期、归档内容是否应忽略，以及不同分区里出现重复文件名是否可以接受。把这些边界说清楚，可以减少误报，也让报告更可执行。
vault-cleanup-auditor 技能常见问题
vault-cleanup-auditor 只适用于 Obsidian 吗？
是的，这个技能以 Obsidian vault 的目录结构为中心，并假设是本地 markdown 文件。它也可能对其他基于文件夹的笔记系统有用，但内置检查是按 Obsidian 风格内容来调优的，可能需要适配。
它比普通提示词更好吗？
如果你想每次都做同样的审计，通常是更好的。普通提示词可以让你提出清理建议，但 vault-cleanup-auditor 加入了固定扫描模式、必填输入处理和保存后的报告，因此结果更稳定，也更方便按月对比。
新手需要了解 repo 结构吗？
不需要，但新手在运行前应该先读一下简短的说明部分。最重要的是要明白，vault-cleanup-auditor 在没有 vault 路径时不会启动，而且它需要的是真正的 vault 根目录，这样检查才能遍历到正确的文件夹。
什么情况下不该用它？
如果你想要大范围的编辑重写、内容策略建议，或者希望它像人一样判断笔记质量，那就不要用 vault-cleanup-auditor。它是清理审计工具，不是写作助手；当你的问题是“哪里过期了、坏了、重复了或者空着”时，它的价值最高。
如何改进 vault-cleanup-auditor 技能
让范围更清晰
提升 vault-cleanup-auditor 结果的最大方法，是把 vault 边界定义得足够明确。如果你的 vault 里包含归档、同步备份、模板或生成内容，请明确说明。这样可以避免技能把有意保留的内容误当成杂乱。
调整审计标准
如果默认检查太宽松或太严格，就在请求里细化规则解释。例如，告诉它“过期”是 30 天还是 90 天，模板系统下的空文件夹是否应忽略，以及重复文件名只在单个项目内算问题，还是整个 vault 都算问题。
改善第一份报告
当你的 vault 路径正确、笔记规范一致时，第一份输出最有价值。如果结果噪音很多，问题往往出在输入卫生：比如文件没有标题、草稿状态混杂，或者重复名称其实是有意为之。先修正规范，或者说明例外，然后再重新运行 vault-cleanup-auditor 指南。
持续迭代最重要的部分
第一次运行后，先查看优先级最高的发现，再决定是否调整技能本身。大多数用户最在意的是过期草稿和重复文件名，因为这些最容易带来维护负担。如果报告漏掉了重要内容，不要直接笼统要求“审计更好”，而是补充一个具体例子。