用途:重建 Obsidian 中 engineering/ vault 的三层 index.md,使 ai-* 文档形成完整连通的图谱。这是权威的确定性重建,用于修复各技能增量更新留下的索引漂移。该技能从不编辑现有文档正文,只创建或替换 index.md 文件;重建为全量覆盖,必须幂等,运行两次结果相同。
主要能力:按约定文件 references/index-conventions.md 定义的 wikilink 格式、三层索引、精确 markdown、排序规则和重建配方执行。自底向上重建:先重建叶子索引,再重建父级,确保父级链接到已存在的索引。
使用方式:默认 vault 根为 $HOME/Documents/obsidian/obsidian,可通过指定其他绝对路径覆盖。先检查 vault 根是否存在:test -d "$HOME/Documents/obsidian/obsidian";若缺失或 engineering 不存在,停止并提示用户先运行 ai-setup。随后遍历 engineering 下各项目,重建 workplans/<feature>/index.md(feature 层)、engineering/<project>/index.md(project 层)和 engineering/index.md(root 层),空章节省略。完成后在 vault 根提交并推送:git -C "$V" add -A && git -C "$V" commit -m "ai-reindex: rebuild wikilink indexes" && git -C "$V" push。若无暂存内容、无 origin 或推送失败,简要报告后结束,不中止技能。最后打印摘要,说明重建的项目、feature 和索引文件数量,并标记跳过项。
适用场景:需要修复或全量重建 Obsidian 工程知识库索引时。
限制:只递归布局定义的文件夹,feature 为扁平结构,不深入查找子 feature;不移动不符合布局的散落文件,仅提示;带时间戳的 review/PR 文件名原样用作链接目标和别名。