windy/my-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: refactor Hermes assistant guide

Browse Source
This commit is contained in:
zhiqiang feng
2026-04-11 11:16:36 +08:00
parent d0b066de07
commit 8317b97a44
1 changed files with 320 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files
06_Metadata/HERMES_ASSISTANT_GUIDE.md
+319 -106
View File
@@ -1,189 +1,300 @@
# Hermes Assistant 使用说明 # Hermes Assistant 使用说明
**用途**：说明如何用 Hermes 在这个 Obsidian vault 里做检索、整理、总结、沉淀知识 **用途**：说明如何在这个 Obsidian vault 中，正确使用 assistant 与 skills 做检索、整理、总结与知识沉淀
**Vault 路径**：`/home/windy/.hermes/ObsidianVault` **Vault 路径**：`/home/windy/.hermes/ObsidianVault`
**默认主技能**：`obsidian` **主技能**：`obsidian`
**研究沉淀技能**：`llm-wiki` **知识沉淀技能**：`llm-wiki`
--- ---
## 1. 先理解 Hermes 在 Obsidian 里扮演什么角色 ## 1. 文档目标
Hermes 不是单纯的“写笔记工具”，更适合作为下面四类助手： 这份文档不是介绍 Obsidian 功能本身，而是说明：
- 收件箱整理器：扫描 `00_Inbox/`，判断哪些内容该进 `Projects / Areas / Resources / Archive` - 什么时候该让 assistant 介入
- 检索总结器：跨整个 vault 搜索相关笔记，提炼结论、列出关联笔记 - 什么时候该用哪个 skill
- 结构维护器：补 frontmatter、统一标题、保留 wikilinks、修复链接关系 - assistant 在这个 vault 里最适合做什么
- 知识编译器：把零散资料整理成可持续维护的知识页，尤其适合 `airport-wiki/` - 如何避免 assistant 把 vault 越改越乱
你的原则应该是： 一句话原则：
- 先记录，不急着分类 **你负责判断什么值得留下，assistant 负责搜索、整理、连接、总结和结构化。**
- 让 Hermes 帮你整理和连接
- 你只做最终判断，不做机械整理
--- ---
## 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/` - 整理 inbox
- 汇总 `01_Projects/` - 生成项目总结
- 审查 `02_Areas/` - 做 weekly review
- 综述 `03_Resources/` - 找孤儿笔记
- 找重复或相近笔记
- 统一标题、frontmatter、链接
### `llm-wiki` 可以理解为：
用于把内容沉淀成结构化知识库。 **凡是 vault 日常管理，先用 `obsidian`。**
适合： ### 3.2 只有在“知识沉淀”场景下才用 `llm-wiki`
- 往 `airport-wiki/` 导入文章、资料、研究记录 当你的目标从“管理笔记”变成“构建持续演化的知识库”时，用 `llm-wiki`。
- 更新已有概念页、实体页、比较页
- 维护 `SCHEMA.md` / `index.md` / `log.md`
- 避免重复创建知识页
简单记法： 典型场景：
- 管理 vault，用 `obsidian` - 把一篇文章沉淀进 `airport-wiki/`
- 编译知识，用 `llm-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 - 分类到 PARA
- 发现空笔记、未命名笔记、重复笔记 - 标记需要重命名的笔记
- 给出重命名建议 - 找出明显可以归档的内容
- 识别是否和已有项目或资源相关
### `01_Projects/` ### 4.2 `01_Projects/`
用途：有明确目标、能完成的项目 用途：有开始和结束的主动项目
Hermes 负责：
- 总结项目状态 assistant 适合做：
- 抽取 next actions
- 找出 stale projects
- 把相关资源链接回来
### `02_Areas/` - 识别项目状态
- 提取 next actions
- 找出卡住的项目
- 找出长期没有更新的项目
- 连接相关资源和 area
### 4.3 `02_Areas/`
用途：长期维护的责任领域 用途：长期维护的责任领域
Hermes 负责：
- 维护 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 ```text
Use the obsidian skill. Review notes in 00_Inbox, classify them by PARA, and propose changes before applying them. Use the obsidian skill. Review notes in 00_Inbox, classify them by PARA, and propose changes before applying them.
``` ```
### 搜索并总结 #### 搜索与总结
```text ```text
Use the obsidian skill. Search my vault for notes about PKM and summarize the main ideas with related links. Use the obsidian skill. Search my vault for notes about PKM and summarize the main ideas with related links.
``` ```
### 项目状态检查 #### 项目状态检查
```text ```text
Use the obsidian skill. Review 01_Projects and tell me which projects are active, stale, or blocked. Use the obsidian skill. Review 01_Projects and tell me which projects are active, stale, or blocked.
``` ```
### 周回顾 #### 周回顾
```text ```text
Use the obsidian skill. Build a weekly review from notes changed in the last 7 days across 01_Projects and 02_Areas. 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 ```text
Use the obsidian skill. Search for existing related notes before creating anything new, then create the smallest correct note. Use the obsidian skill. Search for existing related notes before creating anything new, then create the smallest correct note.
``` ```
### 编辑时保护 Obsidian 语法 #### 保护 Obsidian 语法
```text ```text
Use the obsidian skill. Preserve wikilinks, frontmatter, and Obsidian markdown syntax while editing this note. 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 ```text
Use the obsidian skill. Review today's inbox notes and suggest which ones should stay, move, merge, or archive. 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 ```text
Use the obsidian skill. Review my vault for the past week and give me: 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 4. suggested resource notes to synthesize
``` ```
### 做研究时 ### 6.3 做研究时
1. 先保存原始资料 目标：把临时资料变成长期知识
2. 再让 Hermes 总结
3. 重要知识再进入 `airport-wiki/`
示例： 做法：
1. 保存原始资料
2. 先总结，不急着建很多知识页
3. 确认值得长期保留后，再交给 `llm-wiki`
可直接使用：
```text ```text
Use the llm-wiki skill. Turn this article into durable knowledge for airport-wiki, update existing pages if needed, and log the change. 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 搜索是否已有相关内容 这部分很重要。很多人不是不会用 assistant，而是用法会让 vault 迅速变乱。
- 让 Hermes 先提方案，再批量改动
- 移动或拆分笔记时，要求保留 wikilinks ### 7.1 一上来就让 assistant 批量移动整个 vault
- `00_Inbox/` 允许混乱，但不要长期堆积
- `03_Resources/` 放参考资料，不放正在执行的任务 问题：
- `airport-wiki/` 只放值得长期维护的知识，不放一次性杂记
- 容易改坏你的结构习惯
- 容易造成链接混乱
- 很难审核
正确做法：
- 先限定范围
- 先看提案
- 再做小批量改动
### 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 ```text
Use the obsidian skill. Review 00_Inbox and propose where each note should go. 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 替我记笔记”，而是： 在这个 vault 里，最好的用法不是“让 assistant 替我记笔记”，而是：
**我负责判断什么值得保留，Hermes 负责整理、连接、总结和结构化。** **我负责判断什么值得保留，assistant 负责整理、连接、总结和结构化。**