From 5025f5a4779454c7e489f82adfebb0fb66ee1d03 Mon Sep 17 00:00:00 2001 From: zhiqiang feng Date: Sat, 11 Apr 2026 11:20:22 +0800 Subject: [PATCH] docs: rewrite Hermes assistant guide as technical reference --- 06_Metadata/HERMES_ASSISTANT_GUIDE.md | 703 ++++++++++++-------------- 1 file changed, 330 insertions(+), 373 deletions(-) diff --git a/06_Metadata/HERMES_ASSISTANT_GUIDE.md b/06_Metadata/HERMES_ASSISTANT_GUIDE.md index bd478fb..d4d11a9 100644 --- a/06_Metadata/HERMES_ASSISTANT_GUIDE.md +++ b/06_Metadata/HERMES_ASSISTANT_GUIDE.md @@ -1,482 +1,439 @@ -# Hermes Assistant 使用说明 +# Hermes Assistant 技术指引 -**用途**：说明如何在这个 Obsidian vault 中，正确使用 assistant 与 skills 做检索、整理、总结与知识沉淀 -**Vault 路径**：`/home/windy/.hermes/ObsidianVault` -**主技能**：`obsidian` -**知识沉淀技能**：`llm-wiki` +**目标**：在这个 Obsidian vault 里正确调用 assistant 和 skills，完成检索、整理、改写、汇总、知识沉淀 +**Vault**：`/home/windy/.hermes/ObsidianVault` +**默认 skill**：`obsidian` +**知识库 skill**：`llm-wiki` --- -## 1. 文档目标 +## 1. Skill 选择表 -这份文档不是介绍 Obsidian 功能本身，而是说明： +| 任务 | 用哪个 skill | 不要用什么 | +|---|---|---| +| 搜索笔记、读笔记、建笔记、改笔记 | `obsidian` | 不要直接用 `llm-wiki` | +| 整理 `00_Inbox/` | `obsidian` | 不要直接批量移动整个 vault | +| 汇总 `01_Projects/` 状态 | `obsidian` | 不要直接新建很多 summary note | +| 统一 frontmatter / 标题 / wikilinks | `obsidian` | 不要不搜索就重构目录 | +| 把文章沉淀进 `airport-wiki/` | `llm-wiki` | 不要只用 `obsidian` 生造知识页 | +| 更新 `airport-wiki/index.md` / `SCHEMA.md` / `log.md` | `llm-wiki` | 不要把普通 inbox 内容塞进 wiki | -- 什么时候该让 assistant 介入 -- 什么时候该用哪个 skill -- assistant 在这个 vault 里最适合做什么 -- 如何避免 assistant 把 vault 越改越乱 +结论： -一句话原则： - -**你负责判断什么值得留下，assistant 负责搜索、整理、连接、总结和结构化。** +- PARA 管理：`obsidian` +- 研究知识库：`llm-wiki` --- -## 2. assistant 在这个 vault 里的正确角色 +## 2. Prompt 结构 -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 工作稳定，提示词应包含三类约束： +每次下指令，固定带 4 个要素： 1. 指定 skill -2. 指定范围 -3. 指定改动策略 +2. 指定路径或范围 +3. 指定动作 +4. 指定安全约束 -推荐句式： +标准模板： ```text -Use the obsidian skill. [task]. Propose changes before applying them. +Use the skill. Work in . . . ``` +安全约束固定用这几个： + +- `Propose changes before applying them.` +- `Search existing related notes before creating anything new.` +- `Preserve wikilinks, frontmatter, and Obsidian markdown syntax.` +- `Make the smallest correct change.` + +--- + +## 3. 你这个 vault 的固定操作模式 + +### `00_Inbox/` + +用途：暂存，不定稿 +assistant 只做： + +- 分类 +- 重命名建议 +- 合并建议 +- 迁移建议 + +不要直接做： + +- 大批量删除 +- 扫全 vault 重构 +- 自动创建大量新笔记 + +标准 prompt： + ```text -Use the obsidian skill. [task]. Search existing related notes before creating anything new. +Use the obsidian skill. Work in 00_Inbox. Classify each note into keep, move to projects, move to areas, move to resources, or archive. Propose changes before applying them. ``` +### `01_Projects/` + +用途：有明确终点的项目 +assistant 只做： + +- 项目状态总结 +- next actions 提取 +- stalled 项目标记 +- 相关资源链接回填 + +标准 prompt： + ```text -Use the llm-wiki skill. [task]. Update existing pages if they already exist and avoid duplicates. +Use the obsidian skill. Work in 01_Projects. Review project notes, identify active projects, stalled projects, and missing next actions. Preserve existing note structure. ``` -### 5.1 推荐提示词模板 +### `02_Areas/` -#### 收件箱整理 +用途：持续维护的领域 +assistant 只做： + +- area overview 更新 +- 长期问题总结 +- 项目关系补链 + +标准 prompt： ```text -Use the obsidian skill. Review notes in 00_Inbox, classify them by PARA, and propose changes before applying them. +Use the obsidian skill. Work in 02_Areas. Summarize the current state of each area and suggest missing project/resource links. Propose changes before applying them. ``` -#### 搜索与总结 +### `03_Resources/` + +用途：参考资料和长期保留内容 +assistant 只做： + +- 搜索同主题笔记 +- 主题综述 +- 合并建议 +- synthesis note 草案 + +标准 prompt： ```text -Use the obsidian skill. Search my vault for notes about PKM and summarize the main ideas with related links. +Use the obsidian skill. Work in 03_Resources. Search related notes on , summarize the core ideas, and suggest a synthesis note if one is missing. ``` -#### 项目状态检查 +### `airport-wiki/` + +用途：结构化研究知识库 +assistant 只做： + +- 导入资料 +- 更新概念页 +- 更新实体页 +- 维护 index / schema / log + +标准 prompt： ```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. +Use the llm-wiki skill. Work in airport-wiki. Ingest this source, update existing pages if present, create new pages only when necessary, and append a log entry. ``` --- -## 6. 正确工作流 +## 4. 三类正确用法 -### 6.1 每天 +### 4.1 搜索 -目标：快速记录，不让组织成本打断思考 +目标：先找已有内容，再决定是否创建新笔记 -做法： - -1. 新内容先写入 `00_Inbox/` -2. 不急着创建复杂目录 -3. 让 assistant 做首次分类建议 -4. 你只确认是否接受建议 - -可直接使用： +正确 prompt： ```text -Use the obsidian skill. Review today's inbox notes and suggest which ones should stay, move, merge, or archive. +Use the obsidian skill. Search my vault for notes related to . Return: +1. matching notes +2. short summary of each +3. whether a new note is necessary +Do not create anything yet. ``` -### 6.2 每周 +输出应该包含： -目标：从“堆积笔记”变成“可维护系统” +- 命中的笔记列表 +- 每个笔记一句摘要 +- 是否需要新建笔记 +- 如果要新建，建议放在哪个目录 -做法： +### 4.2 编辑 -1. 让 assistant 扫描 `00_Inbox/` -2. 汇总 `01_Projects/` 状态 -3. 找出 stale notes / orphan notes -4. 提议值得沉淀进 `03_Resources/` 或 `airport-wiki/` 的内容 +目标：对已有笔记做小改动，不破坏结构 -可直接使用： +正确 prompt： ```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 +Use the obsidian skill. Edit . Preserve wikilinks, frontmatter, callouts, and Obsidian markdown syntax. Make the smallest correct change. ``` -### 6.3 做研究时 +用于： -目标：把临时资料变成长期知识 +- 补 frontmatter +- 改标题 +- 改摘要 +- 增加 related notes +- 更新 next actions -做法： +### 4.3 新建 -1. 保存原始资料 -2. 先总结，不急着建很多知识页 -3. 确认值得长期保留后，再交给 `llm-wiki` +目标：只在必要时创建最小笔记 -可直接使用： +正确 prompt： ```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 obsidian skill. Search existing related notes before creating anything new. If a new note is required, create the smallest correct note under . ``` +必要条件： + +- 已搜索无等价内容 +- 新笔记有明确归属目录 +- 新笔记有明确用途 + --- -## 7. 常见误用 +## 5. 五个高频任务的技术做法 -这部分很重要。很多人不是不会用 assistant，而是用法会让 vault 迅速变乱。 +### 5.1 Inbox 分流 -### 7.1 一上来就让 assistant 批量移动整个 vault +输入： -问题： +- `00_Inbox/` 下的 markdown -- 容易改坏你的结构习惯 -- 容易造成链接混乱 -- 很难审核 +动作： -正确做法： +- 分类 +- 标题规范化建议 +- 合并建议 +- 目标目录建议 -- 先限定范围 -- 先看提案 -- 再做小批量改动 - -### 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 +prompt： ```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 +Use the obsidian skill. Work in 00_Inbox. For each note, output: +1. current title +2. recommended action +3. target folder +4. rename suggestion +5. related existing notes Propose changes before applying them. ``` -### 8.2 审查项目区 +### 5.2 项目周检 + +输入： + +- `01_Projects/` + +动作： + +- 找 active / stalled / blocked +- 抽 next actions + +prompt： ```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 +Use the obsidian skill. Work in 01_Projects. Review project notes and output: +1. active projects +2. stalled projects +3. blocked projects +4. notes missing next actions +Do not create new files unless I ask. ``` -### 8.3 做资源综述 +### 5.3 资源主题综述 + +输入： + +- `03_Resources/` 某一主题 + +动作： + +- 搜索 +- 汇总 +- 判断是否缺 synthesis note + +prompt： ```text -Use the obsidian skill. Search 03_Resources for notes related to Personal Knowledge Management and create a concise synthesis with related links. +Use the obsidian skill. Work in 03_Resources. Search notes related to and output: +1. key notes +2. common ideas +3. contradictions +4. missing links +5. whether a synthesis note should be created ``` -### 8.4 更新 area 概览 +### 5.4 修正结构但不改语义 + +输入： + +- 单篇或单目录笔记 + +动作： + +- frontmatter 标准化 +- 标题整理 +- links 补全 + +prompt： ```text -Use the obsidian skill. Review 02_Areas/GFW and propose an updated overview note with current concerns, related projects, and missing references. +Use the obsidian skill. Work in . Standardize frontmatter and note structure without changing the meaning. Preserve wikilinks and existing content hierarchy. ``` -### 8.5 把文章沉淀进 wiki +### 5.5 导入 wiki + +输入： + +- 外部文章、论文、粘贴内容 + +动作： + +- 查重 +- 更新已有页 +- 必要时新建页 +- 写 log + +prompt： ```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. +Use the llm-wiki skill. Work in airport-wiki. Search for existing related pages first. Update them if they exist. Only create new pages when necessary. Append a log entry after the update. ``` --- -## 9. 推荐长期固定使用的 10 条命令 +## 6. 输出要求 + +让 assistant 输出时，优先要求结构化结果，不要泛泛解释。 + +推荐格式： ```text -Use the obsidian skill. Review 00_Inbox and propose where each note should go. +Return results in this format: +1. Findings +2. Proposed changes +3. Files affected +4. Risks +5. Next step ``` -```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. +Do not apply changes yet. Only return the proposed patch plan. ``` -```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. +Apply only the approved changes. Make no unrelated edits. ``` --- -## 10. 最终原则 +## 7. 不要这样用 -在这个 vault 里，最好的用法不是“让 assistant 替我记笔记”，而是： +错误模式： -**我负责判断什么值得保留，assistant 负责整理、连接、总结和结构化。** +```text +Help me organize my vault. +``` + +问题： + +- 没有指定 skill +- 没有指定路径 +- 没有指定输出 +- 没有指定安全边界 + +错误模式： + +```text +Clean up all my notes. +``` + +问题： + +- 范围过大 +- 极易误改 +- 无法审核 + +错误模式： + +```text +Create notes about this topic. +``` + +问题： + +- 没有先搜索 +- 容易制造重复笔记 + +替代写法： + +```text +Use the obsidian skill. Search existing related notes before creating anything new. If needed, propose the smallest correct new note. +``` + +--- + +## 8. 你应该固定保存的 Prompt + +### A. 搜索现有笔记 + +```text +Use the obsidian skill. Search my vault for notes related to . Return matching notes, a one-line summary of each, and whether a new note is necessary. +``` + +### B. 编辑单篇笔记 + +```text +Use the obsidian skill. Edit . Preserve wikilinks, frontmatter, and Obsidian markdown syntax. Make the smallest correct change. +``` + +### C. Inbox 分类 + +```text +Use the obsidian skill. Work in 00_Inbox. Classify each note into keep, move to projects, move to areas, move to resources, or archive. Propose changes before applying them. +``` + +### D. 项目审查 + +```text +Use the obsidian skill. Work in 01_Projects. Review project notes and identify active, stalled, blocked, and missing-next-action items. +``` + +### E. Area 概览更新 + +```text +Use the obsidian skill. Work in 02_Areas. Summarize the current state of this area and propose missing project/resource links. +``` + +### F. 资源综述 + +```text +Use the obsidian skill. Work in 03_Resources. Search notes related to , summarize key ideas, and suggest whether a synthesis note is missing. +``` + +### G. Wiki 导入 + +```text +Use the llm-wiki skill. Work in airport-wiki. Search for existing related pages first, update them if present, create new pages only when necessary, and append a log entry. +``` + +--- + +## 9. 最短规则集 + +- 日常管理统一用 `obsidian` +- `airport-wiki` 沉淀统一用 `llm-wiki` +- 新建前先搜索 +- 批量改动前先出提案 +- 编辑时明确要求保留 Obsidian 语法 +- 默认只做最小正确改动