obsidian-research-precipitation

name	obsidian-research-precipitation
description	将横纵分析法产出的研究报告沉淀到 Obsidian 的工作流程。包含文件命名规范、frontmatter 模板、文件夹结构、关键词提取规则。

Obsidian 研究报告沉淀规范

目标

将每一次「横纵分析法」产出的研究报告，按照统一规范写入 Obsidian，形成可检索、可链接、可追溯的个人知识库。

适用流程

在完成横纵分析报告写作后，执行以下步骤完成沉淀。

---

一、前置检查

1. 确认输出目录存在：/Users/Joy/SynologyDrive/Obsidian/research/
2. 如果目标文件夹不存在，先创建
3. 检查文件是否已存在（避免重复写入）

---

二、文件夹分类规则

/research/
├── AI-agents/          # AI Agent 产品分析（如 Claude Code、Cursor）
├── LLMs/               # 大语言模型研究（如 GPT-4o、Claude）
├── Dev-tools/          # 开发者工具（如 VS Code、GitHub）
├── Tech-concepts/      # 技术概念解析（如 MCP、RAG）
├── Companies/          # 公司/组织研究（如 Anthropic、OpenAI）
└── ...                 # 可根据需要扩展新分类

扩展原则：当研究对象无法归入现有分类时，创建新文件夹。不要强行归类。

---

三、文件命名规范

使用 kebab-case 英文命名：

{研究对象名称-kebab-case}-{报告类型}.md

示例：

• claude-code-deep-research.md（深度研究报告）
• cursor-product-analysis.md（产品分析）
• mcp-protocol-research.md（协议研究）
• anthropic-company-analysis.md（公司分析）

命名规则：

• 全部小写
• 单词之间用 - 分隔
• 不在文件名中包含日期（日期写在 frontmatter 里）
• 不使用中文文件名（方便双链和搜索）

---

四、Frontmatter 模板

在文档最顶部添加以下 YAML frontmatter：

---
title: {研究报告标题}
keywords: [{关键词1}, {关键词2}, {关键词3}, ...]
type: {research | analysis | report | product | concept | company}
created: {YYYY-MM-DD}
status: published
研究对象: {研究对象名称}
---

字段说明：

字段	说明	示例
title	中文报告标题	Claude Code 深度研究报告
keywords	3-8 个检索关键词，用逗号分隔，外层用方括号	[Claude Code, AI编程, Agent工具, 开发者工具]
type	报告类型，可选值见上方	research
created	文档创建日期，格式 YYYY-MM-DD	2026-05-06
status	状态，固定写 published	published
研究对象	研究对象名称（中英文均可）	Claude Code

关键词提取规则：

• 从研究对象名称中提取核心词（如 Claude Code → Claude, Code, AI）
• 从所属领域提取（AI Agent / LLM / 开发者工具）
• 从报告结论中提取 1-2 个核心洞察词
• 总共 3-8 个关键词

---

五、文档结构

完整的沉底文档结构如下：

---
title: {标题}
keywords: [{关键词1}, {关键词2}, {关键词3}, ...]
type: {type}
created: {YYYY-MM-DD}
status: published
研究对象: {研究对象}
---

# {报告标题}

## 报告正文

（完整横纵分析报告内容，包含所有章节）

---

## 参考文献

- [来源1](URL)
- [来源2](URL)

---

六、执行步骤

Step 1: 确定分类

根据研究对象的类型，确定放入哪个子文件夹：

• AI Agent 产品 → AI-agents/
• 大语言模型 → LLMs/
• 开发者工具 → Dev-tools/
• 技术概念/协议 → Tech-concepts/
• 公司/组织 → Companies/

Step 2: 生成文件名

将研究对象名称转为 kebab-case，加上报告类型后缀。

Step 3: 提取关键词

从研究对象、领域、结论中提取 3-8 个关键词。

Step 4: 写入文件

1. 构建完整 frontmatter
2. 写入文档内容
3. 保存到对应目录

Step 5: 确认完成

输出保存路径和文件名，确认写入成功。

---

七、示例

研究对象：Claude Code（AI 编程工具）

分类：AI-agents/

文件名：claude-code-deep-research.md

Frontmatter：

---
title: Claude Code 深度研究报告
keywords: [Claude Code, AI编程, Agent工具, 开发者工具, 编程工作流]
type: research
created: 2026-05-06
status: published
研究对象: Claude Code
---

---

八、注意事项

1. 文件名不可重复：如果同名文件已存在，在文件名后加版本号（如 claude-code-deep-research-v2.md）
2. 关键词不要过多：控制在 8 个以内，否则失去检索聚焦性
3. 中文标题要完整：title 字段写完整的中文报告标题，方便阅读
4. 每次分析后都要执行沉淀：不要跳过，这是知识积累的关键环节