li-index

name

li-index

description

当用户说「更新索引」「把这个加进索引」「添加了新文件」「新加了一本书/一篇笔记/一个文档」「素材库索引要更新」时，应使用本 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.

素材库索引维护

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

两种模式：

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

---

模式判断

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

---

增量维护模式

通用流程

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

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

---

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

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

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

读完后提取：

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

关键词质量判断：

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

---

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

Read 对应库的索引文件，观察：

• 表格列结构是什么？
• 分区是按主题、还是按工作流阶段、还是按内容类型？
• 文件路径的写法？有无特殊字符？
• 是否有决策规则区？

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

---

第四步：写入索引

在对应分区末尾追加新条目，然后判断是否需要更新决策规则：

• 新内容覆盖了规则未涵盖的选题类型 → 新增规则
• 新内容是某方向的有效补充 → 追加「或看『文件名』」
• 与现有条目高度重叠 → 跳过

---

各库特殊说明

读书笔记库

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

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

---

核心概念库

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

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

---

爆款脚本库

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

• 触发时机不同：这个索引只在内容发布后数据达到爆款标准时更新，不是添加新文件时更新
  • 平衡型爆款：点赞和收藏都 2000+
  • 收藏型爆款：收藏比 > 1.5
  • 涨粉型爆款：涨粉率 > 2%
• 格式完全不同：每条是结构化条目，包含数据/类型/文件路径/可复用结构/金句，没有表格，也没有决策规则
• 写入格式（参考现有条目）：

  #### [内容标题]
  - **数据**：点赞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：方法论沉淀可能有十几个文件，全部并行读完再开始写