docs: rewrite Hermes assistant guide as technical reference
This commit is contained in:
zhiqiang feng
@@ -1,482 +1,439 @@
|
|||||||
# Hermes Assistant 使用说明
|
# Hermes Assistant 技术指引
|
||||||
|
|
||||||
**用途**：说明如何在这个 Obsidian vault 中，正确使用 assistant 与 skills 做检索、整理、总结与知识沉淀
|
**目标**：在这个 Obsidian vault 里正确调用 assistant 和 skills，完成检索、整理、改写、汇总、知识沉淀
|
||||||
**Vault 路径**：`/home/windy/.hermes/ObsidianVault`
|
**Vault**：`/home/windy/.hermes/ObsidianVault`
|
||||||
**主技能**：`obsidian`
|
**默认 skill**：`obsidian`
|
||||||
**知识沉淀技能**：`llm-wiki`
|
**知识库 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 越改越乱
|
|
||||||
|
|
||||||
一句话原则：
|
- PARA 管理：`obsidian`
|
||||||
|
- 研究知识库：`llm-wiki`
|
||||||
**你负责判断什么值得留下，assistant 负责搜索、整理、连接、总结和结构化。**
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 2. assistant 在这个 vault 里的正确角色
|
## 2. Prompt 结构
|
||||||
|
|
||||||
assistant 最适合扮演四种角色：
|
每次下指令，固定带 4 个要素：
|
||||||
|
|
||||||
### 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 工作稳定，提示词应包含三类约束：
|
|
||||||
|
|
||||||
1. 指定 skill
|
1. 指定 skill
|
||||||
2. 指定范围
|
2. 指定路径或范围
|
||||||
3. 指定改动策略
|
3. 指定动作
|
||||||
|
4. 指定安全约束
|
||||||
|
|
||||||
推荐句式：
|
标准模板：
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Use the obsidian skill. [task]. Propose changes before applying them.
|
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
|
```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
|
```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
|
```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
|
```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 <topic>, summarize the core ideas, and suggest a synthesis note if one is missing.
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 项目状态检查
|
### `airport-wiki/`
|
||||||
|
|
||||||
|
用途：结构化研究知识库
|
||||||
|
assistant 只做：
|
||||||
|
|
||||||
|
- 导入资料
|
||||||
|
- 更新概念页
|
||||||
|
- 更新实体页
|
||||||
|
- 维护 index / schema / log
|
||||||
|
|
||||||
|
标准 prompt：
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Use the obsidian skill. Review 01_Projects and tell me which projects are active, stale, or blocked.
|
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.
|
||||||
```
|
|
||||||
|
|
||||||
#### 周回顾
|
|
||||||
|
|
||||||
```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.
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 6. 正确工作流
|
## 4. 三类正确用法
|
||||||
|
|
||||||
### 6.1 每天
|
### 4.1 搜索
|
||||||
|
|
||||||
目标：快速记录，不让组织成本打断思考
|
目标：先找已有内容，再决定是否创建新笔记
|
||||||
|
|
||||||
做法：
|
正确 prompt：
|
||||||
|
|
||||||
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. 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.
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6.2 每周
|
输出应该包含：
|
||||||
|
|
||||||
目标：从“堆积笔记”变成“可维护系统”
|
- 命中的笔记列表
|
||||||
|
- 每个笔记一句摘要
|
||||||
|
- 是否需要新建笔记
|
||||||
|
- 如果要新建，建议放在哪个目录
|
||||||
|
|
||||||
做法：
|
### 4.2 编辑
|
||||||
|
|
||||||
1. 让 assistant 扫描 `00_Inbox/`
|
目标：对已有笔记做小改动，不破坏结构
|
||||||
2. 汇总 `01_Projects/` 状态
|
|
||||||
3. 找出 stale notes / orphan notes
|
|
||||||
4. 提议值得沉淀进 `03_Resources/` 或 `airport-wiki/` 的内容
|
|
||||||
|
|
||||||
可直接使用：
|
正确 prompt：
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Use the obsidian skill. Review my vault for the past week and give me:
|
Use the obsidian skill. Edit <note path>. Preserve wikilinks, frontmatter, callouts, and Obsidian markdown syntax. Make the smallest correct change.
|
||||||
1. project progress
|
|
||||||
2. stale notes
|
|
||||||
3. orphan notes
|
|
||||||
4. suggested resource notes to synthesize
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6.3 做研究时
|
用于：
|
||||||
|
|
||||||
目标：把临时资料变成长期知识
|
- 补 frontmatter
|
||||||
|
- 改标题
|
||||||
|
- 改摘要
|
||||||
|
- 增加 related notes
|
||||||
|
- 更新 next actions
|
||||||
|
|
||||||
做法：
|
### 4.3 新建
|
||||||
|
|
||||||
1. 保存原始资料
|
目标：只在必要时创建最小笔记
|
||||||
2. 先总结，不急着建很多知识页
|
|
||||||
3. 确认值得长期保留后，再交给 `llm-wiki`
|
|
||||||
|
|
||||||
可直接使用：
|
正确 prompt：
|
||||||
|
|
||||||
```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 obsidian skill. Search existing related notes before creating anything new. If a new note is required, create the smallest correct note under <folder>.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
必要条件：
|
||||||
|
|
||||||
|
- 已搜索无等价内容
|
||||||
|
- 新笔记有明确归属目录
|
||||||
|
- 新笔记有明确用途
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 7. 常见误用
|
## 5. 五个高频任务的技术做法
|
||||||
|
|
||||||
这部分很重要。很多人不是不会用 assistant，而是用法会让 vault 迅速变乱。
|
### 5.1 Inbox 分流
|
||||||
|
|
||||||
### 7.1 一上来就让 assistant 批量移动整个 vault
|
输入：
|
||||||
|
|
||||||
问题：
|
- `00_Inbox/` 下的 markdown
|
||||||
|
|
||||||
- 容易改坏你的结构习惯
|
动作：
|
||||||
- 容易造成链接混乱
|
|
||||||
- 很难审核
|
|
||||||
|
|
||||||
正确做法：
|
- 分类
|
||||||
|
- 标题规范化建议
|
||||||
|
- 合并建议
|
||||||
|
- 目标目录建议
|
||||||
|
|
||||||
- 先限定范围
|
prompt：
|
||||||
- 先看提案
|
|
||||||
- 再做小批量改动
|
|
||||||
|
|
||||||
### 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
|
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Use the obsidian skill. Review 00_Inbox and group notes into:
|
Use the obsidian skill. Work in 00_Inbox. For each note, output:
|
||||||
1. keep in inbox
|
1. current title
|
||||||
2. move to projects
|
2. recommended action
|
||||||
3. move to areas
|
3. target folder
|
||||||
4. move to resources
|
4. rename suggestion
|
||||||
5. archive
|
5. related existing notes
|
||||||
Propose changes before applying them.
|
Propose changes before applying them.
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.2 审查项目区
|
### 5.2 项目周检
|
||||||
|
|
||||||
|
输入：
|
||||||
|
|
||||||
|
- `01_Projects/`
|
||||||
|
|
||||||
|
动作：
|
||||||
|
|
||||||
|
- 找 active / stalled / blocked
|
||||||
|
- 抽 next actions
|
||||||
|
|
||||||
|
prompt：
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Use the obsidian skill. Review 01_Projects/AI-Development and summarize:
|
Use the obsidian skill. Work in 01_Projects. Review project notes and output:
|
||||||
1. active work
|
1. active projects
|
||||||
2. stalled work
|
2. stalled projects
|
||||||
3. missing next actions
|
3. blocked projects
|
||||||
4. related resource notes I should revisit
|
4. notes missing next actions
|
||||||
|
Do not create new files unless I ask.
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.3 做资源综述
|
### 5.3 资源主题综述
|
||||||
|
|
||||||
|
输入：
|
||||||
|
|
||||||
|
- `03_Resources/` 某一主题
|
||||||
|
|
||||||
|
动作：
|
||||||
|
|
||||||
|
- 搜索
|
||||||
|
- 汇总
|
||||||
|
- 判断是否缺 synthesis note
|
||||||
|
|
||||||
|
prompt：
|
||||||
|
|
||||||
```text
|
```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 <topic> 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
|
```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 <folder or note>. Standardize frontmatter and note structure without changing the meaning. Preserve wikilinks and existing content hierarchy.
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.5 把文章沉淀进 wiki
|
### 5.5 导入 wiki
|
||||||
|
|
||||||
|
输入：
|
||||||
|
|
||||||
|
- 外部文章、论文、粘贴内容
|
||||||
|
|
||||||
|
动作：
|
||||||
|
|
||||||
|
- 查重
|
||||||
|
- 更新已有页
|
||||||
|
- 必要时新建页
|
||||||
|
- 写 log
|
||||||
|
|
||||||
|
prompt：
|
||||||
|
|
||||||
```text
|
```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
|
```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
|
```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
|
```text
|
||||||
Use the obsidian skill. Identify stale projects and explain why they look stale.
|
Apply only the approved changes. Make no unrelated edits.
|
||||||
```
|
|
||||||
|
|
||||||
```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.
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 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 <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 语法
|
||||||
|
- 默认只做最小正确改动
|
||||||
|
|||||||
Reference in New Issue
Block a user