my-vault/06_Metadata/HERMES_ASSISTANT_GUIDE.md

# Hermes Assistant 使用说明

**用途**：说明如何在这个 Obsidian vault 中，正确使用 assistant 与 skills 做检索、整理、总结与知识沉淀  
**Vault 路径**：`/home/windy/.hermes/ObsidianVault`  
**主技能**：`obsidian`  
**知识沉淀技能**：`llm-wiki`

---

## 1. 文档目标

这份文档不是介绍 Obsidian 功能本身，而是说明：

- 什么时候该让 assistant 介入
- 什么时候该用哪个 skill
- assistant 在这个 vault 里最适合做什么
- 如何避免 assistant 把 vault 越改越乱

一句话原则：

**你负责判断什么值得留下，assistant 负责搜索、整理、连接、总结和结构化。**

---

## 2. assistant 在这个 vault 里的正确角色

assistant 最适合扮演四种角色：

### 2.1 收件箱整理器

适用于 `00_Inbox/`

- 扫描新笔记
- 判断它们更像 Project / Area / Resource / Archive
- 找出未命名、空内容、重复、低价值笔记
- 提供重命名、合并、迁移建议

### 2.2 检索总结器

适用于整个 vault

- 搜索某主题的相关笔记
- 做总结与对比
- 提取重点
- 找出相关链接和缺失链接

### 2.3 结构维护器

适用于已有笔记的维护

- 统一 frontmatter
- 规范标题
- 保护 wikilinks
- 拆分过长笔记
- 保持 PARA 结构清晰

### 2.4 知识编译器

适用于 `airport-wiki/` 或其他长期知识区

- 导入资料
- 更新概念页与实体页
- 维护索引和日志
- 避免重复沉淀同一知识

---

## 3. 技能选择规则

这是最重要的部分。不要模糊地说“帮我整理笔记”，而要先知道该用哪个 skill。

### 3.1 默认先用 `obsidian`

只要你的目标是下面这些，就先用 `obsidian`：

- 读笔记
- 搜索笔记
- 创建笔记
- 更新笔记
- 整理 inbox
- 生成项目总结
- 做 weekly review
- 找孤儿笔记
- 找重复或相近笔记
- 统一标题、frontmatter、链接

可以理解为：

**凡是 vault 日常管理，先用 `obsidian`。**

### 3.2 只有在“知识沉淀”场景下才用 `llm-wiki`

当你的目标从“管理笔记”变成“构建持续演化的知识库”时，用 `llm-wiki`。

典型场景：

- 把一篇文章沉淀进 `airport-wiki/`
- 把多份资料编译成概念页
- 更新某个已存在的研究主题页
- 维护 `SCHEMA.md`、`index.md`、`log.md`

可以理解为：

**凡是研究知识的长期编译，用 `llm-wiki`。**

### 3.3 技能选择决策树

按这个顺序判断：

1. 这是日常笔记管理吗？
   是：用 `obsidian`

2. 这是长期知识库建设吗？
   是：用 `llm-wiki`

3. 这是要改 `.md` 内容但必须保护 Obsidian 语法吗？
   仍优先用 `obsidian`，并在提示词里明确要求保留 wikilinks、frontmatter、callouts

4. 这是要大范围重构很多笔记吗？
   仍先用 `obsidian`，但要求 assistant 先给变更方案，不要直接改

### 3.4 对你当前 vault 的推荐分工

- `00_Inbox/` -> `obsidian`
- `01_Projects/` -> `obsidian`
- `02_Areas/` -> `obsidian`
- `03_Resources/` -> `obsidian`
- `04_Archive/` -> 通常也是 `obsidian`
- `airport-wiki/` -> `llm-wiki`

---

## 4. 你的 vault 该怎么配合 assistant 使用

### 4.1 `00_Inbox/`

用途：快速捕获，不做即时分类

正确做法：

- 先写进去
- 不急着归档
- 让 assistant 扫描并提出分类建议

assistant 适合做：

- 分类到 PARA
- 标记需要重命名的笔记
- 找出明显可以归档的内容
- 识别是否和已有项目或资源相关

### 4.2 `01_Projects/`

用途：有开始和结束的主动项目

assistant 适合做：

- 识别项目状态
- 提取 next actions
- 找出卡住的项目
- 找出长期没有更新的项目
- 连接相关资源和 area

### 4.3 `02_Areas/`

用途：长期维护的责任领域

assistant 适合做：

- 汇总当前状态
- 发现长期问题
- 连接相关项目
- 更新 area overview

### 4.4 `03_Resources/`

用途：长期保留的知识和参考资料

assistant 适合做：

- 搜索同主题资料
- 做综合总结
- 发现缺失链接
- 提议新增 synthesis note

### 4.5 `airport-wiki/`

用途：结构化知识库，不是普通资料夹

assistant 适合做：

- 导入研究资料
- 更新概念页、实体页、比较页
- 维护 index / schema / log
- 避免同主题重复建页

---

## 5. 最稳妥的提示词模式

如果你想让 assistant 工作稳定，提示词应包含三类约束：

1. 指定 skill
2. 指定范围
3. 指定改动策略

推荐句式：

```text
Use the obsidian skill. [task]. Propose changes before applying them.
```

```text
Use the obsidian skill. [task]. Search existing related notes before creating anything new.
```

```text
Use the llm-wiki skill. [task]. Update existing pages if they already exist and avoid duplicates.
```

### 5.1 推荐提示词模板

#### 收件箱整理

```text
Use the obsidian skill. Review notes in 00_Inbox, classify them by PARA, and propose changes before applying them.
```

#### 搜索与总结

```text
Use the obsidian skill. Search my vault for notes about PKM and summarize the main ideas with related links.
```

#### 项目状态检查

```text
Use the obsidian skill. Review 01_Projects and tell me which projects are active, stale, or blocked.
```

#### 周回顾

```text
Use the obsidian skill. Build a weekly review from notes changed in the last 7 days across 01_Projects and 02_Areas.
```

#### 新建笔记前先搜索

```text
Use the obsidian skill. Search for existing related notes before creating anything new, then create the smallest correct note.
```

#### 保护 Obsidian 语法

```text
Use the obsidian skill. Preserve wikilinks, frontmatter, and Obsidian markdown syntax while editing this note.
```

#### 研究资料沉淀

```text
Use the llm-wiki skill. Ingest this source into airport-wiki, update related pages, and avoid duplicates.
```

---

## 6. 正确工作流

### 6.1 每天

目标：快速记录，不让组织成本打断思考

做法：

1. 新内容先写入 `00_Inbox/`
2. 不急着创建复杂目录
3. 让 assistant 做首次分类建议
4. 你只确认是否接受建议

可直接使用：

```text
Use the obsidian skill. Review today's inbox notes and suggest which ones should stay, move, merge, or archive.
```

### 6.2 每周

目标：从“堆积笔记”变成“可维护系统”

做法：

1. 让 assistant 扫描 `00_Inbox/`
2. 汇总 `01_Projects/` 状态
3. 找出 stale notes / orphan notes
4. 提议值得沉淀进 `03_Resources/` 或 `airport-wiki/` 的内容

可直接使用：

```text
Use the obsidian skill. Review my vault for the past week and give me:
1. project progress
2. stale notes
3. orphan notes
4. suggested resource notes to synthesize
```

### 6.3 做研究时

目标：把临时资料变成长期知识

做法：

1. 保存原始资料
2. 先总结，不急着建很多知识页
3. 确认值得长期保留后，再交给 `llm-wiki`

可直接使用：

```text
Use the llm-wiki skill. Turn this article into durable knowledge for airport-wiki, update existing pages if needed, and log the change.
```

---

## 7. 常见误用

这部分很重要。很多人不是不会用 assistant，而是用法会让 vault 迅速变乱。

### 7.1 一上来就让 assistant 批量移动整个 vault

问题：

- 容易改坏你的结构习惯
- 容易造成链接混乱
- 很难审核

正确做法：

- 先限定范围
- 先看提案
- 再做小批量改动

### 7.2 不搜索已有内容，直接让 assistant 新建很多笔记

问题：

- 容易制造重复内容
- 让 `03_Resources/` 和 `airport-wiki/` 失控

正确做法：

- 明确要求先搜索相关笔记
- 只创建“最小正确笔记”

### 7.3 把所有内容都塞进 `airport-wiki/`

问题：

- `airport-wiki/` 应该是知识库，不是杂记回收站

正确做法：

- 普通笔记继续留在 PARA
- 只有值得长期维护的知识才进入 wiki

### 7.4 把 assistant 当成“自动写作机器”

问题：

- 会产生大量低价值文本
- 容易让笔记失去你的真实判断

正确做法：

- 让 assistant 负责搜索、整理、总结、链接
- 你负责决定结论和取舍

### 7.5 不要求保留 Obsidian 语法

问题：

- 可能破坏 wikilinks、frontmatter、callouts、嵌入

正确做法：

- 在编辑提示词中明确要求保留 Obsidian markdown syntax

---

## 8. 针对这个 vault 的实际案例

### 8.1 整理 inbox

```text
Use the obsidian skill. Review 00_Inbox and group notes into:
1. keep in inbox
2. move to projects
3. move to areas
4. move to resources
5. archive
Propose changes before applying them.
```

### 8.2 审查项目区

```text
Use the obsidian skill. Review 01_Projects/AI-Development and summarize:
1. active work
2. stalled work
3. missing next actions
4. related resource notes I should revisit
```

### 8.3 做资源综述

```text
Use the obsidian skill. Search 03_Resources for notes related to Personal Knowledge Management and create a concise synthesis with related links.
```

### 8.4 更新 area 概览

```text
Use the obsidian skill. Review 02_Areas/GFW and propose an updated overview note with current concerns, related projects, and missing references.
```

### 8.5 把文章沉淀进 wiki

```text
Use the llm-wiki skill. Ingest this source into airport-wiki, search for existing related pages first, update them if present, and only create new pages when necessary.
```

---

## 9. 推荐长期固定使用的 10 条命令

```text
Use the obsidian skill. Review 00_Inbox and propose where each note should go.
```

```text
Use the obsidian skill. Search related notes before creating any new note.
```

```text
Use the obsidian skill. Preserve wikilinks, frontmatter, and Obsidian markdown syntax while editing.
```

```text
Use the obsidian skill. Review 01_Projects and summarize current status and next actions.
```

```text
Use the obsidian skill. Identify stale projects and explain why they look stale.
```

```text
Use the obsidian skill. Search 03_Resources and create a synthesis note from related material.
```

```text
Use the obsidian skill. Find orphan notes with no backlinks and classify them as keep, merge, move, or archive.
```

```text
Use the obsidian skill. Normalize titles and frontmatter for notes in this folder, but propose changes first.
```

```text
Use the obsidian skill. Build a weekly review from notes changed in the last 7 days.
```

```text
Use the llm-wiki skill. Ingest this source into airport-wiki and update existing concept pages instead of duplicating them.
```

---

## 10. 最终原则

在这个 vault 里，最好的用法不是“让 assistant 替我记笔记”，而是：

**我负责判断什么值得保留，assistant 负责整理、连接、总结和结构化。**