Skip to content

[style-harmonize] update SKILL-INDEX entry to match engine-neutral readback in PR #48 #49

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
weicao merged 1 commit into from
May 3, 2026
Merged

[style-harmonize] update SKILL-INDEX entry to match engine-neutral readback in PR #48 #49

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/SKILL-INDEX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 条硬规则
Expand Down