| 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
从零建立新库的 INDEX.md
如果目标库还没有索引文件，流程扩展为：
- Glob 找出该库下所有文件
- 逐一完整 Read 每个文件（不能跳过，可批量并行读取）
- 参考
内容素材库/核心概念库/INDEX.md 的格式新建文件，开头加 AI 使用规则
- 建好后，更新 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 条
体检模式注意事项
- 路径写法要和 INDEX 一致：有的 INDEX 用
相对路径.md，有的用 [名](路径)，要识别现有格式
- 同名异路径不算漏录：例如 INDEX 写
《X》.md 实际文件是 《X》 作者.md（含双空格），算路径错误而非漏录，应先 Ask 用户
- 不读爆款脚本库：上面已说明
- 大库优先并行 Read：方法论沉淀可能有十几个文件，全部并行读完再开始写
