Obsidian Best Practices (obos)
有主见的 Obsidian vault 管理系统。核心循环：收集 → 整理 → 连接 → 回顾。
Commands
Command Description
/obos save ["内容"]
快速收集想法到 Inbox（核心命令）
/obos tidy
整理笔记归位（支持 standard/strong 模式）
/obos sync
更新索引 + 健康报告 + 链接建议
/obos review
Vault 状态回顾 + 下一步建议
/obos init
初始化 vault 结构
/obos vault
管理多个 vault 注册
/obos refine [note]
深度加工笔记（进阶）
/obos ask "question"
查询知识库（进阶）
/obos draft "topic"
基于笔记起草文章（进阶）
No argument → show grouped command list:
核心：save, tidy, sync, review 设置：init, vault 进阶：refine, ask, draft
Tidy 默认策略
/obos tidy 默认按 standard 模式运行，并启用幂等增量整理：
-
重复执行时，已整理且未变更的文件会被跳过，不重复迁移
-
自动重命名默认只执行一次；检测到手动改名后自动锁定（name_locked: true ）
-
项目目录默认 project-policy=contain ：项目结构冻结，不打散且不改内部层级/文件名
-
通过 /.obos/tidy-state.json 与 frontmatter 双重判定稳定性
-
通过 /.obos/tidy-config.json 可扩展项目目录白名单（projectRootsExtra ）
-
strong 模式先进行目录必要性评估（KEEP / REORGANIZE / ARCHIVE_DIR）
-
目录评估审计输出到 /.obos/dir-audit.json
-
默认不删除 markdown 文档（deleteMarkdown=false ），仅清理空目录
Multi-Vault 配置
配置文件：~/.proma/agent-workspaces/obsidian/obos-config.json
{ "vaults": { "personal": { "path": "D:/obsidian/personal", "default": true }, "work": { "path": "C:/Users/.../work-vault" } }, "lastUsedVault": "personal" }
Vault Path Discovery
所有命令共享此逻辑（按优先级）：
-
命令参数 --to <alias> 指定的 vault
-
obos-config.json 中的 default vault
-
当前工作目录（如果包含 .obsidian/ 或 vault CLAUDE.md）
-
如果以上都不存在，用 AskUserQuestion 引导用户注册 vault
Vault Structure
Vault/ ├── CLAUDE.md # AI context file ├── Index.md # AI-readable index (auto-generated) ├── Inbox/ # 收集入口（save 写入此处） ├── Notes/ # Evergreen notes ├── Clippings/ # Web clippings ├── References/ # Source materials ├── Attachments/ # Images and files ├── Categories/ # MOC index pages └── Templates/ # Note templates
Knowledge Maturity Model
Frontmatter status 字段：
-
inbox — 刚收集，未整理
-
draft — 已分类，未深度加工
-
refined — 经过 /obos refine 深度加工
Evergreen Note Template
status: {{inbox|draft|refined}} source: {{attribution}} created: {{YYYY-MM-DD}}
{{title}}
Core Idea
One sentence in your own words.
My Understanding
Why it matters. What you agree/disagree with.
Open Questions
What new questions does this raise?
Related
- [[]]
Command Routing
Parse the first argument after /obos and load the matching commands/{command}.md file. If no argument, show the grouped command list above and ask what the user wants to do.