From 8317b97a445c7760f16bcf6d455006124832ff88 Mon Sep 17 00:00:00 2001
From: zhiqiang feng <windy@mx2.windy.me>
Date: Sat, 11 Apr 2026 11:16:36 +0800
Subject: [PATCH] docs: refactor Hermes assistant guide

---
 06_Metadata/HERMES_ASSISTANT_GUIDE.md | 427 +++++++++++++++++++-------
 1 file changed, 320 insertions(+), 107 deletions(-)

diff --git a/06_Metadata/HERMES_ASSISTANT_GUIDE.md b/06_Metadata/HERMES_ASSISTANT_GUIDE.md
index 65b339e..bd478fb 100644
--- a/06_Metadata/HERMES_ASSISTANT_GUIDE.md
+++ b/06_Metadata/HERMES_ASSISTANT_GUIDE.md
@@ -1,189 +1,300 @@
 # Hermes Assistant 使用说明
 
-**用途**：说明如何用 Hermes 在这个 Obsidian vault 里做检索、整理、总结、沉淀知识  
+**用途**：说明如何在这个 Obsidian vault 中，正确使用 assistant 与 skills 做检索、整理、总结与知识沉淀  
 **Vault 路径**：`/home/windy/.hermes/ObsidianVault`  
-**默认主技能**：`obsidian`  
-**研究沉淀技能**：`llm-wiki`
+**主技能**：`obsidian`  
+**知识沉淀技能**：`llm-wiki`
 
 ---
 
-## 1. 先理解 Hermes 在 Obsidian 里扮演什么角色
+## 1. 文档目标
 
-Hermes 不是单纯的“写笔记工具”，更适合作为下面四类助手：
+这份文档不是介绍 Obsidian 功能本身，而是说明：
 
-- 收件箱整理器：扫描 `00_Inbox/`，判断哪些内容该进 `Projects / Areas / Resources / Archive`
-- 检索总结器：跨整个 vault 搜索相关笔记，提炼结论、列出关联笔记
-- 结构维护器：补 frontmatter、统一标题、保留 wikilinks、修复链接关系
-- 知识编译器：把零散资料整理成可持续维护的知识页，尤其适合 `airport-wiki/`
+- 什么时候该让 assistant 介入
+- 什么时候该用哪个 skill
+- assistant 在这个 vault 里最适合做什么
+- 如何避免 assistant 把 vault 越改越乱
 
-你的原则应该是：
+一句话原则：
 
-- 先记录，不急着分类
-- 让 Hermes 帮你整理和连接
-- 你只做最终判断，不做机械整理
+**你负责判断什么值得留下，assistant 负责搜索、整理、连接、总结和结构化。**
 
 ---
 
-## 2. 两个最重要的技能怎么分工
+## 2. assistant 在这个 vault 里的正确角色
 
-### `obsidian`
+assistant 最适合扮演四种角色：
 
-用于日常 vault 管理。
+### 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`：
 
 - 读笔记
 - 搜索笔记
 - 创建笔记
-- 重命名笔记
-- 整理 `00_Inbox/`
-- 汇总 `01_Projects/`
-- 审查 `02_Areas/`
-- 综述 `03_Resources/`
+- 更新笔记
+- 整理 inbox
+- 生成项目总结
+- 做 weekly review
+- 找孤儿笔记
+- 找重复或相近笔记
+- 统一标题、frontmatter、链接
 
-### `llm-wiki`
+可以理解为：
 
-用于把内容沉淀成结构化知识库。
+**凡是 vault 日常管理，先用 `obsidian`。**
 
-适合：
+### 3.2 只有在“知识沉淀”场景下才用 `llm-wiki`
 
-- 往 `airport-wiki/` 导入文章、资料、研究记录
-- 更新已有概念页、实体页、比较页
-- 维护 `SCHEMA.md` / `index.md` / `log.md`
-- 避免重复创建知识页
+当你的目标从“管理笔记”变成“构建持续演化的知识库”时，用 `llm-wiki`。
 
-简单记法：
+典型场景：
 
-- 管理 vault，用 `obsidian`
-- 编译知识，用 `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`
 
 ---
 
-## 3. 你的 vault 最适合怎么用
+## 4. 你的 vault 该怎么配合 assistant 使用
 
-### `00_Inbox/`
+### 4.1 `00_Inbox/`
 
-用途：快速捕获，不追求整洁  
-Hermes 负责：
+用途：快速捕获，不做即时分类
+
+正确做法：
+
+- 先写进去
+- 不急着归档
+- 让 assistant 扫描并提出分类建议
+
+assistant 适合做：
 
-- 扫描新笔记
 - 分类到 PARA
-- 发现空笔记、未命名笔记、重复笔记
-- 给出重命名建议
+- 标记需要重命名的笔记
+- 找出明显可以归档的内容
+- 识别是否和已有项目或资源相关
 
-### `01_Projects/`
+### 4.2 `01_Projects/`
 
-用途：有明确目标、能完成的项目  
-Hermes 负责：
+用途：有开始和结束的主动项目
 
-- 总结项目状态
-- 抽取 next actions
-- 找出 stale projects
-- 把相关资源链接回来
+assistant 适合做：
 
-### `02_Areas/`
+- 识别项目状态
+- 提取 next actions
+- 找出卡住的项目
+- 找出长期没有更新的项目
+- 连接相关资源和 area
 
-用途：长期维护的责任领域  
-Hermes 负责：
+### 4.3 `02_Areas/`
 
-- 维护 area overview
-- 汇总长期问题和标准
+用途：长期维护的责任领域
+
+assistant 适合做：
+
+- 汇总当前状态
+- 发现长期问题
 - 连接相关项目
+- 更新 area overview
 
-### `03_Resources/`
+### 4.4 `03_Resources/`
 
-用途：长期保留的参考资料  
-Hermes 负责：
+用途：长期保留的知识和参考资料
 
-- 做主题总结
-- 找关联笔记
+assistant 适合做：
+
+- 搜索同主题资料
+- 做综合总结
 - 发现缺失链接
-- 从零散资源中提炼综合笔记
+- 提议新增 synthesis note
 
-### `airport-wiki/`
+### 4.5 `airport-wiki/`
 
-用途：结构化研究知识库  
-Hermes 负责：
+用途：结构化知识库，不是普通资料夹
 
-- 导入资料
-- 维护索引
-- 更新概念页
-- 做知识交叉引用
+assistant 适合做：
+
+- 导入研究资料
+- 更新概念页、实体页、比较页
+- 维护 index / schema / log
+- 避免同主题重复建页
 
 ---
 
-## 4. 最推荐的提示词写法
+## 5. 最稳妥的提示词模式
 
-如果你想让 Hermes 更稳，不要只说“帮我整理一下”。  
-最好直接用下面这种句式。
+如果你想让 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 llm-wiki skill. Ingest this source into airport-wiki, update related pages, and avoid duplicates.
-```
-
-### 新建笔记前先搜索
+#### 新建笔记前先搜索
 
 ```text
 Use the obsidian skill. Search for existing related notes before creating anything new, then create the smallest correct note.
 ```
 
-### 编辑时保护 Obsidian 语法
+#### 保护 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.
+```
+
 ---
 
-## 5. 一套足够实用的日常工作流
+## 6. 正确工作流
 
-### 每天
+### 6.1 每天
 
-1. 把新内容先记到 `00_Inbox/`
-2. 不花时间当场分类
-3. 晚些时候让 Hermes 扫描 inbox
-4. 只确认 Hermes 的分类建议
+目标：快速记录，不让组织成本打断思考
 
-示例：
+做法：
+
+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. 让 Hermes 生成周回顾
-2. 让 Hermes 找 stale projects
-3. 让 Hermes 找 orphan notes
-4. 让 Hermes 找值得长期保留的资源
+目标：从“堆积笔记”变成“可维护系统”
 
-示例：
+做法：
+
+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:
@@ -193,13 +304,17 @@ Use the obsidian skill. Review my vault for the past week and give me:
 4. suggested resource notes to synthesize
 ```
 
-### 做研究时
+### 6.3 做研究时
 
-1. 先保存原始资料
-2. 再让 Hermes 总结
-3. 重要知识再进入 `airport-wiki/`
+目标：把临时资料变成长期知识
 
-示例：
+做法：
+
+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.
@@ -207,18 +322,116 @@ Use the llm-wiki skill. Turn this article into durable knowledge for airport-wik
 
 ---
 
-## 6. 最值得坚持的几个规则
+## 7. 常见误用
 
-- 创建新笔记前，先让 Hermes 搜索是否已有相关内容
-- 让 Hermes 先提方案，再批量改动
-- 移动或拆分笔记时，要求保留 wikilinks
-- `00_Inbox/` 允许混乱，但不要长期堆积
-- `03_Resources/` 放参考资料，不放正在执行的任务
-- `airport-wiki/` 只放值得长期维护的知识，不放一次性杂记
+这部分很重要。很多人不是不会用 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
 
 ---
 
-## 7. 推荐你固定复制使用的 10 条命令
+## 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.
@@ -262,8 +475,8 @@ Use the llm-wiki skill. Ingest this source into airport-wiki and update existing
 
 ---
 
-## 8. 一句话原则
+## 10. 最终原则
 
 在这个 vault 里，最好的用法不是“让 assistant 替我记笔记”，而是：
 
-**我负责判断什么值得保留，Hermes 负责整理、连接、总结和结构化。**
+**我负责判断什么值得保留，assistant 负责整理、连接、总结和结构化。**