用途：把本机 AI 会话历史的 Ataru 索引带到可检索（searchable）状态，并以 JSON 报告返回当前能否检索、还差多少、本次做了什么。检索本身由 lov-ataru-search 负责，本 Skill 只做索引运维。
主要能力：解析可用的 Ataru 可执行文件；读取索引状态并给出 needsBuild、isBuilding、progressPercent 判断字段；通过 ensure 幂等地把索引带到可检索状态（已就绪返回 already-ready，有增量跑 catch-up-build，他人在构建则 waited-for-running-build）；仅在用户明确要求完全重建时使用 --force；可运行 semantic-preview 预估语义索引成本。
使用方式（按顺序执行）： Step 0 解析二进制： export SKILL_DIR="$HOME/.claude/skills/lov-ataru-indexing" python3 "$SKILL_DIR/scripts/ataru_index.py" resolve-bin 解析顺序为 --bin 显式参数 → ATARU_BIN 环境变量 → PATH → 已安装 App bundle → 从当前目录向上查找的本地 dev build，并对每个候选先跑 --version。低于 0.41.3 的二进制不认识 index status，会打开窗口且不返回，因此必须先过版本门。失败返回 ATARU_BIN_NOT_FOUND 或 ATARU_BIN_TOO_OLD，并列出被拒绝候选及版本，应原样交给用户，不要自行猜路径。 Step 1 先读状态： python3 "$SKILL_DIR/scripts/ataru_index.py" status isBuilding 为真时不要发起构建，避免白烧全量 CPU。 Step 2 带到可检索： python3 "$SKILL_DIR/scripts/ataru_index.py" ensure --timeout 3600 首次全量构建在万级会话机器上是分钟级操作，默认预算 3600 秒，不要缩短 --timeout 去快速失败。 Step 3 如实转述 actions、state、totalSessions、totalMessages、indexSizeBytes；仍为 state: error 或 searchAvailable: false 时脚本以退出码 1 结束，error 字段即原因。
适用场景：用户要求构建、重建、修复或检查本地 Ataru 记忆索引，或在检索前确认索引是否可用。不适用：需要检索结果（交给 lov-ataru-search）；讨论 Ataru 界面、发布或代码改动（属产品开发任务）。
限制：依赖 Python 3.8+（仅标准库）与本机 Ataru 0.41.3 或更新版本。当前 JSON CLI 检索只走关键词模式，语义索引只服务桌面端，不要承诺命令行能拿到 hybrid 结果。构建锁只在进程内生效，跨进程并发靠写临时目录再原子替换兜底。用户档案中唯一值得长期保存的是 records.ataru_bin（可用的 Ataru 可执行文件路径），首次解析成功或用户直接给出路径时用 scripts/profile_store.py record 写回，不要硬编码进源码。本源码为独立 Single Skill，与 lov-ataru-search 之间只有制品级交接，无隐藏 sibling 依赖。