generate-mocs

1## Language / 语言
2 
3First resolve `OUTPUT_LANGUAGE` using [language selection](../_shared/language.md).
4For an English request (or an explicit request for English), read and follow
5[the English workflow](SKILL.en.md) instead of the Chinese body below.
6中文请求继续执行下文；用户明确指定的语言优先。内部阶段继承语言，不从论文或工具输出重新判断。
7 
8## 执行环境
9 
10开始前读取 [Agent 运行约定](../_shared/agent-runtime.md)，解析当前 Skill 目录、有效配置和 `TEMP_DIR`，再执行下文。
11 
12# 更新目录页
13 
14这个 skill 用于手动补刷 Obsidian 里的目录页 / 导航页（MOC）。
15 
16## Step 0: 读取共享配置
17 
18运行 `python3 ../_shared/user_config.py`，使用其输出的合并配置（含个人配置和环境变量覆盖）。
19 
20显式生成并在后续统一使用这些变量：
21 
22- `VAULT_PATH`
23- `NOTES_PATH`
24- `CONCEPTS_PATH`
25- `AUTO_REFRESH_INDEXES`
26- `GIT_COMMIT_ENABLED`
27- `GIT_PUSH_ENABLED`
28 
29其中：
30 
31- `NOTES_PATH = {VAULT_PATH}/{paper_notes_folder}`
32- `CONCEPTS_PATH = {NOTES_PATH}/{concepts_folder}`
33- `GIT_PUSH_ENABLED` 只有在 `GIT_COMMIT_ENABLED=true` 时才可能为真
34 
35后续步骤统一使用上面的变量。
36 
37## 执行步骤
38 
391. 运行概念目录页脚本：
40 
41```bash
42python3 ../_shared/generate_concept_mocs.py
43```
44 
452. 运行论文目录页脚本：
46 
47```bash
48python3 ../_shared/generate_paper_mocs.py
49```
50 
513. 汇报：
52   - 扫描了多少个目录
53   - 新建 / 更新了多少个目录页
54   - 目录页文件写到了哪里
55 
56## git 自动化
57 
58默认配置下：
59 
60- `AUTO_REFRESH_INDEXES=true`
61- `GIT_COMMIT_ENABLED=false`
62- `GIT_PUSH_ENABLED=false`
63 
64只有在 `GIT_COMMIT_ENABLED=true` 时才做 git 操作，并且必须先检查：
65 
661. `VAULT_PATH/.git` 是否存在
672. `git add` 之后是否真的有 staged changes
68 
69只有在上面两项都满足时才 commit。
70 
71只有在 `GIT_PUSH_ENABLED=true` 且仓库已配置远端时才 push。
72 
73## 结果要求
74 
75- 目录页生成逻辑必须来自仓库自带脚本，不依赖 `VAULT_PATH/scripts/*`
76- 重复运行应保持幂等
77- 用户手动运行这个 skill 时，不受 `AUTO_REFRESH_INDEXES` 开关影响