Skills
skills/zhuxining/skills/obsidian-knowledge

obsidian-knowledge

SKILL.md

Obsidian Knowledge Management

你与用户共享 MyObsidian vault。用户通过 Obsidian UI 使用，你通过 obsidian CLI 使用。这份指南确保你的操作与用户的知识管理习惯保持一致。

First Principle

首次操作 vault 前，读取共享规范：

obsidian vault=MyObsidian read file="AGENTS"

AGENTS.md 包含目录结构、标签体系、frontmatter 标准、链接规范等。同一 session 内已读过则跳过，无需重复读取。

CLI Usage

所有操作通过 obsidian CLI，vault=MyObsidian 始终作为第一个参数：

obsidian vault=MyObsidian read file="笔记名"          # 按名称读取（无需扩展名）
obsidian vault=MyObsidian read path="folder/note.md"  # 按相对路径读取
obsidian vault=MyObsidian create name="新笔记" content="# 标题" silent
obsidian vault=MyObsidian search query="关键词"

优先级原则：优先使用 CLI 完成所有 vault 操作。CLI 命令细节参阅本 skill 的 references/obsidian-cli.md；确认 CLI 确实无法完成目标后，再使用文件编辑工具（见下方 Section Editing Protocol）。

Section Editing Protocol

前提：此协议要求 vault 文件位于本地文件系统，且 Agent 具有文件系统读写权限。

CLI 不支持"在指定标题下插入内容"或"替换某个 section 内容"。遇到此类需求时，使用以下三步协议：

触发条件

操作目标是"在某个 H2/H3/H4 标题下添加内容"或"修改/替换某个 section 中的内容"时触发。

Step 1 — 获取文件绝对路径

笔记的绝对路径 = vault 根路径 + "/" + 相对路径：

# 获取 vault 根路径
obsidian vault=MyObsidian info=path

# daily note：获取当日笔记相对路径
obsidian vault=MyObsidian daily:path

# 普通笔记：从 search 结果获取相对路径
obsidian vault=MyObsidian search query="笔记名"

Step 2 — 读取当前内容并定位 section

obsidian vault=MyObsidian read file="笔记名"

记录目标 heading 文本及其下的现有内容（到下一个同级或更高级 heading 为止）。

Step 3 — 用 Edit 工具精准修改

  • 插入到 heading 下：old_string = heading 行 + 现有内容，new_string = 原内容 + 新增内容
  • 替换 section 内容：old_string = heading 行 + 旧内容，new_string = heading 行 + 新内容
  • 禁止整篇覆写，除非执行"日末整理"等明确的全文重组任务

安全约束

  • 必须先 read 后 edit，不允许盲目 overwrite
  • old_string 必须包含足够上下文确保唯一匹配
  • 涉及 #Private / #Key 标签笔记时，拒绝操作并告知用户

Roles

识别用户意图，自动切换对应角色：

Note Creator

当用户要求记录、总结、整理信息为新笔记时：

  1. 根据 AGENTS.md 的目录语义判断笔记应放在哪个目录
  2. 遵循 frontmatter 规范，额外添加 source: ai-generated 字段
  3. 使用 wikilinks [[]] 主动链接 vault 中已有的相关笔记（如有）
  4. 不确定目录时，放入 00_Inbox/ 并告知用户

Note Editor

当用户要求修改、补充、更新已有普通笔记（非每日笔记）时：

  1. obsidian vault=MyObsidian read file="笔记名" 读取当前内容
  2. 确认操作类型并执行：
    • section 级修改/插入 → 走 Section Editing Protocol
    • 末尾追加 → obsidian vault=MyObsidian append file="笔记名" content="..."
    • frontmatter 属性修改 → obsidian vault=MyObsidian property:set name="字段" value="值" file="笔记名"
  3. 操作完成后告知用户具体变更了哪些内容

Inbox Organizer

当用户要求整理 Inbox 时：

  1. 列出 Inbox 所有笔记：obsidian vault=MyObsidian search query="" path="00_Inbox"
  2. 逐条读取并分析内容
  3. 根据内容判断适合的目标目录，建议标签（遵循嵌套标签规范）和 wikilinks
  4. 汇总所有建议后一次性呈现给用户，等待确认后再执行移动——不要自行移动笔记

Knowledge Retriever

当用户提问或需要查找信息时：

  1. 优先 obsidian vault=MyObsidian search query="关键词" 在 vault 中搜索
  2. 回答时引用已有笔记（如"参见 [[笔记名]]"）
  3. 若搜索返回空结果或内容不足：
    • 告知用户"vault 中未找到相关笔记"
    • 基于自身知识或外部搜索补充回答
    • 可建议将本次对话结果保存为新笔记（触发 Note Creator）

Daily Notes Collaborator

负责向每日笔记追加内容，以及日末整理。追加任务由 Task Manager 负责。

每日笔记结构约定：

Agent 生成的所有内容统一放在 ## 🤖 Assistant Generated section 下。首次追加前检查该 section 是否存在，不存在则先追加 header：

obsidian vault=MyObsidian daily:append content="## 🤖 Assistant Generated\n"

Section 存在性检查（通用规则）：

追加任何子 section 内容前，必须先 obsidian vault=MyObsidian daily:read 检查目标 section 是否已存在：

  • 已存在 → 直接追加内容，不重复 header
  • 不存在 → 追加时包含 header 前缀

追加内容：

根据内容性质选择对应的 section：

内容类型 section 标题 适用场景
结构化要点 ### 📝 Notes 会议记录、学习笔记
想法/感受 ### 💭 Thoughts 自由文本
网页链接 ### 🔗 Links H4 条目，见 Intent Router 
# section 不存在时（带 header）：
obsidian vault=MyObsidian daily:append content="### 📝 Notes\n<内容>"
# section 已存在时（直接追加）：
obsidian vault=MyObsidian daily:append content="<内容>"

时间敏感内容加 HH:MM 前缀。

日末整理：

当用户提到"整理今天"、"今日总结"、"daily review" 时触发：

  1. obsidian vault=MyObsidian daily:read 读取当日全文
  2. 内容整理：
    • ## 🤖 Assistant Generated 内：归并散落的同类 H3 section，顺序固定为 Notes → Thoughts → Links
    • ## 🤖 Assistant Generated 外的非任务内容：询问用户是否归入对应 section，不自动移动，由用户确认
  3. 展示重组后的完整内容给用户，确认无误后执行覆写： 
    # Step 3a: 获取当日笔记相对路径
obsidian vault=MyObsidian daily:path
# Step 3b: 覆写（overwrite flag 防止创建新文件）
obsidian vault=MyObsidian create path="<上一步路径>" content="<重组后全文>" overwrite silent
  4. obsidian vault=MyObsidian tasks daily 展示任务清单，供用户核查

Task Manager

当用户涉及任务查看或更新时：

# 新增任务写入笔记顶部（prepend 确保任务显示在最前）
obsidian vault=MyObsidian daily:prepend content="- [ ] 任务描述"

# 查看任务
obsidian vault=MyObsidian tasks daily            # 当日所有任务
obsidian vault=MyObsidian tasks todo path=<路径> # 指定笔记未完成任务
obsidian vault=MyObsidian tasks done path=<路径> # 指定笔记已完成任务
obsidian vault=MyObsidian tasks todo path="01_Daily"  # 扫描所有每日笔记

# 标记完成（line 为任务在文件中的行号）
obsidian vault=MyObsidian task daily line=<行号> done
obsidian vault=MyObsidian task path=<路径> line=<行号> done

工作流：

场景 操作
"今天还有什么没做" tasks daily todo 展示
"完成了 XXX"（当日） tasks daily 找行号 → task daily line=N done
"完成了 XXX"（历史） 用户告知日期或笔记名 → tasks todo path=<路径> 找行号 → task path=<路径> line=N done
"最近有哪些没做完的" tasks todo path="01_Daily" 汇总，按笔记（日期）分组展示
迁移历史未完成任务 追加到当日笔记，原笔记标记为 [-] 并添加 (已迁移至[[<笔记名>]])

Intent Router

触发条件：

情况 处理
消息仅含 URL（无其他文字，或只有 URL + 空格/标点） 直接执行，无需确认
消息含 URL + 明确意图词（"保存"、"记录"、"归档"、"clip"、"save"等） 直接执行，无需确认
URL 出现在较长消息中，意图不明 先确认："要保存到 Obsidian 吗？还是只需要我读一下？"
纯文字消息，无 URL 不触发
URL 明显是工具性的（localhost、内网地址、文件路径） 不触发

用户发送网页 URL 时，依次执行：

Step 1 — 获取正文

委托 defuddle skill 获取干净正文。

若 defuddle 失败（报错或返回空内容）：

  • 降级到 WebFetch 工具直接抓取页面内容
  • 若 WebFetch 也失败：跳过 Step 2，在 Step 3 中仅保存 URL 条目（备注"内容无法获取"），告知用户降级原因后结束

Step 2 — 剖析文章

从五个维度逐层剖析，输出给用户：

维度 关注点
文本解构 核心论点、支撑论据、逻辑关系
概念提炼 关键概念的精确含义及相互关联
批判审视 论证强弱、逻辑漏洞、视角局限
思想深化 隐含前提、未明言假设、哲学基础
实践转化 可行洞见与具体应用方法

要求:每个维度 3-5 行,保留对比表和关键数据.

Step 3 — 提炼并追加到每日笔记

按 Daily Notes Collaborator 的 section 存在性检查通用规则处理 ### 🔗 Links section：

# section 不存在时：
obsidian vault=MyObsidian daily:append content="### 🔗 Links\n<H4 条目>"
# section 已存在时：
obsidian vault=MyObsidian daily:append content="<H4 条目>"

每条链接格式：

#### [页面标题](url)
> 一句话摘要

- 要点一（来自剖析）
- 要点二

**🛠 Tools**: Cursor · Windsurf      ← 工具/软件（如有）
**📈 Stocks**: $AAPL Apple           ← 股票/市场（如有）
**👤 People**: 姓名（身份）           ← 人物（如有）
**📚 Resources**: 书名               ← 书籍/论文（如有）

Step 4 — 询问是否保存完整页面

追加后询问用户："要保存完整页面到 WebClips 吗？"

  • 是 → 全文保存到 31_WebClips/Assistant_Clips/<标题>.md，H4 标题行末附 → [[标题]]
  • 否 → 结束

例外：若用户原始消息中已明确说"保存全文"、"clip 完整页面"、"save full"等，则跳过询问直接执行保存。

Skill Delegation

委托时机

需求 处理方式
普通笔记增删改查 直接使用 obsidian CLI，无需委托
创建格式复杂的结构化文档（含模板、特定规范） 委托 obsidian-markdown skill
创建 .base 数据库视图 委托 obsidian-bases skill
创建 .canvas 可视化画布 委托 json-canvas skill
写技术文档、方案等结构化内容 委托 doc-coauthoring skill
写内部沟通（3P updates、状态报告等） 委托 internal-comms skill

上述 vault skills 的路径：$(obsidian vault=MyObsidian info=path)/.agents/skills/。

技能优先级说明

obsidian-knowledge（本文件）是主规范，定义所有角色、工作流和决策逻辑。CLI 命令细节查阅本 skill 的 references/obsidian-cli.md。

Privacy Boundaries

这些是硬性边界，不可违反：

  • 不读取/修改带 #Private 或 #Key 标签的笔记
  • 不操作 30_Permanent/MyConfig/ 中的敏感配置
  • 不操作 99_Plugconfig/ 中的插件配置
  • 遇到上述内容时，告知用户你无法访问并说明原因
Weekly Installs
2
Repository
zhuxining/skills
First Seen
1 day ago
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykWarn
Installed on
amp2
cline2
openclaw2
opencode2
cursor2
kimi-cli2