obsidian-master-skill

obsidian-master-skill

适用于所有 Obsidian 知识库操作的统一技能——创建笔记、搜索、知识库健康状况、知识捕获、Bases 和每日日记。采用渐进式披露：下方列出基本规则，深入参考内容见 reference/。

目录结构

obsidian-master-skill/
├── SKILL.md                          # This file (overview + quick reference)
├── reference/                        # Detailed documentation
│   ├── markdown.md                   # Obsidian Flavored Markdown syntax
│   ├── vault-organization.md         # PARA folders, frontmatter, Dataview
│   ├── rest-api.md                   # Local REST API, URI scheme, plugin API
│   ├── bases.md                      # .base YAML schema, filters, formulas
│   ├── integration-patterns.md       # Claude Code integration patterns
│   └── knowledge-capture.md          # ADR, concept, how-to, meeting templates
├── Workflows/                        # Step-by-step workflow definitions
│   ├── CreateNote.md                 # Create notes with templates + PARA placement
│   ├── SearchVault.md                # DQL, content search, tag filtering
│   ├── ManageVault.md                # Health checks, orphans, broken links
│   ├── CaptureKnowledge.md           # Extract insights from conversations
│   ├── CreateBase.md                 # Build .base database views
│   ├── DailyNote.md                  # Daily note creation/enhancement
│   ├── ProcessInbox.md               # Triage inbox into PARA folders
│   └── SyncDocs.md                   # Sync external project docs to vault
└── Tools/                            # Python CLI tools (click + httpx)
    ├── SearchVault.py                # status, auth, search (dataview|content|jsonlogic)
    ├── VaultManager.py               # health, orphans, broken-links, lifecycle, move, inbox
    ├── NoteCreator.py                # create, daily, capture
    └── BaseBuilder.py                # create, validate, preview

工作流路由

意图	工作流	工具
创建笔记（任意类型）	Workflows/CreateNote.md	Tools/NoteCreator.py
搜索知识库（DQL、内容、标签）	Workflows/SearchVault.md	Tools/SearchVault.py
知识库健康状况、孤立笔记、失效链接	Workflows/ManageVault.md	Tools/VaultManager.py
从对话中提取知识	Workflows/CaptureKnowledge.md	Tools/NoteCreator.py
创建/编辑 .base 数据库视图	Workflows/CreateBase.md	Tools/BaseBuilder.py
创建/完善每日笔记	Workflows/DailyNote.md	Tools/NoteCreator.py
将收件箱笔记整理到 PARA	Workflows/ProcessInbox.md	Tools/VaultManager.py
将项目文档同步到知识库	Workflows/SyncDocs.md	Tools/VaultManager.py

快速参考

PARA 文件夹映射

文件夹	用途	笔记类型
00 - Inbox/	快速捕获、待整理内容	随想
00 - Maps of Content/	索引笔记	MOC、仪表板
01 - Projects/	活跃项目	项目文档
02 - Areas/	持续性职责	领域概览
03 - Resources/	参考资料	常青笔记
04 - Archive/	已完成/不活跃内容	已归档项目
04 - Permanent/	Zettelkasten 笔记	原子化想法
06 - Daily/	每日日记（YYYY/MM/YYYYMMDD.md）	日记条目
08 - books/	书籍笔记	阅读笔记
10 - 1-1/	会议笔记	一对一会议

深入了解：reference/vault-organization.md

Frontmatter 架构

标准笔记：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
tags:
  - category/subcategory
---

每日笔记（v2.0）：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
title: YYYYMMDD
type: daily-note
status: true
tags:
  - daily
  - y/YYYY
  - y/YYYY-MM
aliases:
  - YYYY-MM-DD
date_formatted: YYYY-MM-DD
cssclasses:
  - daily
---

项目笔记：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
type: project
status: active | paused | complete
priority: high | medium | low
tags:
  - project/name
---

深入了解：reference/vault-organization.md

链接约定

[[Note Name]]                    # Wikilink
[[Note Name|Display Text]]       # Aliased link
[[Note Name#Heading]]            # Heading link
[[Note Name#^block-id]]          # Block reference
![[Note Name]]                   # Embed note
![[image.png]]                   # Embed image
![[image.png|300]]               # Embed with width

深入了解：reference/markdown.md

常用 Dataview 查询

LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC

TABLE status, tags FROM "01 - Projects" WHERE status != "completed"

TABLE WITHOUT ID file.link AS "Note", file.mtime AS "Modified"
FROM "03 - Resources" SORT file.mtime DESC LIMIT 20

LIST FROM "" WHERE length(file.inlinks) = 0 AND length(file.outlinks) = 0

深入了解：reference/vault-organization.md

知识捕获信号

对话中的信号	捕获类型	目标位置
“我们决定……”	ADR	03 - Resources/decisions/
“X 是什么？”/“X 的工作原理是……”	概念	04 - Permanent/
“如何……”/“步骤……”	操作指南	03 - Resources/howtos/
“在会议中……”	会议笔记	10 - 1-1/
“跟踪所有关于……的笔记”	MOC	00 - Maps of Content/
快速见解或待办事项	追加到每日笔记	06 - Daily/YYYY/MM/YYYYMMDD.md

深入了解：reference/knowledge-capture.md

Callout 类型

> [!note] Title
> Content

> [!tip]+ Expandable (default open)
> [!info]- Collapsed (default closed)

类型：note、abstract/summary/tldr、info、todo、tip/hint/important、success/check/done、question/help/faq、warning/caution/attention、failure/fail/missing、danger/error、bug、example、quote/cite

深入了解：reference/markdown.md

REST API 快速入门

# Requires Local REST API plugin enabled in Obsidian
export OBSIDIAN_API_KEY="your-key"
export OBSIDIAN_BASE_URL="https://127.0.0.1:27124"

curl -H "Authorization: Bearer $OBSIDIAN_API_KEY" $OBSIDIAN_BASE_URL/vault/

端点	方法	用途
/vault/{path}	GET/PUT/DELETE/PATCH	文件 CRUD
/search/simple/	POST	文本搜索
/search/	POST	Dataview 查询
/search/jsonlogic/	POST	复杂筛选
/active/	GET/PUT	活动文件
/commands/{id}	POST	执行命令

深入了解：reference/rest-api.md

Base 文件快速入门

# example.base — table of active projects
filters:
  and:
    - file.inFolder("01 - Projects")
    - 'status == "active"'
views:
  - type: table
    name: "Active Projects"
    order: [file.name, status, priority, due_date]

嵌入：![[example.base]] 或 ![[example.base#View Name]]

深入了解：reference/bases.md

工具（Python）

所有工具均使用 click CLI、httpx 处理 REST API、pyyaml 处理 frontmatter、pathlib 直接访问文件。双模式：Obsidian 运行时使用 REST API，否则回退到直接访问文件。

工具	命令
Tools/SearchVault.py	status、auth、search --type dataview|content|jsonlogic
Tools/VaultManager.py	health、orphans、broken-links、lifecycle、move、inbox
Tools/NoteCreator.py	create、daily、capture
Tools/BaseBuilder.py	create、validate、preview

示例

"Create a new project note for API redesign"     -> Workflows/CreateNote.md
"Search my vault for notes about Kubernetes"      -> Workflows/SearchVault.md
"Find orphan notes and suggest connections"       -> Workflows/ManageVault.md
"Save what we just discussed as an ADR"           -> Workflows/CaptureKnowledge.md
"Create a base view of all active projects"       -> Workflows/CreateBase.md
"Create today's daily note"                       -> Workflows/DailyNote.md
"Process my inbox"                                -> Workflows/ProcessInbox.md
"What's the Obsidian markdown syntax for X?"      -> reference/markdown.md
"How do I use the REST API?"                      -> reference/rest-api.md
"How do bases formulas work?"                     -> reference/bases.md

Neovim 参考

有关 obsidian.nvim 配置，请参阅 reference/integration-patterns.md 中的 Neovim 集成部分。