用途与定位 kb-index 用于更新 Obsidian 知识库的索引文件，面向采用 PARA 分类（Projects、Areas、Resources、Archive）的库结构。它的核心默认行为是智能更新：检测磁盘上的实际文件与已有 _index.md 条目之间的差异，只处理新增和删除项，不重写未变化的条目。
主要能力
- 差异检测：对每个分类用 Glob 列出当前子目录与 .md 文件，与索引条目比对，分类为 MATCH（跳过）、ADDED（需添加）、REMOVED（需删除）。无差异时仅记录日志，不写入文件。
- 增量更新：仅对新增文件读取其概览或 frontmatter（每文件约 50-100 令牌），生成一行索引条目；删除项从 _index.md 移除；同时更新汇总计数行与 frontmatter 中的 updated 日期，并更新顶层 index.md 的分类计数和最近活动（取 log.md 最近 5 条）。
- 全量重建：使用 --full 时扫描各 PARA 目录，从 Templates/_index.md.template 重新生成每个分类的 _index.md（10-20 行，活跃/重要在前，其余按字母序，使用 [[wikilinks]]），再生成约 30 行的顶层 index.md。
- 范围与预览：--category 可将操作限定到 Projects、Areas、Resources 或 Archive；--dry-run 只显示将发生的变更而不写入。
使用方式 命令形式包括：/kb-index（默认差异更新）、/kb-index --full（全量重建）、/kb-index --category Projects（单分类）、/kb-index --dry-run（预览）。资料还给出三级策略：单文件摄入时 kb-ingest 已完成逐文件更新（约 200 令牌），无需单独运行 kb-index；少量文件变化使用默认差异更新（约 500-1500 令牌）；大规模重组、初次建立或索引严重损坏时使用 --full（约 3-4K 令牌）。若差异检测发现超过 30% 条目变化，建议改用 --full。
模板使用约定 Templates/_index.md.template 定义 _index.md 的标准形态，仅用于 --full 全量重建；增量更新时应在现有 _index.md 上原位置编辑，保留既有结构，只更新日期、汇总行和条目，不另造版式。
环境增强 当环境中有 obsidian 命令时，可用其搜索索引文件（例如搜索 type: kb-index）和标签统计，以在大型库中替代 Glob 提升效率。
适用场景与限制 适合文件新增、移动或删除后的索引同步，以及结构大规模调整后的重建。资料未提供该技能的价格、平台兼容性细节或安装方式；关于索引判断是否正确，资料建议先运行 kb-lint，必要时再运行 kb-lint --fix。