✨ feat(skills): add tsl syntax reference skill
This commit is contained in:
+6
-7
@@ -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` 可写结构。
|
||||
|
||||
Reference in New Issue
Block a user