♻️ refactor(tsl-api): tighten docs and retire stale tests
This commit is contained in:
@@ -21,7 +21,8 @@
|
||||
|
||||
- 键必须与 `references/` 下的文件名完全一致;每个参考页至少一条短语。
|
||||
键写错或参考页改名后 `_intent_score` 会静默返回 0 分,该页失去自然语言
|
||||
入口。`lookup.py --check` 负责拦截页键漂移,行为回归测试负责拦截排序漂移。
|
||||
入口。`lookup.py --check` 负责拦截页键漂移;查询排序以 lookup 实现和实际
|
||||
查询结果为准。
|
||||
|
||||
## Skill 维护与校验
|
||||
|
||||
@@ -36,14 +37,12 @@ Section ID 来自标题下的显式 `<!-- section-id: ... -->` 元数据,不
|
||||
|
||||
```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、代码块身份、
|
||||
本地链接和大页粒度;它不证明事实语义、检索排序或示例运行结果。仓库级 unittest
|
||||
负责 CLI、排序与退出码行为。
|
||||
本地链接和大页粒度;它不证明事实语义、检索排序或示例运行结果。
|
||||
|
||||
Reference in New Issue
Block a user