📝 docs(tsl): align agent-facing guidance
This commit is contained in:
+2
-3
@@ -50,8 +50,7 @@ Guide 对齐:通过名字的“形状”快速判断实体类型(类型/函
|
||||
|
||||
## 3. 类型命名(Type Names)
|
||||
|
||||
AI 先按四类顶层外形判断文件模型:顶层松散语句、顶层 `function / procedure`、
|
||||
顶层 `type Name = class`、顶层 `unit`。本页只覆盖“需要命名的顶层实体”,不覆盖松散语句本身;文件模型判断本身以
|
||||
AI 先按 `.tsl` 可执行脚本与 `.tsf` 模块/函数扩展判断文件模型。`.tsl` 里的语句区按顺序执行,函数/类声明区放在语句区之后;`.tsf` 用于可复用顶层声明并部署到解释器 `funcext`。本页只覆盖“需要命名的顶层实体”,不覆盖脚本语句本身;文件模型判断本身以
|
||||
`docs/tsl/syntax/03_core_model.md` 为准。
|
||||
|
||||
- **类与单元**使用
|
||||
@@ -76,7 +75,7 @@ TSL 的语法要求(仅 `.tsf`):每个 `.tsf`
|
||||
`function / procedure`、`type Name = class`、`unit`,文件基名需与之同名。
|
||||
- `.tsl` 脚本文件:用于入口/编排层;允许直接写语句(如
|
||||
`a := 1; echo a;`),也可能出现顶层 `function / procedure` 骨架或 `program test;`
|
||||
这类验证样例外壳;但风格上不把 `.tsl` 当成可复用顶层声明的默认落点,也不要求文件基名与函数名一致;可复用逻辑优先下沉到
|
||||
这类验证样例外壳;如果同时出现脚本语句和函数/类声明,语句区在前,声明区在后;但风格上不把 `.tsl` 当成可复用顶层声明的默认落点,也不要求文件基名与函数名一致;可复用逻辑优先下沉到
|
||||
`.tsf`(见 `docs/tsl/code_style.md`)。
|
||||
- 注:`.tsf` 也是 TSL 源文件,命名/风格与 `.tsl` 遵循同一套规则。
|
||||
- **硬规则(仅
|
||||
|
||||
Reference in New Issue
Block a user