Obsidian 知识库整理助手
帮助智能体系统化地整理 Obsidian 笔记库：建立导航、修复链接、统一属性、清理孤立笔记。
技能文件明确规定了保守操作：仅允许通过 edit_block/write_file 编辑内容，禁止使用 move_file 重命名或移动文件（否则会破坏 wikilink），并要求在 Obsidian 内部执行移动/重命名。这体现了最低特权和破坏性操作规避。但缺少独立的用户确认机制（技能本身未提供明确的确认步骤），并且技能依赖 Desktop Commander MCP 的能力，该 MCP 拥有终端访问等广权限，而技能文件未限制其作用域，这增加了风险。此外，未提供回滚或备份策略。因此扣分，给予 16 分。
技能指令详尽，但静态审查无法执行验证关键工作流（如 start_search、edit_block）的可靠性。技能文件提供了多种方法（如 Dataview 查询），但未提供测试证据或明确的错误处理。依赖的 MCP 工具行为未经本审查验证。根据静态校准限制，可靠性上限为 10，但缺乏测试覆盖和错误反馈，故给予 5 分。
触发条件非常明确：仅在用户明确提到 Obsidian 时使用，并给出了具体例子，且有清晰的不适用范围。受众为 AI agent。环境适配方面，Obsidian 功能不依赖海外服务，但技能文件为英文，未提供中文支持，可能影响中文用户的可用性，因此扣分。给予 10 分。
技能有清晰的名称、版本（0.1.0）、受众，信息架构良好，分段清晰，提供了模板和示例，并有明确的已知限制（如重命名必须通过 Obsidian）。但缺少安装/依赖说明（作为技能运行于 MCP 环境，未说明依赖），也缺少明确的维护责任和更新路径。许可证明确（MIT），但技能文件本身未包含许可证信息。因此给予 9 分。
技能目标清晰，步骤详细，预期输出明确（如 MOC 模板、frontmatter 示例）。但静态审查无法验证实际效果，且未提供代表性输出以证明直接可用性。根据静态校准，效果上限为 7，但缺乏实测证据，给予 5 分。
仓库中包含测试文件（如 test/ab-test.test.js、test/integration/edit-block-performance.js）和 CI 工作流（codespell.yml），但这些测试主要针对 MCP 本身，而非针对该技能的关键路径。技能文件本身未提供可复现的验证示例或交叉证据。因此，给予 4 分。
- 技能依赖 Desktop Commander MCP，该 MCP 具有终端执行等广权限，技能本身未限制其作用域，使用时需注意安全边界，确保仅在可信环境中使用。
- 虽然技能建议在 Obsidian 内部执行移动/重命名，但实际执行时可能仍会使用 MCP 的文件操作，需确保用户理解风险。
- 技能文件为英文，中文用户可能需要额外的翻译或理解成本。
- 静态审查无法验证技能的可靠性，实际使用前建议在小规模 vault 上进行测试。
这个 Skill 能做什么，适合哪些场景？
这个技能专门用于处理 Obsidian 笔记库的整理与维护，仅在用户明确提到 Obsidian 时启用。它能创建内容地图（MOC）、添加或修复 wikilinks、发现孤立笔记、规范化 YAML frontmatter、生成 Dataview 或 Bases 仪表板，以及整理文件夹和去重。所有操作都遵循 Obsidian 的核心规则。</summary>
读取笔记内容，搜索 [[ ]] 链接和孤立笔记，使用 write_file 创建 MOC 和仪表板，使用 edit_block 编辑笔记内容（如插入链接、规范化 frontmatter）。它不会移动或重命名文件，而是指导用户在 Obsidian 内部操作。
- Obsidian 用户想为某个主题建立导航结构，需要创建 MOC 并链接相关笔记。
- 用户发现笔记之间没有链接，希望自动发现并修复孤立笔记。
- 用户想统一笔记的 frontmatter 属性，以便用 Dataview 或 Bases 过滤。
- 用户想生成一个最近更新的笔记列表仪表板。
- 用户想合并重复笔记并修正所有指向被删除笔记的链接。
这个 Skill 有哪些优点和局限？
- 遵循 Obsidian 最佳实践（wikilinks、frontmatter、MOC）
- 提供具体的 Dataview 查询和 MOC 模板
- 明确指导避免破坏链接
- 适用于任何 Agent Skills 兼容客户端，无需额外依赖
- 依赖用户配合在 Obsidian 内操作移动和重命名
- 需要用户安装 Dataview 插件才能使用相关功能
- 未提供测试套件或验证的示例
- 对于大型仓库，搜索性能可能受限
如何安装这个 Skill？
将 plugins/claude/skills/obsidian-vault/SKILL.md 所在文件夹放入你的 Agent Skills 目录（例如 Claude Code 的 ~/.claude/skills/）。
如何使用这个 Skill？
在对话中直接提及 Obsidian，例如：“帮我整理 Obsidian 仓库，找出所有孤立笔记”。技能会先确认仓库根目录和 Dataview 插件情况，然后执行相应操作。