first commit

claudian/Claudian使用技巧手册.md

@@ -0,0 +1,194 @@
+# 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
+只改第二部分，其他不要动
+```
+
+---
+
+> 记住一句话：说清楚“处理什么、要什么结果、用什么格式、是否允许改文件”。