---

name: generate-mocs description: | Refresh paper and concept indexes (maps of content). English triggers: "refresh indexes", "update paper and concept indexes", "refresh MOCs".

重新生成 Obsidian 里的目录页 / 导航页（MOC）。 当用户说“更新索引”“更新论文和概念目录”“刷新论文和概念目录”“刷新MOC”时使用。

Language / 语言

First resolve OUTPUT_LANGUAGE using language selection. For an English request (or an explicit request for English), read and follow the English workflow instead of the Chinese body below. 中文请求继续执行下文；用户明确指定的语言优先。内部阶段继承语言，不从论文或工具输出重新判断。

执行环境

开始前读取 Agent 运行约定，解析当前 Skill 目录、有效配置和 TEMP_DIR，再执行下文。

更新目录页

这个 skill 用于手动补刷 Obsidian 里的目录页 / 导航页（MOC）。

Step 0: 读取共享配置

运行 python3 ../_shared/user_config.py，使用其输出的合并配置（含个人配置和环境变量覆盖）。

显式生成并在后续统一使用这些变量：

• VAULT_PATH
• NOTES_PATH
• CONCEPTS_PATH
• AUTO_REFRESH_INDEXES
• GIT_COMMIT_ENABLED
• GIT_PUSH_ENABLED

其中：

• NOTES_PATH = {VAULT_PATH}/{paper_notes_folder}
• CONCEPTS_PATH = {NOTES_PATH}/{concepts_folder}
• GIT_PUSH_ENABLED 只有在 GIT_COMMIT_ENABLED=true 时才可能为真

后续步骤统一使用上面的变量。

执行步骤

1. 运行概念目录页脚本：

python3 ../_shared/generate_concept_mocs.py

2. 运行论文目录页脚本：

python3 ../_shared/generate_paper_mocs.py

3. 汇报：
   • 扫描了多少个目录
   • 新建 / 更新了多少个目录页
   • 目录页文件写到了哪里

git 自动化

默认配置下：

• AUTO_REFRESH_INDEXES=true
• GIT_COMMIT_ENABLED=false
• GIT_PUSH_ENABLED=false

只有在 GIT_COMMIT_ENABLED=true 时才做 git 操作，并且必须先检查：

1. VAULT_PATH/.git 是否存在
2. git add 之后是否真的有 staged changes

只有在上面两项都满足时才 commit。

只有在 GIT_PUSH_ENABLED=true 且仓库已配置远端时才 push。

结果要求

• 目录页生成逻辑必须来自仓库自带脚本，不依赖 VAULT_PATH/scripts/*
• 重复运行应保持幂等
• 用户手动运行这个 skill 时，不受 AUTO_REFRESH_INDEXES 开关影响