8.8 KiB
8.8 KiB
Hermes Assistant 技术指引
目标：在这个 Obsidian vault 里正确调用 assistant 和 skills，完成检索、整理、改写、汇总、知识沉淀
Vault：/home/windy/.hermes/ObsidianVault
默认 skill：obsidian
知识库 skill：llm-wiki
1. Skill 选择表
| 任务 | 用哪个 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 |
结论：
- PARA 管理：
obsidian - 研究知识库：
llm-wiki
2. Prompt 结构
每次下指令，固定带 4 个要素：
- 指定 skill
- 指定路径或范围
- 指定动作
- 指定安全约束
标准模板：
Use the <skill> skill. Work in <path or scope>. <task>. <safety rule>.
安全约束固定用这几个：
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：
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：
Use the obsidian skill. Work in 01_Projects. Review project notes, identify active projects, stalled projects, and missing next actions. Preserve existing note structure.
02_Areas/
用途：持续维护的领域
assistant 只做：
- area overview 更新
- 长期问题总结
- 项目关系补链
标准 prompt：
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：
Use the obsidian skill. Work in 03_Resources. Search related notes on <topic>, summarize the core ideas, and suggest a synthesis note if one is missing.
airport-wiki/
用途：结构化研究知识库
assistant 只做：
- 导入资料
- 更新概念页
- 更新实体页
- 维护 index / schema / log
标准 prompt：
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.
4. 三类正确用法
4.1 搜索
目标：先找已有内容，再决定是否创建新笔记
正确 prompt：
Use the obsidian skill. Search my vault for notes related to <topic>. Return:
1. matching notes
2. short summary of each
3. whether a new note is necessary
Do not create anything yet.
输出应该包含：
- 命中的笔记列表
- 每个笔记一句摘要
- 是否需要新建笔记
- 如果要新建，建议放在哪个目录
4.2 编辑
目标：对已有笔记做小改动，不破坏结构
正确 prompt：
Use the obsidian skill. Edit <note path>. Preserve wikilinks, frontmatter, callouts, and Obsidian markdown syntax. Make the smallest correct change.
用于：
- 补 frontmatter
- 改标题
- 改摘要
- 增加 related notes
- 更新 next actions
4.3 新建
目标：只在必要时创建最小笔记
正确 prompt：
Use the obsidian skill. Search existing related notes before creating anything new. If a new note is required, create the smallest correct note under <folder>.
必要条件：
- 已搜索无等价内容
- 新笔记有明确归属目录
- 新笔记有明确用途
5. 五个高频任务的技术做法
5.1 Inbox 分流
输入：
00_Inbox/下的 markdown
动作：
- 分类
- 标题规范化建议
- 合并建议
- 目标目录建议
prompt：
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.
5.2 项目周检
输入：
01_Projects/
动作：
- 找 active / stalled / blocked
- 抽 next actions
prompt：
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.
5.3 资源主题综述
输入：
03_Resources/某一主题
动作：
- 搜索
- 汇总
- 判断是否缺 synthesis note
prompt：
Use the obsidian skill. Work in 03_Resources. Search notes related to <topic> and output:
1. key notes
2. common ideas
3. contradictions
4. missing links
5. whether a synthesis note should be created
5.4 修正结构但不改语义
输入：
- 单篇或单目录笔记
动作：
- frontmatter 标准化
- 标题整理
- links 补全
prompt：
Use the obsidian skill. Work in <folder or note>. Standardize frontmatter and note structure without changing the meaning. Preserve wikilinks and existing content hierarchy.
5.5 导入 wiki
输入：
- 外部文章、论文、粘贴内容
动作：
- 查重
- 更新已有页
- 必要时新建页
- 写 log
prompt：
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.
6. 输出要求
让 assistant 输出时，优先要求结构化结果，不要泛泛解释。
推荐格式：
Return results in this format:
1. Findings
2. Proposed changes
3. Files affected
4. Risks
5. Next step
如果你只想看提案，不要执行：
Do not apply changes yet. Only return the proposed patch plan.
如果你要它直接改：
Apply only the approved changes. Make no unrelated edits.
7. 不要这样用
错误模式：
Help me organize my vault.
问题：
- 没有指定 skill
- 没有指定路径
- 没有指定输出
- 没有指定安全边界
错误模式：
Clean up all my notes.
问题：
- 范围过大
- 极易误改
- 无法审核
错误模式：
Create notes about this topic.
问题：
- 没有先搜索
- 容易制造重复笔记
替代写法：
Use the obsidian skill. Search existing related notes before creating anything new. If needed, propose the smallest correct new note.
8. 你应该固定保存的 Prompt
A. 搜索现有笔记
Use the obsidian skill. Search my vault for notes related to <topic>. Return matching notes, a one-line summary of each, and whether a new note is necessary.
B. 编辑单篇笔记
Use the obsidian skill. Edit <note path>. Preserve wikilinks, frontmatter, and Obsidian markdown syntax. Make the smallest correct change.
C. Inbox 分类
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. 项目审查
Use the obsidian skill. Work in 01_Projects. Review project notes and identify active, stalled, blocked, and missing-next-action items.
E. Area 概览更新
Use the obsidian skill. Work in 02_Areas. Summarize the current state of this area and propose missing project/resource links.
F. 资源综述
Use the obsidian skill. Work in 03_Resources. Search notes related to <topic>, summarize key ideas, and suggest whether a synthesis note is missing.
G. Wiki 导入
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 语法
- 默认只做最小正确改动