vivado: resolve install path from ~/skills_env.md instead of hardcoding D:\Xilinx

The Vivado install root differs per machine (C:\Xilinx here, D:\Xilinx on the
box these skills were written on), so every hardcoded path was already wrong
on this machine.

- new fpga_flash/scripts/vivado_env.py: resolves --vivado-dir > env var >
  VIVADO_ROOT (falling back to VIVADO_PATH) from ~/skills_env.md
- gen_mcs / program_flash / check_flash_csv: --vivado-dir now optional
- fpga_update/gen_update_mcs.py: same precedence for --vivado
- fpga_flash / smod_atsc_dev / vivado-prj-create SKILL.md: document the
  lookup instead of naming a drive letter
- skills_env template: VIVADO_ROOT/VIVADO_PATH are now blanks to fill in,
  so a new machine can't inherit a wrong default

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

fpga_flash/SKILL.md

@@ -52,16 +52,18 @@ python "$USERPROFILE/.claude/skills/fpga_flash/scripts/<script>.py" [参数...]
 调用 `check_flash_csv.py`，检查 `xicom_cfgmem_part_table.csv` 中是否已包含 `w25q128bv-spi-x1_x2_x4`：
 
 ```bash
-python "$USERPROFILE/.claude/skills/fpga_flash/scripts/check_flash_csv.py" \
-    --vivado-dir "D:/Xilinx/Vivado/2018.1"
+python "$USERPROFILE/.claude/skills/fpga_flash/scripts/check_flash_csv.py"
 ```
 
 **返回值含义：**
 - 退出码 `0`：器件已存在，直接进入第二步
 - 退出码 `2`：已成功添加器件行，需提示用户**重启 Vivado** 后才能识别
-- 退出码 `1`：CSV 未找到，询问用户提供正确的 Vivado 安装目录后重试
+- 退出码 `1`：CSV 未找到，检查 `~/skills_env.md` 的 `VIVADO_ROOT` 是否指向有效的 Vivado 安装
 
-若 Vivado 不在默认路径 `D:/Xilinx/Vivado/2018.1`，询问用户后替换 `--vivado-dir` 的值。
+**Vivado 安装路径不写死在本 skill 里**：三个脚本都通过 `scripts/vivado_env.py`
+按 `--vivado-dir` > 环境变量 > `~/skills_env.md` 的 `VIVADO_ROOT`（退化到 `VIVADO_PATH`）
+的顺序解析。换机器只改 `~/skills_env.md`，不改 skill。仅在需要临时用另一套 Vivado
+时才显式传 `--vivado-dir`。
 
 ---
 
@@ -88,12 +90,11 @@ python "$USERPROFILE/.claude/skills/fpga_flash/scripts/check_flash_csv.py" \
 
 ```bash
 python "$USERPROFILE/.claude/skills/fpga_flash/scripts/gen_mcs.py" \
-    --vivado-dir "D:/Xilinx/Vivado/2018.1" \
     --bit-file   "E:/Xilinx_design/smod/SMOD_DTMB_CG/RU_golden/RU_golden.runs/impl_1/RU_golden_top.bit" \
     --mcs-file   "E:/Xilinx_design/smod/SMOD_DTMB_CG/RU_golden/RU_golden.runs/impl_1/RU_golden_smod.mcs"
 ```
 
-将示例路径替换为用户实际的 Vivado 安装路径、.bit 文件路径、.mcs 输出路径。
+将示例路径替换为用户实际的 .bit 文件路径、.mcs 输出路径（Vivado 路径自动解析，见第一步）。
 
 **验证成功的标志：** 输出中包含 `write_cfgmem completed successfully` 且显示 `0 Errors`。
 
@@ -105,7 +106,6 @@ python "$USERPROFILE/.claude/skills/fpga_flash/scripts/gen_mcs.py" \
 
 ```bash
 python "$USERPROFILE/.claude/skills/fpga_flash/scripts/program_flash.py" \
-    --vivado-dir  "D:/Xilinx/Vivado/2018.1" \
     --flash-part  "w25q128bv-spi-x1_x2_x4" \
     --bit-file    "E:/Xilinx_design/smod/SMOD_DTMB_CG/RU_golden/RU_golden.runs/impl_1/RU_golden_top.bit" \
     --mcs-file    "E:/Xilinx_design/smod/SMOD_DTMB_CG/RU_golden/RU_golden.runs/impl_1/RU_golden_smod.mcs" \
@@ -149,7 +149,7 @@ ILA core 的 `Dropping logic core` WARNING 是正常现象（载入 loader/golde
 
 | 现象 | 可能原因 | 解决方法 |
 |------|----------|----------|
-| `check_flash_csv.py` 退出码 1 | Vivado 不在默认路径 | 询问用户，更换 `--vivado-dir` 参数 |
+| `check_flash_csv.py` 退出码 1 | `VIVADO_ROOT` 未配置或指错 | 修正 `~/skills_env.md` 的 `VIVADO_ROOT`；临时可传 `--vivado-dir` 覆盖 |
 | Vivado 中找不到 w25q128bv | CSV 已修改但 Vivado 未重启 | 提示用户重启 Vivado 后重新执行 |
 | `No hardware target` 错误 | JTAG 未连接或板卡未上电 | 检查连接后重新执行第四步 |
 | DONE 灯不亮 | 启动模式跳线错误 | 检查 MODE 引脚电平，确认为 SPI 启动模式 |