用途：扫描项目文档结构，产出准确的文件树、按类别的文件数量、文档间关系以及关键词到文档的查找表，写入 docs/project-reference/docs-index-reference.md。
主要能力：
- 分类：先读取现有 index 文档，判断 init（仅占位）或 sync（已有内容）模式，并识别文档组织类型（结构化分层、扁平结构、wiki、混合）。
- 扫描：按类别统计文档数量，覆盖项目根目录、docs/ 各子目录、.claude/docs/ 等；通过 glob 校验每个数量，不复制旧文档中的数字，并运行宽泛 glob 找出未归类文件。
- 关系图：追踪入口文档链（README → getting-started → deployment 等）与交叉引用。
- 查找表：按业务功能目录和参考文档提取关键词，映射到路径。
- 新眼验证：由无记忆的子代理独立复核采样路径、类别总数、未归类文件、查找表完整性与重复项。
- 生成：写入带日期、文档图、关系图、查找指南和未归类文件的参考文档；更新时只做外科式修改，保留人工标注。
使用方式：在 Codex 中用 $skill-name 调用；执行前先建立任务跟踪。先读 docs/project-config.json 与 docs/project-reference/docs-index-reference.md，再按路由打开相关参考文档。当用户明确调用该技能且协议需要子代理时，视为已授权使用对应 spawn_agent 子代理。
适用场景：需要维护项目文档索引、核对文档数量与路径、建立关键词检索入口，或准备 AI 可读取的项目参考文档时。
限制：文档未提供具体 CLI 命令、脚本名或安装步骤；分类阈值、置信度要求（如低于60%需询问用户）等规则来自资料约定。若环境缺少所需步骤或工具，应先停止并询问用户。