Obsidian Industry Wiki
Overview
把 WorkBuddy 的联网调研能力，沉淀成一个在 Obsidian 里可生长的行业研究知识库。核心理念：每篇笔记是一个原子概念，用一致的 frontmatter 描述成熟度，用 [[wikilinks]] 互相链接，用 00-MOC 主索引织成图谱。知识库随每次调研自然扩张，而非一次性写完就荒废。
默认 vault 路径：~/Obsidian/Industry-Wiki（首次运行 init_vault.py 自动创建；可用 --vault 覆盖）。
When To Use
- "建一个行业研究知识库" / "初始化 obsidian vault" → 走 W1
- "研究一下 XX 行业/公司/趋势，存进知识库" → 走 W2
- "更新 XX 笔记" / "XX 有最新数据了" → 走 W3
- "整理一下知识库" / "刷新索引" / "生成 MOC" → 走 W4
- "知识库还缺什么" / "有什么研究空白" → 走 W5
- "校验这篇笔记格式" → 走 W6
The Growable Model（核心）
四件事让知识库"长"起来：
- 原子化：一篇笔记 = 一个概念（一个行业 / 一家公司 / 一个趋势 / 一个数据 / 一个来源）。
- 状态机：
status标记成熟度——seedling(种子) →budding(发芽) →evergreen(常青) →archived(归档)。每次更新推进状态并刷新updated。 - 双向链接：每篇至少 1 出链 + 1 入链，靠
[[标题]]织网；index_vault.py会揪出无入链的"孤儿笔记"。 - Open Questions 驱动：每篇末尾留待调研问题，下次调研直接续写，形成生长闭环。
Vault Layout
Industry-Wiki/
├── 00-MOC/ MOC.md（主索引，自动维护）+ Dashboard.md（统计）
├── 10-Industries/ type: industry
├── 20-Companies/ type: company
├── 30-Trends/ type: trend
├── 40-Data/ type: data
├── 50-Sources/ type: source
└── 90-Templates/ 模板（不参与索引）
目录 ↔ type 的映射、MOC 设计、链接约定见 references/structure.md。字段定义、枚举、命名规范、按项目自定义字段见 references/schema.md。
Workflows
各流程的逐步操作、命令与示例见 references/workflows.md。要点：
- W1 初始化：运行
scripts/init_vault.py --vault <VAULT>。 - W2 调研写入：明确
type/industry→ 联网调研 → 套assets/note-template.md写笔记（先查重、有则链接）→ 跑index_vault.py刷新。 - W3 更新：读旧笔记 → 补事实/数据/来源 → 推进
status→ 刷新索引。 - W4 刷新索引：
scripts/index_vault.py --vault <VAULT> --report。 - W5 找缺口：同上
--report，脚本内置三类缺口（行业无玩家、趋势缺数据、孤儿笔记）。 - W6 校验：
scripts/validate_note.py <note.md>。
Scripts（确定性操作）
脚本均用 managed Python 运行（不要全局安装依赖，依赖仅标准库）：
/Users/amychen/.workbuddy/binaries/python/versions/3.13.12/bin/python3 \
<skill>/scripts/<script>.py --vault <VAULT> [--report]
scripts/init_vault.py— 脚手架 vault（目录 + 模板 + README + 初始 MOC/Dashboard）。--force覆盖模板。scripts/index_vault.py— 扫描笔记、刷新 MOC/Dashboard、检测孤儿与缺口。--report打印分析。scripts/validate_note.py— 校验单篇 frontmatter（必需字段、枚举合法性、是否有来源/出链）。
Note Schema（速查）
| 字段 | 说明 |
|---|---|
title |
标题，须与 [[wikilink]] 解析一致 |
type |
industry/company/trend/data/source/moc |
status |
seedling/budding/evergreen/archived |
industry |
主行业（聚合用） |
sector |
细分赛道（可选） |
tags |
跨类型标签 |
related |
出链 ["[[笔记]]"] |
sources |
URL 或 ["[[来源笔记]]"] |
confidence |
high/medium/low |
created/updated |
YYYY-MM-DD |
完整规范与自定义字段方式见 references/schema.md。脚本对未知字段容忍（只校验已知字段枚举），因此项目可安全追加自有字段。
Customization（按项目覆盖字段）
通用 schema 是基线。具体项目可在笔记追加字段（如求职向加 relevance、投资向加 ticker），无需改脚本；建议在 vault README 或首篇 MOC 记录本项目新增字段含义。
Resources
assets/note-template.md— 笔记模板（frontmatter + 正文结构）assets/moc-template.md— MOC 模板references/schema.md— 字段规范、状态机、命名、自定义references/structure.md— 目录布局、MOC 设计、可生长原则、链接约定references/workflows.md— W1–W6 逐步流程scripts/— init_vault.py / index_vault.py / validate_note.py
