知识库治理

这份文档定义 jacky-brain 的长期结构。它不是为了限制记录，而是为了让内容变多后依然能被人和 AI 找到、理解、复用。

内容定位

这个仓库是个人第二大脑，当前重点是 AI 学习和实践。它应该沉淀：

• AI 工具使用经验。
• 可复用提示词和工作流。
• 好文章中的关键观点和个人理解。
• 前端、产品、写作等长期能力相关笔记。
• 日记、复盘和阶段性总结。
• 能支撑未来判断、行动或创作的材料。

它不应该变成：

• Notion 的全文镜像。
• 公众号生产流水线。
• 临时链接收藏夹。
• 未筛选聊天记录堆积区。

目录职责

目录	职责
AI/AI Coding/	AI Coding 语料根目录：AI 编程方法论、开发范式、Harness（入口索引：AI Coding 导航.md）
AI/AI方法论/	AI 概念框架、通用方法论
AI/Claude Code/	Claude Code 工具链：Skills、MCP、Memory、实战技巧
AI/AI应用/	AI 绘图、AI 音频等应用场景
AI/调研报告/	调研素材和行业分析
AI/Agent Skills/	Agent Skills 推荐与评测
AI/提示词/	通用提示词
AI信息源收集/	用 AI 定期收集的外部信息：信息源清单（作者地图）、深挖作者专档（如 Matt Pocock/）、批量挖掘轮次（挖掘 YYYY-MM~MM/）。属外部输入流，蒸馏后的精华归入对应域目录
个人成长/	个人成长方法论
医学健康/	健康与营养知识
经济理财/	投资理财和保险配置
经济理财/个人投资/	个人实战复盘：投资心法、买卖法则、交易复盘
经济理财/投资日报/	微博投资内容每日汇总（自动产出）
B站投资日报/	B站投资内容每日汇总（自动产出，仓库根目录便于日常翻阅）
courses/	课程学习工作区（MISSION/ROADMAP/lessons 格式）
新媒体运营/	新媒体运营实战
复盘计划/	周期复盘和计划
公众号/	已发布文章归档
docs/	仓库治理、规则、说明
templates/	新建内容模板
private/	本地敏感材料，不进入 Git

笔记类型

正式笔记分为五类：

• concept：概念解释，例如一个理论、术语、框架。
• practice：实践方法，例如流程、提示词、操作指南。
• case：案例记录，例如一次工具实验、踩坑、项目经历。
• material：素材摘录，例如好文章片段、观点来源、引用材料。
• review：复盘总结，例如周复盘、月复盘、年度总结。

状态

• seed：种子笔记，刚建立，还不完整。
• growing：持续积累中。
• evergreen：已经整理成长期可复用内容。
• archived：已过时、已发布或只保留历史价值。

元数据

正式笔记使用轻量 YAML：

---
type: concept | practice | case | material | review
status: seed | growing | evergreen | archived
tags: []
source:
created:
updated:
---

字段说明：

• type：笔记类型。
• status：维护状态。
• tags：少量主题标签，不要滥用。
• source：来源链接、书名、文章名、Notion、个人经验等。
• created：创建日期。
• updated：最后整理日期。

归类与落位

投喂信息、新建笔记或整理现有笔记时，按本章流程走同一条决策路径：拒收检查 → 判断性质 → 定域 → 落位 → Obsidian 友好标准 → 复述落位。

拒收检查

先判断信息是否值得沉淀，符合任一条则建议不存，等用户确认：

• 时效性资讯，过一周即无价值。
• 与任何领域无关、说不出会支撑什么未来判断/创作/决策的碎片。
• 与已有笔记内容重复。

用户坚持要存就存，不争辩。

判断性质（五选一）

判断问题	命中 → 类型
是别人的原文、观点、摘录？	material
是可复用的方法、流程、提示词、操作指南？	practice
是概念、术语、框架的解释理解？	concept
是一次实操经历、踩坑、项目记录？	case
是周期性复盘或阶段总结？	review

原始信息永远先落 material；蒸馏出个人理解后才单独成 concept/practice。一篇笔记只有一个类型。

定域

归属域按 AGENTS.md 任务域导航表判断。易混主题按此裁定：

易混内容	归属
Claude Code 工具链笔记（Skills、MCP、Memory、实战、官方提示词）	AI/Claude Code/
跨工具的 Agent Skills 推荐/评测/编写方法	AI/Agent Skills/
与具体工具无关的 AI 方法论、提问策略	AI/AI方法论/
某位作者的持续输出（推文、视频）	AI信息源收集/<作者>/
原始网页全文抓取	web-articles/（走 extract-notes 流程）

冲突序（两个域都说得通时）：

1. 具体域优先于泛域。
2. 一篇笔记只放一个家，其他相关位置用双链，不复制内容。
3. 原始摘录永远是 material，想归入更高域先蒸馏。

两个域强相关且冲突序裁不动 → 问用户，不硬塞。

落位

路由三选一，按顺序判断：

1. 短摘录/单条链接 → 追加到对应域的 推荐好文.md。
2. 已有同主题笔记 → 蒸馏后并入：先查重（域内目录扫描 + 主题比对），命中同主题时把新内容蒸馏去重后并入对应小节，只有带来新观点才新增小节；同步更新 updated 与文末「来源」区。是蒸馏改写并入，不是原文堆叠。文件名不带来源后缀，来源在文内标注。
3. 无同主题笔记可并入的新主题 → 新建进对应域目录，文件名同样不带来源后缀。

• 新建正式笔记遵循 templates/正式笔记模板.md 的锚点约定（YAML + 一句话总结/我的理解/相关链接/来源），正文自由组织；多来源聚合用 templates/主题整理模板.md。
• 周报类 review 由 self-review 技能每周日自动产出进 复盘计划/2026/周复盘/，人工不再手写。
• status 一律从 seed 起步。
• 拆分保护：主题文档超载（明显超过约 400 行，或内部长出两个独立子主题）→ 向用户提议拆分，由用户拍板。

Obsidian 友好标准

落位新建或触碰现有笔记时逐项过：

• 文件名可读（见命名规则），YAML 完整（保证 Obsidian Properties 可读可筛）。
• 正文小标题分层、列表化、关键词加粗，打开可扫读。
• 核心概念加双链（见链接规则），只链真正值得回看的概念，不追求密集。
• 触碰现有笔记时发现缺元数据或结构混乱 → 提议轻整理，列出要改什么，确认后再动。

整理现有笔记超过 5 篇先列清单等确认；公众号/ 只读；courses/ 工作区格式不补正式笔记元数据；投资日报等自动产出的日期序列不强补元数据。

复述落位

每次落位结束向用户复述：存了哪个路径、什么类型（status）、一句话理由；拒收检查命中或发现与现有笔记重复时，附上拒收或合并建议，由用户定。

命名规则

• 文件名优先使用清晰中文标题。
• 不为了排序强行加复杂编号。
• 同一主题下可以使用少量前缀，例如 01_提问策略。
• 避免 未命名、新建文档、test 这类长期不可读文件名。

链接规则

使用 Obsidian 双链连接核心概念：

这套方法本质上是一种 [[Harness Engineering]]。

链接要服务理解，不要为了图谱好看而滥用。

主题约定

某些主题除了常规摘取，还有额外的沉淀要求。

Harness 主题

导入 Harness 相关文章时（无论是用 extract-notes skill 还是手动整理），除了按常规流程摘取内容到对应笔记外，必须额外完成一步：把文章中能让人悟透理念的句子或段落，追加到 AI/AI Coding/Harness/Harness 心法.md。

判断标准（满足任一即可收录）：

• 一句话点破某个反直觉的本质（如”限制越多，效率越高”）
• 一个能反复品读、辅助理解理念的金句或短段落
• 把 Harness 某个子系统讲透的提纲挈领式总结

收录时保持原文措辞，不改写、不总结；按理念主题归入心法文档对应章节，无匹配章节可新建。收录后在该条目末尾标注来源（文章名或 [[笔记名]]）。

隐私边界

默认 GitHub 仓库为私有，但仍要按可长期保存标准管理。

不得提交：

• 密钥、token、cookie、账号密码。
• 私人聊天原文。
• 身份证、手机号、住址等个人敏感信息。
• 未公开商业信息。
• 还没判断是否适合长期保存的敏感原始材料。

敏感材料放入 private/，并确认 .gitignore 已忽略。

维护节奏

每周：

• 检查 Notion 碎片是否有主题值得升格。
• 补齐正式笔记元数据。
• 标记过时内容。

每月：

• 检查重复主题。
• 检查孤立笔记。
• 检查命名混乱。
• 检查敏感内容。
• 更新 AGENTS.md 和 docs/HARNESS.md 中反复出现的规则。