# Li Index

> 当用户说「更新索引」「把这个加进索引」「添加了新文件」「新加了一本书/一篇笔记/一个文档」「素材库索引要更新」时，应使用本 skill 的【增量维护模式】。 当用户说「索引体检」「index 体检」「检查索引」「索引同步」「补齐索引」时，应使用本 skill 的【体检模式】，扫描所有库 ↔ INDEX 找出漏录/失效条目并批量补齐。 适用于所有带 INDEX.md 的库：读书笔记库、核心概念库、爆款脚本库、04-方法论沉淀，以及未来新建的任何库。 索引的价值取决于内容准确性——必须先完整读取原文再写入，凭文件名或印象推断会导致索引失去参考价值。 即使用户只说「我加了一个文件」「这个放进去」，只要涉及索引，也应触发本 skill。 不应触发：仅查阅索引（直接 Read）、深化选题（用 li-topic）、生成脚本（用 li-writer）。 Use when the user adds new content to any indexed library, OR runs a global index health-check to find missing/stale entries.

- Skill: `jiangjiax/li-index` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jiangjiax/li-index`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiangjiax/li-index/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiangjiax (https://skillmd.com/u/jiangjiax)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jiangjiax/li-index

---


# 素材库索引维护

读书笔记库 / 核心概念库 / 爆款脚本库 / 04-方法论沉淀，以及未来新建的任何库。

两种模式：

- **增量维护模式**（默认）：用户告知"加了一个文件"，针对单个文件追加索引条目
- **体检模式**：用户说"索引体检"，全库扫描 ↔ INDEX 比对，批量补齐漏录、清理失效条目

---

## 模式判断

```
用户触发词 → 判断模式：
- "加了 X" / "把这个放进索引" / "更新索引" → 增量维护模式
- "索引体检" / "检查索引" / "索引同步" / "补齐索引" → 体检模式
```

---

## 增量维护模式

### 通用流程

### 第一步：确认目标库和新文件路径

根据用户描述判断是哪个库，用 Glob 在 `内容素材库/` 下定位文件。如果路径完整，直接进入下一步。

---

### 第二步：完整读取新文件原文

用 Read 工具读取该文件**全部内容**，不要只读片段。

这是核心步骤：索引条目的适用场景和关键词必须来自原文。凭文件名/标题推断几乎必然不准——AI 以后用索引检索时会匹配不到，或匹配到了内容对不上。

读完后提取：
- **核心主题**：一句话概括这份内容讲什么
- **适用场景**：什么类型的选题/内容会用到它（具体到场景，如"讲拖延" "讲产品故事化"）
- **关键词**：5-8 个，优先选反直觉、有具体操作、有独特视角的概念

关键词质量判断：

| ✅ 好的关键词 | ❌ 差的关键词 |
|------------|------------|
| 止痛药vs维生素（有对比判断） | 创业方法（过于笼统） |
| 多巴胺是期待感非快乐（颠覆常识） | 心理学知识（太宽泛） |
| 如果-那就计划（有具体操作） | 目标设定技巧（无特色） |

---

### 第三步：读取目标库的索引文件，理解格式

Read 对应库的索引文件，观察：
- 表格列结构是什么？
- 分区是按主题、还是按工作流阶段、还是按内容类型？
- 文件路径的写法？有无特殊字符？
- 是否有决策规则区？

新条目严格遵循现有格式，不要改变列结构或路径写法。

---

### 第四步：写入索引

在对应分区末尾追加新条目，然后判断是否需要更新决策规则：
- 新内容覆盖了规则**未涵盖**的选题类型 → 新增规则
- 新内容是某方向的有效补充 → 追加「或看『文件名』」
- 与现有条目高度重叠 → 跳过

---

## 各库特殊说明

### 读书笔记库

`内容素材库/读书笔记库/INDEX.md`

- **分区逻辑**：按主题分区（个人成长/心理/沟通/创业/哲学/技术/创作）
- **特殊要求**：书籍类文件通常很长，必须读完全文，不能只看前几段；书的核心观点往往在中后段
- **路径注意**：书名中可能含多个空格（如 `《黑客与画家》  保罗·格雷厄姆.md` 有双空格），路径必须与实际文件名一致

---

### 核心概念库

`内容素材库/核心概念库/INDEX.md`

- **分区逻辑**：按工作流阶段分区（选题阶段/脚本写作阶段/标题封面阶段），每个文件代表一套方法论或模板
- **关键词方向**：侧重方法框架名称（如"爆款公式""认知劫持"），而非书中的具体观点
- **决策规则**：规则要关联到具体创作步骤（深化选题时读哪个，生成脚本时读哪个）

---

### 爆款脚本库

`内容素材库/爆款脚本库/爆款索引.md`

- **触发时机不同**：这个索引只在**内容发布后数据达到爆款标准**时更新，不是添加新文件时更新
  - 平衡型爆款：点赞和收藏都 2000+
  - 收藏型爆款：收藏比 > 1.5
  - 涨粉型爆款：涨粉率 > 2%
- **格式完全不同**：每条是结构化条目，包含数据/类型/文件路径/可复用结构/金句，没有表格，也没有决策规则
- **写入格式**（参考现有条目）：
  ```markdown
  #### [内容标题]
  - **数据**：点赞X、收藏X（收藏比X）、涨粉X（涨粉率X%）
  - **类型**：[内容类型，如方法论型/工具教程型/经历型]
  - **路径**：`[文件路径]`
  - **可复用结构**：
    - 开场：[开场方式]
    - 主体：[主体结构]
    - 结尾：[结尾方式]
  - **金句**："[最具代表性的一句话]"
  ```

---

## 从零建立新库的 INDEX.md

如果目标库还没有索引文件，流程扩展为：

1. Glob 找出该库下所有文件
2. 逐一完整 Read 每个文件（不能跳过，可批量并行读取）
3. 参考 `内容素材库/核心概念库/INDEX.md` 的格式新建文件，开头加 AI 使用规则
4. 建好后，更新 li-topic/SKILL.md、li-writer/SKILL.md、CLAUDE.md，让 AI 创作流程中知道新索引的存在

---

## 体检模式

触发词：「索引体检」「检查索引」「索引同步」「补齐索引」「index 体检」

### 受体检的库（库注册表）

| 库根目录 | INDEX 文件 | 扫描方式 |
|---|---|---|
| `内容素材库/读书笔记库/` | `INDEX.md` | **文件存在性**：Glob 库下 `*.md`（排除 INDEX.md）↔ INDEX 中已记录路径 |
| `内容素材库/核心概念库/` | `INDEX.md` | **文件存在性**：Glob 库下 `*.md`（排除 INDEX.md）↔ INDEX 中已记录路径 |
| `04-方法论沉淀/` | `INDEX.md` | **文件存在性**：递归 Glob 所有 `*.md`（排除 INDEX.md）↔ INDEX 中已记录路径 |
| `05-选题研究/` | `INDEX.md` | **文件存在性**：分别校验「爆款话题分析报告」和「对标博主」两块，对标博主累计 ≥ 5 条才算需要单独列博主行 |
| `内容素材库/爆款脚本库/` | `爆款索引.md` | **数据阈值**：交叉 `03-数据统计/数据统计表.md` 中达到爆款标准的行 ↔ 爆款索引中已记录的标题。漏录 = 数据达标但索引未收录；失效 = 索引中文件路径已不存在 |

### 体检流程

**Step 1：扫描全库**

对每个库并行执行：
- Glob 列出库下实际文件
- Read 对应 INDEX.md，从表格行/链接中提取已记录的相对路径
- 计算两个集合：
  - `漏录` = 实际存在 - INDEX 已记录
  - `失效` = INDEX 已记录 - 实际存在

**Step 2：输出体检报告**

先把 diff 给用户看，**不要直接动手**：

```
📋 索引体检报告

📚 读书笔记库
  漏录（X 个）：
    - [文件路径]
  失效（X 个）：
    - [INDEX 中存在但文件已不在的条目]

📚 核心概念库
  ...

📚 04-方法论沉淀
  ...

总计：漏录 X 条，失效 X 条
```

**Step 3：等用户确认**

> 「上面是 diff。要全部补齐吗？还是挑几个？失效条目是删除还是先标记？」

得到指令再进 Step 4。**不要默认全自动**。

**Step 4：补齐漏录**

对用户确认要补的每个文件，按【增量维护模式】流程处理：完整 Read 原文 → 提取主题/场景/关键词 → 追加到对应库 INDEX 的正确分区。

可并行 Read 所有原文，但写入 INDEX 必须串行（避免编辑冲突）。

**爆款脚本库的特殊处理**：
- 漏录条目通常来自 `02-已发布内容/` 而非素材库本身
- 写入 `爆款索引.md` 时使用现有的结构化格式（数据/类型/路径/可复用结构/金句），不要套用通用 INDEX 表格格式
- 原文路径要写已发布内容的真实路径，不是脚本库内的路径

**Step 5：处理失效条目**

- 用户选"删除" → 从 INDEX 表格/链接中删掉对应行
- 用户选"标记" → 在条目尾追加 `⚠️ 文件已不存在，待确认`

**Step 6：输出体检完成报告**

```
✅ 体检完成
  补齐：X 条 → [列出新增条目]
  清理：X 条
  保留待人工处理：X 条
```

### 体检模式注意事项

1. **路径写法要和 INDEX 一致**：有的 INDEX 用 `相对路径.md`，有的用 `[名](路径)`，要识别现有格式
2. **同名异路径不算漏录**：例如 INDEX 写 `《X》.md` 实际文件是 `《X》  作者.md`（含双空格），算路径错误而非漏录，应先 Ask 用户
3. **不读爆款脚本库**：上面已说明
4. **大库优先并行 Read**：方法论沉淀可能有十几个文件，全部并行读完再开始写