440 lines
8.8 KiB
Markdown
440 lines
8.8 KiB
Markdown
# 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 个要素：
|
||
|
||
1. 指定 skill
|
||
2. 指定路径或范围
|
||
3. 指定动作
|
||
4. 指定安全约束
|
||
|
||
标准模板：
|
||
|
||
```text
|
||
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：
|
||
|
||
```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.
|
||
```
|
||
|
||
### `01_Projects/`
|
||
|
||
用途：有明确终点的项目
|
||
assistant 只做：
|
||
|
||
- 项目状态总结
|
||
- next actions 提取
|
||
- stalled 项目标记
|
||
- 相关资源链接回填
|
||
|
||
标准 prompt：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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. 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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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：
|
||
|
||
```text
|
||
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 输出时，优先要求结构化结果，不要泛泛解释。
|
||
|
||
推荐格式：
|
||
|
||
```text
|
||
Return results in this format:
|
||
1. Findings
|
||
2. Proposed changes
|
||
3. Files affected
|
||
4. Risks
|
||
5. Next step
|
||
```
|
||
|
||
如果你只想看提案，不要执行：
|
||
|
||
```text
|
||
Do not apply changes yet. Only return the proposed patch plan.
|
||
```
|
||
|
||
如果你要它直接改：
|
||
|
||
```text
|
||
Apply only the approved changes. Make no unrelated edits.
|
||
```
|
||
|
||
---
|
||
|
||
## 7. 不要这样用
|
||
|
||
错误模式：
|
||
|
||
```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 <topic>. Return matching notes, a one-line summary of each, and whether a new note is necessary.
|
||
```
|
||
|
||
### B. 编辑单篇笔记
|
||
|
||
```text
|
||
Use the obsidian skill. Edit <note path>. 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 <topic>, 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 语法
|
||
- 默认只做最小正确改动
|