mcpField
O
obsidian-vault-ops

obsidian-vault-ops

github.com/ballred生产力1.9k69 次安装36 周前更新
代码仓库

关于 obsidian-vault-ops

用于读取、创建、编辑和整理 Obsidian vault 文件的 skill。管理笔记时遵循 vault 约定，并维护 frontmatter、模板和 wiki-links。

主要功能

  1. 01读取笔记并查看 vault 上下文
  2. 02使用模板创建笔记
  3. 03保留 YAML frontmatter 和链接
  4. 04统一标签与标题层级
  5. 05查找相关笔记以便建立链接

适用场景

  1. 01根据模板创建每日笔记
  2. 02编辑笔记并保留原有结构
  3. 03查找相关笔记并建议 wiki-links
  4. 04使用标签和目标链接整理任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ballred/obsidian-claude-pkm --skill obsidian-vault-ops

安装后在 Claude Code 中输入/obsidian-vault-ops确认已加载。

详细介绍

Obsidian Vault 操作技能

在 Obsidian vault 中读取、写入和管理文件的核心操作。

Vault 结构

vault-root/
├── CLAUDE.md           # Main context (always read first)
├── Daily Notes/        # YYYY-MM-DD.md format
├── Goals/              # Goal cascade files
├── Projects/           # Project folders with CLAUDE.md
├── Templates/          # Reusable note structures
└── Archives/           # Completed/inactive content

文件操作

读取笔记
  • 使用 Glob 查找文件：*.md、Daily Notes/*.md
  • 首先读取 CLAUDE.md，了解 vault 的上下文
  • 检查是否有指向相关笔记的 wiki 链接
创建笔记
  1. 检查笔记是否已存在
  2. 如有可用模板，请使用合适的模板
  3. 添加包含日期和标签的 YAML frontmatter
  4. 插入指向相关笔记的 wiki 链接
编辑笔记
  • 保留 YAML frontmatter 结构
  • 保留现有 wiki 链接
  • 使用一致的标题层级
  • 使用标准标签格式

Wiki 链接格式

[[Note Name]]                    # Simple link
[[Note Name|Display Text]]       # Link with alias
[[Note Name#Section]]            # Link to section

YAML Frontmatter

标准 frontmatter 结构：

---
date: 2024-01-15
tags: [tag1, tag2]
status: active
---

模板变量

处理模板时，请替换：

  • {{date}} - 今天的日期（YYYY-MM-DD）
  • {{date:format}} - 格式化后的日期
  • {{date-1}} - 昨天
  • {{date+1}} - 明天
  • {{time}} - 当前时间

常见模式

创建每日笔记
  1. 计算今天的日期，格式为 YYYY-MM-DD
  2. 检查 Daily Notes/{date}.md 是否存在
  3. 如果不存在，读取 Templates/Daily Template.md
  4. 替换模板变量
  5. 写入 Daily Notes/{date}.md
查找相关笔记
  1. 从当前笔记中提取关键词
  2. 在 vault 中搜索匹配的内容
  3. 建议添加指向相关笔记的 wiki 链接
标签操作
  • 优先级：#priority/high、#priority/medium、#priority/low
  • 状态：#active、#waiting、#completed、#archived
  • 场景：#work、#personal、#health、#learning

最佳实践

  1. 始终检查 CLAUDE.md，了解 vault 特定的约定
  2. 编辑时保留现有结构
  3. 内部链接使用相对路径
  4. 为新笔记添加 frontmatter
  5. 创建任务时链接到相关目标

评论

支持 Markdown