feat(skills): add tsl syntax reference skill

This commit is contained in:
csh
2026-07-13 09:16:51 +08:00
parent 1a9a1aeee9
commit ce1b92bbde
42 changed files with 562 additions and 461 deletions
+6 -7
View File
@@ -4,7 +4,7 @@
是否可直接用于生成代码:仅部分
是否含可直接照写示例:否
是否含不可照写反例:否
遇到不确定时:命名对象不明看 [syntax/02_core_model.md](syntax/02_core_model.md);代码组织看 [code_style.md](code_style.md);语法事实看 [syntax/index.md](syntax/index.md)
遇到不确定时:命名对象或语法事实不明时使用 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md);代码组织看 [code_style.md](code_style.md)
本页记录本仓库/作者的命名偏好,不代表 TSL 语法事实。本页只规定命名后的实体如何取名,不承担文件模型、顶层声明、执行顺序等语法判断。命名偏好与 Google C++ Style Guide 的实体形状思路对齐:通过名字的“形状”快速判断实体类型(类型/函数/变量/常量等),减少阅读成本。
@@ -48,16 +48,15 @@
`getSysParams("xxx")`;自定义 wrapper 仍按本指南使用 `PascalCase`
- 常规自定义标识符不要使用 TSL 关键字、保留字或内置函数名。适用范围包括变量、
参数、函数/过程、类/类型、property、方法、字段、unit 名和文件基名。
- 关键字和保留名清单
[16_lexical_structure_and_compile_options.md](syntax/16_lexical_structure_and_compile_options.md)
为准;例如 `label` 是控制流保留名,不要作为普通变量、函数或属性名。
- 关键字和保留名清单由 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md)
管理;需要判断具体名称时必须向该事实所有者查询,本页不枚举或判定具体保留名。
- 如果业务术语与关键字或内置名冲突,优先换成语义清楚的替代名称。只有明确需要
演示同名遮蔽、绑定外部接口或保持协议兼容时,才允许使用冲突名。
- 函数参数场景可以使用 5.1 中的前导下划线例外。
## 3. 类型命名(Type Names
文件模型和顶层声明规则`docs/tsl/syntax/02_core_model.md` 为准。本页只覆盖“需要命名的顶层实体”,不覆盖脚本语句本身。
文件模型和顶层声明规则由 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) 管理。本页只覆盖“需要命名的顶层实体”,不覆盖脚本语句本身。
- **类与单元**使用
`PascalCase`,不带下划线;名称应为名词/名词短语(通常单数),避免动词开头。
@@ -72,8 +71,8 @@
## 4. 文件命名与顶层声明(File Names)
文件模型、可写顶层声明、声明与文件关系
`docs/tsl/syntax/02_core_model.md` 为准;本节只给已经确定要命名的文件/实体提供命名偏好。
文件模型、可写顶层声明、声明与文件关系
[tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) 管理;本节只给已经确定要命名的文件/实体提供命名偏好。
- 先用核心模型页判断目标是否存在需要命名的顶层实体;不要从本页反推
`.tsl` / `.tsf` 可写结构。