Quartz 4

AGENTS

8 min read

AGENTS.md - Obsidian 知识管理系统指南

仓库概述

这是一个基于 Obsidian 的个人知识管理仓库，采用防弹笔记法（Bulletproof Notes）为核心方法论。

核心原则：

  • 使用最少插件（LiveSync、Periodic Notes、Style Settings）
  • MOC（内容地图）代替目录结构
  • 标签仅使用 #type/* 和 #state/*
  • 高强度使用 TEMP 笔记作为暂存区
  • 定期归档整理

文件夹结构

.
├── 1-Source/        # 资源和源材料
├── 3-Weekly/        # 周记（由 Periodic Notes 自动创建）
├── 7-Works/         # 工作相关内容
├── 8-Archive/       # 归档内容
├── z-System/        # 系统和配置文件
├── .obsidian/       # Obsidian 配置（不编辑）
├── .trash/          # 已删除笔记（不编辑）
└── *.md            # 根目录放置核心 MOC 和 TEMP 笔记

笔记命名约定

  • 问题笔记：Q-具体问题.md
  • MOC：主题-MOC.md 或 MOC-主题.md
  • 项目：Project-项目名.md
  • 日期笔记：YYYYMMDD-标题.md
  • TEMP 笔记：Work-TEMP.md、Personal-TEMP.md
  • 系统指南：20260102-说明文档.md

标签系统

Type 标签（笔记类型）

  • #type/Question - 问题笔记（以 Q- 开头）
  • #type/Note - 常规笔记
  • #type/MOC - 内容地图
  • #type/Guide - 指南文档
  • #type/Project - 项目笔记
  • #type/Daily - 日记
  • #type/Weekly - 周记

State 标签（笔记状态）

  • #state/draft - 草稿状态
  • #state/active - 正在进行中
  • #state/done - 已完成
  • #state/archived - 已归档
  • #state/temp - 临时笔记（用于 TEMP）

严格限制： 不要创建除 type/* 和 state/* 之外的其他标签

MOC（内容地图）规则

何时创建 MOC

  • 某个主题下累积了 5+ 篇笔记
  • 需要索引快速定位相关内容
  • 想整理某个领域的知识结构

MOC 结构模板

#type/MOC
 
## 概述
简要说明这个主题的范围
 
## 核心笔记
- [[关键笔记1]]
- [[关键笔记2]]
 
## 相关问题
- [[Q-问题1]]
 
## 项目
- [[项目A]]
 
## 相关 MOC
- [[相关主题MOC]]

MOC 维护原则

  • 不要过度设计层级结构
  • 每周整理时更新
  • 同一笔记可出现在多个 MOC
  • 使用 Markdown 链接，不使用绝对路径

TEMP 笔记使用规范

TEMP 笔记原则

  • 所有新想法、临时信息先放入 TEMP
  • 记录时不纠结分类和整理
  • 使用 - [ ] 标记待办
  • 使用 [[链接]] 标记可能展开的主题

TEMP → 正式笔记转化标准

应该转化：

  • 需要保留的知识点
  • 值得展开的问题
  • 重复出现的主题
  • 与现有笔记有连接的内容
  • 明确的项目或任务

可以直接清理：

  • 已完成的临时任务
  • 过时的信息
  • 重复的内容
  • 无法执行的模糊想法
  • 不再相关的临时备忘

归档规则

归档频率

  • 每周：快速扫描，归档明显完成的内容
  • 每月：深度整理，归档不再活跃的项目
  • 每季度：重新审视归档内容，决定永久保留或删除

归档方法

  1. 将已完成的项目标记为 #state/done → #state/archived
  2. 移动到 8-Archive/ 文件夹
  3. 在相关 MOC 中移除链接
  4. 保留反向链接便于追溯

维护流程

每日（5-15 分钟）

  • 整理 TEMP 笔记
  • 完善草稿笔记
  • 更新任务状态

每周（30-45 分钟）

  • 回顾 Weekly Note
  • 更新主要 MOC
  • 归档完成的内容
  • 清理 #state/draft 笔记

每月（1-2 小时）

  • 深度归档
  • 重构 MOC 结构
  • 检查并删除重复笔记
  • 备份整个仓库

每季度（2-3 小时）

  • 审视整体笔记系统
  • 评估标签系统是否需要调整
  • 清理 Archive
  • 更新 Q-如何使用obsidian-完善版.md

Markdown 格式规范

Frontmatter

---
title: 笔记标题
aliases:
  - 别名1
  - 别名2
tags:
  - #type/Note
  - #state/active
created: 2026-01-04 10:00:00
updated: 2026-01-04 10:00:00
---

链接格式

  • 内部链接：[[笔记名称]]（使用 Obsidian 链接语法）
  • 外部链接：使用标准 Markdown [文本](URL)
  • 避免使用绝对路径或文件扩展名

列表格式

  • 使用 - [ ] 表示待办任务
  • 使用 - [x] 表示已完成任务
  • 使用 - 表示普通列表项

标题格式

  • 使用 ## 表示二级标题
  • 使用 ### 表示三级标题
  • 标题使用中文，简洁明了

Obsidian 插件配置

核心插件（固定使用）

  1. Selfhosted LiveSync - 同步仓库
  2. Periodic Notes - 自动创建周记
  3. Style Settings - 样式管理

禁止添加插件

  • 不要随意安装新插件
  • 每个插件都会增加维护成本
  • 优先使用 Obsidian 原生功能

配置文件

  • .obsidian/ 目录下所有配置文件由 Obsidian 管理
  • 不要手动编辑 .obsidian/ 下的配置
  • 使用 Obsidian 界面进行配置修改

搜索和检索

推荐搜索方式

  1. 快速切换：Cmd/Ctrl + O 按文件名跳转
  2. 全局搜索：Cmd/Ctrl + Shift + F 搜索内容
  3. 标签面板：点击标签查看同类笔记
  4. 反向链接：查看哪些笔记引用了当前笔记

搜索语法示例

  • tag:#type/Question - 查找所有问题笔记
  • tag:#state/draft - 查找所有草稿
  • content:"关键词" - 搜索内容关键词

常见操作规范

创建新笔记

  1. 先评估是否需要创建（考虑放入 TEMP）
  2. 确定合适的命名（参考命名约定）
  3. 添加正确的 type 和 state 标签
  4. 在相关 MOC 中添加链接

编辑现有笔记

  1. 保持原有格式和风格
  2. 更新 updated 时间戳
  3. 如果状态改变，更新 state 标签
  4. 及时清理过时内容

删除笔记

  1. 移动到 .trash/ 目录（不要直接删除）
  2. 在相关 MOC 中移除链接
  3. 考虑是否有必要保留在 Archive 中

参考资源

  • Q-如何使用obsidian-完善版.md - 详细使用指南
  • 20260102-为什么我们需要一个TEMP笔记.md - TEMP 设计理念
  • Q-如何使用obsidian.md - 简要说明
  • Obsidian.md - Obsidian 相关信息
  • MOCs.md - MOC 总索引（待完善）

注意事项

  1. 保持简洁：笔记内容简洁明了，避免冗长
  2. 及时整理：不要让 TEMP 笔记堆积
  3. 定期归档：保持活跃笔记的整洁
  4. 避免过度分类：使用标签和 MOC 而非复杂目录
  5. 重视连接：通过链接建立笔记之间的联系

最后更新：2026-01-04

Graph View

Backlinks