diff --git a/docs/SKILL-INDEX.md b/docs/SKILL-INDEX.md
index 8a10603..f3546fb 100644
--- a/docs/SKILL-INDEX.md
+++ b/docs/SKILL-INDEX.md
@@ -76,7 +76,7 @@
 按文档主题依次列出，含完整 metadata 描述，作为详细 reference：
 
 - [`docs/addon-reconfigure-guide.md`](addon-reconfigure-guide.md)
-- [`docs/addon-reconfigure-version-skew-guide.md`](addon-reconfigure-version-skew-guide.md) — 跨 KB 版本带 (1.0.x / 1.1.x / 1.2 main) 维护同一份 addon 的 reconfigure 演化指南。聚焦三类核心问题：(a) 主推路径切换（legacy `paramsdef.reloadAction.shellTrigger` 在 1.2 main deprecated → 主推 `ComponentDefinition.spec.configs[].reconfigure.exec`），(b) silent regression（OpsRequest 报 Succeed 但 runtime 未应用，唯一可信 ground truth 是每个 pod 上 `CONFIG GET`），(c) fan-out 默认 primary-only，addon 需显式 `targetPodSelector: All` 才覆盖所有 pod。提供三种 portability 套路（双写共存 / 单写选边 / template variant）+ 6 类 trap 清单（legacy reloadAction ignore / cmpd.exec ignore / fan-out 漏 All / CONFIG SET silent +OK / hash marker 漂移 / init-script 残留）+ 跨版本测试矩阵。和 `addon-chart-vs-kb-schema-skew-diagnosis-guide.md` 形成 cross-version 主题对子（前者 setup-time blocker，本篇 runtime-time silent failure）
+- [`docs/addon-reconfigure-version-skew-guide.md`](addon-reconfigure-version-skew-guide.md) — 跨 KB 版本带 (1.0.x / 1.1.x / 1.2 main) 维护同一份 addon 的 reconfigure 演化指南。聚焦三类核心问题：(a) 主推路径切换（legacy `paramsdef.reloadAction.shellTrigger` 在 1.2 main deprecated → 主推 `ComponentDefinition.spec.configs[].reconfigure.exec`），(b) silent regression（OpsRequest 报 Succeed 但 runtime 未应用，唯一可信 ground truth 是每个 pod 上 engine-specific runtime readback — Valkey/Redis `CONFIG GET` / Oracle `v$parameter` / MariaDB `SHOW VARIABLES` / SQL Server `sys.configurations` / OceanBase `__all_sys_parameter` 等，详见父 doc chapter 5 cross-engine readback 表），(c) fan-out 默认 primary-only，addon 需显式 `targetPodSelector: All` 才覆盖所有 pod。提供三种 portability 套路（双写共存 / 单写选边 / template variant）+ 6 类 trap 清单（legacy reloadAction ignore / cmpd.exec ignore / fan-out 漏 All / CONFIG SET silent +OK / hash marker 漂移 / init-script 残留）+ 跨版本测试矩阵。和 `addon-chart-vs-kb-schema-skew-diagnosis-guide.md` 形成 cross-version 主题对子（前者 setup-time blocker，本篇 runtime-time silent failure）
 - [`docs/addon-switchover-guide.md`](addon-switchover-guide.md)
 - [`docs/addon-test-acceptance-and-first-blocker-guide.md`](addon-test-acceptance-and-first-blocker-guide.md) — 测试成功语义、bounded eventual convergence、first blocker 分层、validation-only gate 身份固定、现场冻结和测试资产统计口径
 - [`docs/addon-test-probe-classification-guide.md`](addon-test-probe-classification-guide.md) — 一次探针失败如何分到正确的层（`route_api` / `<client>_<channel>` / `empty_output` / `parse_empty` / `runtime_mismatch` / `real_*_mismatch`），以及写探针的 7 条硬规则