Back to Details

obsidian-organize

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Obsidian 知识库整理 Skill

Obsidian Knowledge Base Organization Skill

概述

Overview

此 Skill 定义了 Obsidian 知识库文件夹整理 的标准操作流程，目标是将混乱的目录结构精简为 7-10 个顶级分类。
This Skill defines the standard operating procedure for Obsidian Knowledge Base Folder Organization, aiming to streamline messy directory structures into 7-10 top-level categories.

核心原则

Core Principles

  1. 7±2 原则 - 顶级文件夹控制在 5-9 个（认知负载最优）
  2. MECE 原则 - 分类互斥且穷尽，避免重叠
  3. 渐进式 - 保留原结构痕迹，便于回溯
  4. 安全第一 - 合并前确认，删除前备份
  1. 7±2 Principle - Keep top-level folders between 5-9 (optimal cognitive load)
  2. MECE Principle - Mutually Exclusive and Collectively Exhaustive, avoiding overlaps
  3. Incremental Approach - Retain traces of the original structure for easy backtracking
  4. Safety First - Confirm before merging, backup before deleting

标准分类体系（推荐）

Recommended Standard Classification System

分类命名包含内容
收件箱
_Inbox
未分类笔记、临时文件、待处理内容
附件
_attachments
图片、PDF、音频等媒体文件
日记
Journal
日记、周记、月度复盘、年度总结
阅读
Reading
书籍笔记、文章摘录、播客记录
工作
Work
工作项目、会议纪要、团队分享
技术
Tech
技术笔记、代码片段、工具配置
人物
People
人物档案、社交关系、联系方式
项目
Projects
个人项目、副业、创业想法
成长
Growth
认知提升、学习计划、技能发展
注意：
_
前缀使系统文件夹排在最前
CategoryNamingIncluded Content
Inbox
_Inbox
Uncategorized notes, temporary files, pending content
Attachments
_attachments
Images, PDFs, audio and other media files
Journal
Journal
Daily journals, weekly reviews, monthly retrospectives, annual summaries
Reading
Reading
Book notes, article excerpts, podcast records
Work
Work
Work projects, meeting minutes, team shares
Tech
Tech
Technical notes, code snippets, tool configurations
People
People
Person profiles, social relationships, contact information
Projects
Projects
Personal projects, side hustles, entrepreneurial ideas
Growth
Growth
Cognitive improvement, study plans, skill development
Note: The 
_
prefix ensures system folders are displayed first

标准操作流程 (SOP)

Standard Operating Procedure (SOP)

Phase 1: 分析现状

Phase 1: Analyze Current Status

  1. 定位 Obsidian Vault 路径（通常在 
    ~/Documents/Obsidian Vault/
    ）
  2. 统计现有顶级文件夹数量和名称
  3. 统计各文件夹内文件数量
  4. 识别重复/相似/可合并的分类
bash
undefined
  1. Locate the Obsidian Vault path (usually in 
    ~/Documents/Obsidian Vault/
    )
  2. Count the number and names of existing top-level folders
  3. Count the number of files in each folder
  4. Identify duplicate/similar/mergeable categories
bash
undefined

查看目录结构

View directory structure

ls -la "/path/to/Obsidian Vault/"
ls -la "/path/to/Obsidian Vault/"

统计各文件夹文件数

Count files in each folder

for dir in "/path/to/Obsidian Vault/"*/; do echo "$(basename "$dir"): $(find "$dir" -type f | wc -l) files" done
undefined
for dir in "/path/to/Obsidian Vault/"*/; do echo "$(basename "$dir"): $(find "$dir" -type f | wc -l) files" done
undefined

Phase 2: 制定整理计划

Phase 2: Develop Organization Plan

根据现有文件夹，制定合并映射表：
markdown
| 原文件夹 | 目标分类 | 操作 |
|---------|---------|------|
| 日记/ | Journal | 合并 |
| 当日日记/ | Journal | 合并 |
| books/ | Reading | 合并 |
| 读书/ | Reading | 合并 |
| QAL分享/ | Work | 合并 |
| 临时文件/ | _Inbox | 合并 |
Create a merge mapping table based on existing folders:
markdown
| Original Folder | Target Category | Action |
|-----------------|-----------------|--------|
| 日记/ | Journal | Merge |
| 当日日记/ | Journal | Merge |
| books/ | Reading | Merge |
| 读书/ | Reading | Merge |
| QAL分享/ | Work | Merge |
| 临时文件/ | _Inbox | Merge |

Phase 3: 执行合并

Phase 3: Execute Merging

合并操作模板（使用 cp + rm 更安全）：
bash
undefined
Merge Operation Template (Using cp + rm is safer):
bash
undefined

1. 创建目标目录（如不存在）

1. Create target directory if it doesn't exist

mkdir -p "/path/to/Obsidian Vault/TargetFolder"
mkdir -p "/path/to/Obsidian Vault/TargetFolder"

2. 复制源文件夹内容到目标

2. Copy contents from source folder to target

cp -r "/path/to/Obsidian Vault/SourceFolder/"* "/path/to/Obsidian Vault/TargetFolder/"
cp -r "/path/to/Obsidian Vault/SourceFolder/"* "/path/to/Obsidian Vault/TargetFolder/"

3. 确认复制成功后删除源文件夹

3. Delete source folder after confirming successful copy

rm -rf "/path/to/Obsidian Vault/SourceFolder"

**批量合并示例**：

```bash
VAULT="/Users/xxx/Documents/Obsidian Vault"
rm -rf "/path/to/Obsidian Vault/SourceFolder"

**Batch Merging Example**:

```bash
VAULT="/Users/xxx/Documents/Obsidian Vault"

合并日记类

Merge journal-related folders

mkdir -p "$VAULT/Journal" cp -r "$VAULT/日记/"* "$VAULT/Journal/" 2>/dev/null cp -r "$VAULT/当日日记/"* "$VAULT/Journal/" 2>/dev/null rm -rf "$VAULT/日记" "$VAULT/当日日记"
mkdir -p "$VAULT/Journal" cp -r "$VAULT/日记/"* "$VAULT/Journal/" 2>/dev/null cp -r "$VAULT/当日日记/"* "$VAULT/Journal/" 2>/dev/null rm -rf "$VAULT/日记" "$VAULT/当日日记"

合并阅读类

Merge reading-related folders

mkdir -p "$VAULT/Reading" cp -r "$VAULT/books/"* "$VAULT/Reading/" 2>/dev/null cp -r "$VAULT/读书/"* "$VAULT/Reading/" 2>/dev/null rm -rf "$VAULT/books" "$VAULT/读书"
undefined
mkdir -p "$VAULT/Reading" cp -r "$VAULT/books/"* "$VAULT/Reading/" 2>/dev/null cp -r "$VAULT/读书/"* "$VAULT/Reading/" 2>/dev/null rm -rf "$VAULT/books" "$VAULT/读书"
undefined

Phase 4: 验证结果

Phase 4: Verify Results

  1. 检查顶级文件夹数量是否 ≤ 10
  2. 确认无空文件夹残留
  3. 抽查合并后文件是否完整
  4. 更新 Obsidian 索引（重启 Obsidian 或刷新）
bash
undefined
  1. Check if the number of top-level folders is ≤ 10
  2. Confirm no empty folders remain
  3. Spot-check if merged files are complete
  4. Update Obsidian index (restart Obsidian or refresh)
bash
undefined

统计最终结构

Count final structure

ls -d "$VAULT"/*/ | wc -l
ls -d "$VAULT"/*/ | wc -l

查找空目录

Find empty directories

find "$VAULT" -type d -empty
undefined
find "$VAULT" -type d -empty
undefined

常见问题处理

Common Issue Handling

路径包含空格

Path Contains Spaces

bash
undefined
bash
undefined

错误

Error

cd /path/Obsidian Vault # 会失败
cd /path/Obsidian Vault # Will fail

正确

Correct

cd "/path/Obsidian Vault"
undefined
cd "/path/Obsidian Vault"
undefined

文件夹名有特殊字符

Folder Name Contains Special Characters

bash
undefined
bash
undefined

文件夹名以空格开头（如 " books"）

Folder name starts with space (e.g., " books")

rm -rf "/path/ books" # 包含空格
undefined
rm -rf "/path/ books" # Include the space
undefined

rmdir 失败（目录非空）

rmdir Fails (Directory Not Empty)

bash
undefined
bash
undefined

使用 rm -rf 替代 rmdir

Use rm -rf instead of rmdir

rm -rf "/path/to/folder"
undefined
rm -rf "/path/to/folder"
undefined

合并时文件冲突

File Conflicts During Merging

bash
undefined
bash
undefined

使用 -n 避免覆盖

Use -n to avoid overwriting

cp -rn source/* dest/
cp -rn source/* dest/

或使用 rsync 更精细控制

Or use rsync for finer control

rsync -av --ignore-existing source/ dest/
undefined
rsync -av --ignore-existing source/ dest/
undefined

整理前后对比示例

Before/After Organization Example

整理前（20+ 文件夹）：
APP.ai/
Memory Engineering/
QAL分享/
books/
secondme/
信息熵/
当日日记/
日记/
读书/
鲲鹏会/
...（共 20+ 个）
整理后（10 文件夹）：
_Inbox/          # 临时文件
_attachments/    # 附件
AI-Engineering/  # AI 技术
Cognitive-Growth/# 认知成长
Journal/         # 日记
People/          # 人物
Reading/         # 阅读
Tech-Foundation/ # 技术基础
Travel-Product/  # 旅行产品
Work-Sharing/    # 工作分享
Before (20+ folders):
APP.ai/
Memory Engineering/
QAL分享/
books/
secondme/
信息熵/
当日日记/
日记/
读书/
鲲鹏会/
... (Total 20+)
After (10 folders):
_Inbox/          # Temporary files
_attachments/    # Attachments
AI-Engineering/  # AI Technology
Cognitive-Growth/# Cognitive Growth
Journal/         # Journal
People/          # People
Reading/         # Reading
Tech-Foundation/ # Technical Foundation
Travel-Product/  # Travel Products
Work-Sharing/    # Work Sharing

使用示例

Usage Examples

示例 1：快速整理

Example 1: Quick Organization

用户: 我的 Obsidian 太乱了，帮我整理一下

Claude:
1. [定位 Vault 路径]
2. [统计现有文件夹]
3. [制定合并计划]
4. [用户确认后执行]
5. [验证结果]
User: My Obsidian is too messy, help me organize it

Claude:
1. [Locate Vault path]
2. [Count existing folders]
3. [Develop merge plan]
4. [Execute after user confirmation]
5. [Verify results]

示例 2：指定目标数量

Example 2: Specify Target Category Count

用户: 把我的 Obsidian 整理到 7 个分类以内

Claude:
1. [分析现有结构]
2. [设计 7 分类方案]
3. [展示合并映射表]
4. [执行并验证]
User: Organize my Obsidian into no more than 7 categories

Claude:
1. [Analyze current structure]
2. [Design 7-category scheme]
3. [Show merge mapping table]
4. [Execute and verify]

注意事项

Notes

  1. 备份优先 - 大规模整理前建议备份整个 Vault
  2. 渐进执行 - 一次合并一个分类，确认无误后继续
  3. 保留索引 - 不要删除 
    .obsidian/
    配置目录
  4. 更新链接 - 合并后检查双链是否需要更新（Obsidian 通常自动处理）
  1. Backup First - It is recommended to back up the entire Vault before large-scale organization
  2. Incremental Execution - Merge one category at a time, proceed only after confirmation
  3. Retain Index - Do not delete the 
    .obsidian/
    configuration directory
  4. Update Links - Check if double links need updating after merging (Obsidian usually handles this automatically)

相关资源

Related Resources

  • Obsidian 官方文档：https://help.obsidian.md/
  • PARA 方法论：Projects, Areas, Resources, Archives
  • Johnny Decimal 系统：数字化分类法
  • Obsidian Official Documentation: https://help.obsidian.md/
  • PARA Methodology: Projects, Areas, Resources, Archives
  • Johnny Decimal System: Digital Classification Method