# Claudian 使用技巧手册

> 简单说：在 Obsidian 里直接用自然语言，让 Claudian 帮你读、改、整理、总结笔记。

---

## 1. 最常用的说法

| 你想做什么 | 直接这样说 |
|---|---|
| 看内容 | 看下 `@某个文件.md`，总结重点 |
| 改文字 | 把选中内容改得更简洁 |
| 写总结 | 根据本周日志生成周报 |
| 找资料 | 在 vault 里搜索“蓝牙异常”的相关笔记 |
| 做对比 | 对比 `@4月日志.md` 和 `@5月日志.md`，列出差异 |
| 整理笔记 | 给这篇笔记加标题、分段和待办项 |
| 检查问题 | 检查这篇笔记有没有错别字、重复内容和断链 |

---

## 2. 最推荐的提问模板

以后不知道怎么说，就按这个模板：

```text
背景：我要做什么
对象：处理哪个文件/选中内容/文件夹
目标：希望得到什么结果
格式：用列表/表格/Markdown/总结
要求：不确定先问我，改完说明改了哪里
```

示例：

```text
背景：我要写5月工作总结
对象：@2026-05日志.md
目标：提炼主要工作、问题和下月计划
格式：用 1、子任务 2、交付件 3、评价
要求：不要编造，没有的信息标出来问我
```

---

## 3. 6 个实用技巧

### 1）用 `@文件名` 指定文件

```text
@蓝牙问题记录.md 总结一下根因和解决方案
```

比手打完整路径更快，也不容易弄错。

### 2）先选中，再提要求

选中文本后再说：

```text
帮我把选中内容压缩成3条重点
```

适合改段落、翻译、解释代码、整理日志。

### 3）一次说清楚

```text
把“流转”改成“工单”，把“解决”改成“已修复”，最后加一段总结
```

比一步一步说效率高。

### 4）给输出格式

```text
请按表格输出：问题｜原因｜处理方式｜后续动作
```

格式说得越清楚，结果越可用。

### 5）重要修改先让它列计划

```text
先不要改文件，先告诉我你准备改哪里、怎么改
```

适合批量修改、多文件整理、重要项目文档。

### 6）需要安全时明确说备份

```text
先备份这个文件，再修改
```

如果不需要备份，也可以直接说：

```text
不用备份，直接改
```

---

## 4. 常用场景速查

### 日志和总结

```text
根据本周日志生成周报，分为：完成事项、问题、下周计划
```

```text
帮我补一条今天日志：处理了蓝牙开关异常，定位到状态同步问题
```

### 技术分析

```text
分析这段日志，找出可能根因、验证方法和修复建议
```

```text
根据这个模块文档，补充接口、状态机和测试用例
```

### 笔记整理

```text
整理这篇笔记，保留原意，拆成标题、重点、待办、参考链接
```

```text
检查这个文件夹里的笔记，找出重复主题和可以合并的内容
```

### 项目推进

```text
先读取 agent.md，结合历史记录，帮我规划下一步开发任务
```

```text
把这次决策记录到 agent.md，包括原因、结论和待办
```

---

## 5. 修改文件时的安全用语

| 目的 | 可以这样说 |
|---|---|
| 只分析不修改 | 先只分析，不要改文件 |
| 先看影响范围 | 先列出会修改哪些文件，等我确认 |
| 需要备份 | 先备份，再修改 |
| 不用备份 | 不用备份，直接改 |
| 改完复查 | 改完告诉我修改范围和验证方式 |
| 防止编造 | 没有依据的内容不要补，标出来问我 |

---

## 6. 最省心的工作流

1. 选中文本，或用 `@文件名` 指定文件
2. 说明目标和输出格式
3. 重要修改先让 Claudian 列计划
4. 确认后再改
5. 改完让它说明：改了哪里、为什么、怎么验证

---

## 7. 不满意时这样让它重改

```text
太长了，压缩到100字以内
```

```text
太泛了，保留技术细节
```

```text
改成表格
```

```text
语气更正式一点
```

```text
只改第二部分，其他不要动
```

---

> 记住一句话：说清楚“处理什么、要什么结果、用什么格式、是否允许改文件”。