| name | index-repos |
| description | 为 _repos/ 下的外部 Git 仓库生成内容索引文件（indexes/repos/）。新增 submodule 或上游仓库更新后使用。 |
外部仓库索引生成
为 _repos/ 下的 Git Submodule 仓库生成内容索引。
输入
_repos/ 目录下的所有 submodule 仓库
输出
indexes/repos/<repo-name>.md — 每个仓库一个索引文件indexes/repos/_manifest.md — 总清单
工作流程（处理顺序）
- 判断哪些需更新 -> 更新判断：
python scripts/check_index_stale.py，取需更新的仓库列表
- 逐仓库扫描：读
_repos/<repo>/ 内容，按 扫描范围 过滤
- 生成索引：按 索引格式 与 质量要求 写
indexes/repos/<repo>.md（头部记录 生成时间 + 上游 commit）
- 更新总清单：写
indexes/repos/_manifest.md -> _manifest.md 格式
每个需更新的仓库执行 2-3，全部完成后执行 4。
规则
更新判断（submodule commit id）
- 更新依据：比较
_repos/<repo>/ 当前 HEAD commit 与索引中记录的「上游 commit」——不一致即该仓库索引过期，需重新生成
- 固化脚本：
python scripts/check_index_stale.py（扫描全部 submodule，比对当前 commit 与索引记录 commit，报告哪些需更新；--only <repo> 只看单个）
- commit id 记录位置：每个仓库索引文件头部
> 上游 commit：<hash>（即 indexes/repos/<repo>.md），不写入 _manifest.md（manifest 只做总清单，不重复记录 commit）
扫描范围
- 只读 Markdown（
.md）、纯文本（.txt）、CSV（.csv）文件
- 跳过图片（
.png .jpg .gif .svg .webp）、二进制、Notebook（.ipynb）的内部细节，但记录其存在和文件名
- 跳过
node_modules、.git 等非内容目录
索引格式
每个仓库的索引文件按主题组织，条目格式与版本标注统一按 indexing-rules Skill 执行：
# <仓库名> 内容索引
> 生成时间：YYYY-MM-DD
> 上游 commit：<hash>
## <主题分类1>
- **<文件路径>** — 一句话概要 [<适用版本>]
- 关键词：tag1, tag2, tag3
质量要求
- 主题分类以仓库内已有的目录结构为基础，必要时可重组
- 对 CSV 术语表类文件，记录其字段结构和语言覆盖范围
- 优先记录红石、机械、技术机制相关内容
- 纯工具脚本、模组配置等内容可简略记录
- 不追求覆盖每个文件，重点覆盖"对翻译有价值的参考内容"
_manifest.md 格式
# 外部仓库索引清单
| 索引文件 | 仓库 | 协议 | 条目数 | 主题数 |
|----------|------|------|--------|--------|
