🐛 fix(tsl-syntax-reference): route derived rules and bound section size

This commit is contained in:
csh
2026-08-20 15:49:41 +08:00
parent ca6830af9f
commit 5a8d95ebcf
7 changed files with 420 additions and 145 deletions
+14 -1
View File
@@ -23,7 +23,16 @@
键写错或参考页改名后 `_intent_score` 会静默返回 0 分,该页失去自然语言
入口。`lookup.py --check` 负责拦截页键漂移,行为回归测试负责拦截排序漂移。
## 改动后的校验
## Skill 维护与校验
Section ID 来自标题下的显式 `<!-- section-id: ... -->` 元数据,不从标题派生。改标题
时保留原 ID;新增章节时分配新 ID,不重排或复用旧 ID。quickstart 派生规则必须与
专题事实逐字一致,并显式给出可由 `--section` 直接取回的 Owner Section。
大型参考页必须把可检索事实切成受控大小的叶子 Section,避免一次精确取回返回数百行。
`--check` 会校验大页的叶子 Section 粒度;拆分时保留已有 ID,把新主题分配给新 ID。
改动本 Skill、参考页、`data/` 词表或 lookup 实现后运行:
```bash
python skills/tsl-syntax-reference/scripts/lookup.py --check
@@ -34,3 +43,7 @@ python -m unittest test.test_tsl_syntax_reference -v
键指向不存在的页、或某页没有自然语言入口都会报错。新增参考页时必须同时
在这里补一条页级意图短语。它只做结构检查,不验证自然语言排序;原始 alias、
助词变体、弱命中和已知真实问法由专属测试覆盖。
`--check` 还覆盖显式 ID、标题层级、quickstart 派生与 Owner Section、代码块身份、
本地链接和大页粒度;它不证明事实语义、检索排序或示例运行结果。仓库级 unittest
负责 CLI、排序与退出码行为。