| name | obsidian-research-precipitation |
| description | 将横纵分析法产出的研究报告沉淀到 Obsidian 的工作流程。包含文件命名规范、frontmatter 模板、文件夹结构、关键词提取规则。 |
Obsidian 研究报告沉淀规范
目标
将每一次「横纵分析法」产出的研究报告,按照统一规范写入 Obsidian,形成可检索、可链接、可追溯的个人知识库。
适用流程
在完成横纵分析报告写作后,执行以下步骤完成沉淀。
一、前置检查
- 确认输出目录存在:
/Users/Joy/SynologyDrive/Obsidian/research/
- 如果目标文件夹不存在,先创建
- 检查文件是否已存在(避免重复写入)
二、文件夹分类规则
/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: 写入文件
- 构建完整 frontmatter
- 写入文档内容
- 保存到对应目录
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
---
八、注意事项
- 文件名不可重复:如果同名文件已存在,在文件名后加版本号(如
claude-code-deep-research-v2.md)
- 关键词不要过多:控制在 8 个以内,否则失去检索聚焦性
- 中文标题要完整:title 字段写完整的中文报告标题,方便阅读
- 每次分析后都要执行沉淀:不要跳过,这是知识积累的关键环节