16.2 搭建 AI 原生笔记库

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

搭建这套系统需要三步：设计目录结构、编写 CLAUDE.md 规则文件、配置索引和 Skill 入口。

目录结构设计

新建一个文件夹作为笔记库根目录，里面建子文件夹。参考结构：

MyNotes/
├── .claude/
│   └── skills/
│       ├── takenote/
│       │   └── SKILL.md       # 记笔记的标准入口
│       └── update-vault/
│           └── SKILL.md       # 定期维护入口
├── CLAUDE.md                  # 规则文件（系统控制中枢）
├── 1_关于我/                  # 个人背景、经历、偏好
├── 2_想法/                    # 灵感、判断、随手记
├── 3_工作/                    # 项目文档、任务推进
├── 4_学习/                    # 读书笔记、课程笔记
├── 5_会议/                    # 会议记录、决策和待办
├── 6_研究/                    # 调研、深度分析
├── 7_行政/                    # 汇报、流程文档
├── 8_附件/                    # PDF、图片、录音转写
├── 9_代码/                    # 代码片段、技术备忘
└── 临时工作区/                 # AI 中间产物和草稿

文件夹命名有一条核心原则：让 AI 一眼看懂用途。Claude Code 靠文件夹名字判断内容该放哪里。5_会议/ 比 misc/ 或 folder-e/ 好得多。数字前缀让排列有序，中文名字让语义清晰。

最佳实践

从 5-7 个文件夹开始，在使用中逐步拆分。一开始就设计 15 个文件夹，大部分会空置。文件夹可以继续往下分二级目录，比如 3_工作/ 下面再分 客户A/、客户B/。

根目录只放 CLAUDE.md 一个文档文件，其他内容全进子文件夹。

这套系统不需要单独的收件箱。Claude Code 的对话框本身就是入口——有想法、有会议纪要、有邮件摘要，直接发给它处理。

CLAUDE.md 三块核心内容

CLAUDE.md 是整套系统的灵魂。Claude Code 在笔记库目录下工作时，每次对话都会自动读取这份文件。你在里面写什么规则，它就按什么规则处理输入。

这份文件至少包含三块内容。

第一块：库的用途和用户背景。 告诉 AI 这个库是做什么的、你是谁。背景要短——职业、当前工作、写作风格，三到五行即可。详细信息放在 1_关于我/个人背景.md。

第二块：处理流程。 这是最关键的部分，直接决定 Claude Code 收到输入后怎么做。不要只写一句含糊的要求，要把处理步骤的先后顺序写清楚。

第三块：笔记格式和写作要求。 规定 frontmatter 模板、标签体系、语言风格。

以下是一份完整的 CLAUDE.md 配置示例：

# CLAUDE.md

这个文件规定 Claude Code 在这套笔记库里的工作方式。

## 用途和背景

这是我的个人知识库，用来记录工作想法、会议记录、学习笔记和研究资料。
每次我给你一段内容，请先理解它是什么，再决定该放到哪里。

我的简要背景：
- 职业：经济学研究者
- 当前主要工作：行为博弈论实验、教学
- 写作风格：简洁，条列式为主
- 如需更完整的人物背景，先读 `1_关于我/个人背景.md`

目录结构：
- 1_关于我/：个人背景、当前状态、长期项目
- 2_想法/：灵感和随手记的点子
- 3_工作/：项目文档、任务推进
- 4_学习/：读书和课程笔记
- 5_会议/：所有会议记录
- 6_研究/：深度分析和调研
- 7_行政/：汇报和行政文档
- 8_附件/：PDF、图片、邮件导出、录音转写
- 9_代码/：技术相关

## 每次我输入一段内容时，按这个顺序处理

1. 分析输入的主题和关键词
2. 先读本文件中的规则；如果任务需要个性化判断，再读 `1_关于我/个人背景.md`
3. 搜索已有笔记，看有没有可以合并的
4. 判断放进哪个文件夹（不确定就问我）
5. 创建或更新笔记，加标签、建链接
6. 同步更新对应文件夹的 _index.md
7. 告诉我创建了什么、放在哪里、改了什么

## 搜索方式

每次搜索，先看根目录结构，进入相关子文件夹读取 _index.md，最后再读具体笔记。

## 更新规则

每次创建或更新笔记后，同步更新对应文件夹的 _index.md。

## 笔记格式

每条笔记开头要有：
---
created: YYYY-MM-DD
tags:
  - type/idea
  - status/draft
---

## 写作要求

- 写自然流畅的中文
- 不用套话
- 如非必要，不用引号
- 中英文之间加半角空格
- 只给已有笔记加链接，不要凭空造空链接

## 安全规则

- 修改已有笔记前先确认
- 未经允许不要删除原内容
- 保留用户原始输入

注意

CLAUDE.md 写得越具体，AI 的行为越稳定。含糊的规则会导致每次处理结果飘忽不定。比如，只写一句含糊指令和写出 7 步处理流程，效果差距很大。

索引系统

笔记多了之后，光靠 CLAUDE.md 里的目录说明不够精确。解决方法是给每个文件夹建一个 _index.md，列出该文件夹下所有笔记的路径和一句话说明。

比如 2_想法/_index.md：

# 2_想法 - 索引

| 文件 | 内容 |
|:---|:---|
| 社群运营新模式.md | 用每日任务打卡提高成员 AI 能力的社群设计思路 |
| 客户沟通复盘.md | 客户提出价格异议时的应对框架 |
| 年度目标调整.md | 2026 年第二季度重新设定优先级的思考 |

CLAUDE.md 告诉 AI 应该怎么找，_index.md 告诉 AI 这个文件夹里到底有什么。两者配合，定位才能又准又快。

索引不用手动写。在 CLAUDE.md 配置好后，告诉 Claude Code：

▶ Claude Code

帮我给每个子文件夹创建一个 _index.md，列出文件夹内所有文件的路径和一句话说明

它会自动遍历目录并生成索引。

这样就形成了闭环：用户输入内容 → Claude Code 按规则处理 → 写入或更新笔记 → 自动更新索引 → 下次搜索更准。

takenote Skill 入口

.claude/skills/takenote/ 目录下的 SKILL.md 是记笔记的标准入口。它接住 /takenote、记一下、帮我整理成笔记这类指令，并把内容送进 CLAUDE.md 定义的处理流程。

一份精简版的 SKILL.md：

▶ Skill

---
name: takenote
description: 当用户想记录一条笔记、输入一段原始想法、整理会议内容、保存学习摘要，或提到 /takenote、记一下、帮我整理成笔记 时使用。
---

# takenote

把用户输入的内容整理成一条正式笔记，写入笔记库。

默认假设用户提供的是原始素材，不是整理好的笔记。先接住内容，再按规则归档。

## 先读什么

1. 先读取仓库根目录的 CLAUDE.md。
2. 如果任务需要个性化判断，再读取 1_关于我/个人背景.md。
3. 确定目标目录后，先读对应目录下的 _index.md，再读可能相关的已有笔记。

## 处理流程

1. 判断内容类型和最合理的落点。
2. 搜索相关 _index.md 和已有笔记，判断应该新建还是更新。
3. 生成清晰的中文标题。
4. 按 CLAUDE.md 里的格式写成正式笔记。
5. 在 Related 中补充真实存在的相关笔记链接。
6. 同步更新对应目录下的 _index.md。
7. 简要告诉用户创建或更新了什么文件。

Skill 与 CLAUDE.md 的分工明确：Skill 负责接住入口指令，规则文件负责定义处理流程。为什么要用 Skill 而不是随便聊？标准化入口让每次记笔记的行为更稳定。未经 Skill 触发的自然语言输入，Claude Code 有时会以问答模式回复，而不执行完整的归档操作。通过 /takenote 或触发词进入 Skill，它会按照预设流程走完全部步骤。

在任何目录使用 /takenote

上面的 takenote Skill 放在笔记库的 .claude/skills/ 目录下，只有在笔记库目录内启动 Claude Code 时才能触发。如果你想在任何项目、任何目录下随时记笔记，把 takenote 文件夹复制到 ~/.claude/skills/ 即可——这是 Claude Code 的全局 Skills 目录，放在这里的 Skill 在所有项目中都可见。复制后，无论你在哪个目录工作，输入 /takenote 都能触发记笔记流程。需要注意的是，Skill 中引用的路径（如 1_关于我/个人背景.md）要改为笔记库的绝对路径，否则 Claude Code 在其他目录下找不到这些文件。

验证配置

搭建完成后，启动 Claude Code，输入：请读一下 CLAUDE.md，告诉我你理解的规则。如果它复述的内容和你写的一致，配置成功。如果理解有偏差，直接修改 CLAUDE.md，下次对话自动生效。

除了处理已有内容的 /takenote，知识库还支持两个辅助 Skill：/research-save 负责主动调研和知识获取，/update-vault 负责定期维护——全量更新索引、修复断链、同步外部目录。三个 Skill 分工明确：/takenote 归档已有知识，/research-save 获取新知识，/update-vault 定期维护索引和断链。

--- title: "16.2 搭建 AI 原生笔记库" --- ![搭建 AI 原生笔记库三步走](images/img_02_setup_steps.png) 搭建这套系统需要三步：设计目录结构、编写 `CLAUDE.md` 规则文件、配置索引和 Skill 入口。 ## 目录结构设计新建一个文件夹作为笔记库根目录，里面建子文件夹。参考结构： ```txt MyNotes/ ├── .claude/ │ └── skills/ │ ├── takenote/ │ │ └── SKILL.md # 记笔记的标准入口 │ └── update-vault/ │ └── SKILL.md # 定期维护入口 ├── CLAUDE.md # 规则文件（系统控制中枢） ├── 1_关于我/ # 个人背景、经历、偏好 ├── 2_想法/ # 灵感、判断、随手记 ├── 3_工作/ # 项目文档、任务推进 ├── 4_学习/ # 读书笔记、课程笔记 ├── 5_会议/ # 会议记录、决策和待办 ├── 6_研究/ # 调研、深度分析 ├── 7_行政/ # 汇报、流程文档 ├── 8_附件/ # PDF、图片、录音转写 ├── 9_代码/ # 代码片段、技术备忘 └── 临时工作区/ # AI 中间产物和草稿 ``` 文件夹命名有一条核心原则：**让 AI 一眼看懂用途**。Claude Code 靠文件夹名字判断内容该放哪里。`5_会议/` 比 `misc/` 或 `folder-e/` 好得多。数字前缀让排列有序，中文名字让语义清晰。 ::: {.callout-tip} ## 最佳实践从 5-7 个文件夹开始，在使用中逐步拆分。一开始就设计 15 个文件夹，大部分会空置。文件夹可以继续往下分二级目录，比如 `3_工作/` 下面再分 `客户A/`、`客户B/`。 ::: 根目录只放 `CLAUDE.md` 一个文档文件，其他内容全进子文件夹。这套系统不需要单独的收件箱。Claude Code 的对话框本身就是入口——有想法、有会议纪要、有邮件摘要，直接发给它处理。 ## CLAUDE.md 三块核心内容 `CLAUDE.md` 是整套系统的灵魂。Claude Code 在笔记库目录下工作时，每次对话都会自动读取这份文件。你在里面写什么规则，它就按什么规则处理输入。这份文件至少包含三块内容。 **第一块：库的用途和用户背景。** 告诉 AI 这个库是做什么的、你是谁。背景要短——职业、当前工作、写作风格，三到五行即可。详细信息放在 `1_关于我/个人背景.md`。 **第二块：处理流程。** 这是最关键的部分，直接决定 Claude Code 收到输入后怎么做。不要只写一句含糊的要求，要把处理步骤的先后顺序写清楚。 **第三块：笔记格式和写作要求。** 规定 frontmatter 模板、标签体系、语言风格。以下是一份完整的 `CLAUDE.md` 配置示例： ```txt # CLAUDE.md 这个文件规定 Claude Code 在这套笔记库里的工作方式。 ## 用途和背景这是我的个人知识库，用来记录工作想法、会议记录、学习笔记和研究资料。每次我给你一段内容，请先理解它是什么，再决定该放到哪里。我的简要背景： - 职业：经济学研究者 - 当前主要工作：行为博弈论实验、教学 - 写作风格：简洁，条列式为主 - 如需更完整的人物背景，先读 `1_关于我/个人背景.md` 目录结构： - 1_关于我/：个人背景、当前状态、长期项目 - 2_想法/：灵感和随手记的点子 - 3_工作/：项目文档、任务推进 - 4_学习/：读书和课程笔记 - 5_会议/：所有会议记录 - 6_研究/：深度分析和调研 - 7_行政/：汇报和行政文档 - 8_附件/：PDF、图片、邮件导出、录音转写 - 9_代码/：技术相关 ## 每次我输入一段内容时，按这个顺序处理 1. 分析输入的主题和关键词 2. 先读本文件中的规则；如果任务需要个性化判断，再读 `1_关于我/个人背景.md` 3. 搜索已有笔记，看有没有可以合并的 4. 判断放进哪个文件夹（不确定就问我） 5. 创建或更新笔记，加标签、建链接 6. 同步更新对应文件夹的 _index.md 7. 告诉我创建了什么、放在哪里、改了什么 ## 搜索方式每次搜索，先看根目录结构，进入相关子文件夹读取 _index.md，最后再读具体笔记。 ## 更新规则每次创建或更新笔记后，同步更新对应文件夹的 _index.md。 ## 笔记格式每条笔记开头要有： --- created: YYYY-MM-DD tags: - type/idea - status/draft --- ## 写作要求 - 写自然流畅的中文 - 不用套话 - 如非必要，不用引号 - 中英文之间加半角空格 - 只给已有笔记加链接，不要凭空造空链接 ## 安全规则 - 修改已有笔记前先确认 - 未经允许不要删除原内容 - 保留用户原始输入 ``` ::: {.callout-warning} ## 注意 `CLAUDE.md` 写得越具体，AI 的行为越稳定。含糊的规则会导致每次处理结果飘忽不定。比如，只写一句含糊指令和写出 7 步处理流程，效果差距很大。 ::: ## 索引系统笔记多了之后，光靠 `CLAUDE.md` 里的目录说明不够精确。解决方法是给每个文件夹建一个 `_index.md`，列出该文件夹下所有笔记的路径和一句话说明。比如 `2_想法/_index.md`： ```txt # 2_想法 - 索引 | 文件 | 内容 | |:---|:---| | 社群运营新模式.md | 用每日任务打卡提高成员 AI 能力的社群设计思路 | | 客户沟通复盘.md | 客户提出价格异议时的应对框架 | | 年度目标调整.md | 2026 年第二季度重新设定优先级的思考 | ``` `CLAUDE.md` 告诉 AI 应该怎么找，`_index.md` 告诉 AI 这个文件夹里到底有什么。两者配合，定位才能又准又快。索引不用手动写。在 `CLAUDE.md` 配置好后，告诉 Claude Code： ```opencode 帮我给每个子文件夹创建一个 _index.md，列出文件夹内所有文件的路径和一句话说明 ``` 它会自动遍历目录并生成索引。这样就形成了闭环：用户输入内容 → Claude Code 按规则处理 → 写入或更新笔记 → 自动更新索引 → 下次搜索更准。 ## takenote Skill 入口 `.claude/skills/takenote/` 目录下的 `SKILL.md` 是记笔记的标准入口。它接住 `/takenote`、记一下、帮我整理成笔记这类指令，并把内容送进 `CLAUDE.md` 定义的处理流程。一份精简版的 `SKILL.md`： ```skill --- name: takenote description: 当用户想记录一条笔记、输入一段原始想法、整理会议内容、保存学习摘要，或提到 /takenote、记一下、帮我整理成笔记时使用。 --- # takenote 把用户输入的内容整理成一条正式笔记，写入笔记库。默认假设用户提供的是原始素材，不是整理好的笔记。先接住内容，再按规则归档。 ## 先读什么 1. 先读取仓库根目录的 CLAUDE.md。 2. 如果任务需要个性化判断，再读取 1_关于我/个人背景.md。 3. 确定目标目录后，先读对应目录下的 _index.md，再读可能相关的已有笔记。 ## 处理流程 1. 判断内容类型和最合理的落点。 2. 搜索相关 _index.md 和已有笔记，判断应该新建还是更新。 3. 生成清晰的中文标题。 4. 按 CLAUDE.md 里的格式写成正式笔记。 5. 在 Related 中补充真实存在的相关笔记链接。 6. 同步更新对应目录下的 _index.md。 7. 简要告诉用户创建或更新了什么文件。 ``` Skill 与 `CLAUDE.md` 的分工明确：Skill 负责接住入口指令，规则文件负责定义处理流程。为什么要用 Skill 而不是随便聊？标准化入口让每次记笔记的行为更稳定。未经 Skill 触发的自然语言输入，Claude Code 有时会以问答模式回复，而不执行完整的归档操作。通过 `/takenote` 或触发词进入 Skill，它会按照预设流程走完全部步骤。 ::: {.callout-tip} ## 在任何目录使用 /takenote 上面的 `takenote` Skill 放在笔记库的 `.claude/skills/` 目录下，只有在笔记库目录内启动 Claude Code 时才能触发。如果你想在任何项目、任何目录下随时记笔记，把 `takenote` 文件夹复制到 `~/.claude/skills/` 即可——这是 Claude Code 的全局 Skills 目录，放在这里的 Skill 在所有项目中都可见。复制后，无论你在哪个目录工作，输入 `/takenote` 都能触发记笔记流程。需要注意的是，Skill 中引用的路径（如 `1_关于我/个人背景.md`）要改为笔记库的绝对路径，否则 Claude Code 在其他目录下找不到这些文件。 ::: ::: {.callout-tip} ## 验证配置搭建完成后，启动 Claude Code，输入：请读一下 CLAUDE.md，告诉我你理解的规则。如果它复述的内容和你写的一致，配置成功。如果理解有偏差，直接修改 `CLAUDE.md`，下次对话自动生效。 ::: 除了处理已有内容的 `/takenote`，知识库还支持两个辅助 Skill：`/research-save` 负责主动调研和知识获取，`/update-vault` 负责定期维护——全量更新索引、修复断链、同步外部目录。三个 Skill 分工明确：`/takenote` 归档已有知识，`/research-save` 获取新知识，`/update-vault` 定期维护索引和断链。