📦 deps(tsl): sync tsl-playbook from ecedf69b

Source-Commit: ecedf69b9c

skills/tsl-syntax-reference/data/README.md

@@ -21,16 +21,28 @@
 
 - 键必须与 `references/` 下的文件名完全一致；每个参考页至少一条短语。
   键写错或参考页改名后 `_intent_score` 会静默返回 0 分，该页失去自然语言
-  入口。`lookup.py --check` 负责拦截页键漂移，行为回归测试负责拦截排序漂移。
+  入口。`lookup.py --check` 负责拦截页键漂移；查询排序以 lookup 实现和实际
+  查询结果为准。
 
-## 改动后的校验
+## 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
-python -m unittest test.test_tsl_syntax_reference -v
 ```
 
 `--check` 会校验 `page_intent_aliases` 的键与 `references/` 参考页一一对应：
 键指向不存在的页、或某页没有自然语言入口都会报错。新增参考页时必须同时
-在这里补一条页级意图短语。它只做结构检查，不验证自然语言排序；原始 alias、
-助词变体、弱命中和已知真实问法由专属测试覆盖。
+在这里补一条页级意图短语。它只做结构检查，不验证自然语言排序；自然语言
+排序和真实问法应通过实际查询验证。
+
+`--check` 还覆盖显式 ID、标题层级、quickstart 派生与 Owner Section、代码块身份、
+本地链接和大页粒度；它不证明事实语义、检索排序或示例运行结果。