📝 docs(tsl): align agent-facing guidance

2026-05-28 19:12:34 +08:00
parent c48354e0cb
commit d8eb418277
63 changed files with 1921 additions and 371 deletions
@@ -14,6 +14,14 @@

 回答“TSL 的词法层规则和编译期开关应该去哪里查，而不是把这些边界混进值、函数、类的正文里”。

+## Agent 词法/编译选项判断流程
+
+1. 先判断要写注释、标识符、条件编译，还是编译选项。
+2. 注释、大小写、条件编译指令只照本页已验证形态写。
+3. `{$Explicit+}` 会改变变量声明要求，生成代码前先判断是否需要 `var`。
+4. `{$VarByRef+}` / `{$VarByRef-}` 会影响未修饰形参传递语义，细节回看函数页。
+5. 没有已验证代码块时不要发明词法/编译选项写法。
+
 ## 必须记住的规则

 - 标识符大小写无关；当前最小运行验证里，下划线也可以出现在标识符中。
@@ -47,6 +55,13 @@ end.
 - 说明当前解释器下标识符大小写无关
 - 也说明下划线可以出现在标识符中

+代码块身份：已验证输出片段
+
+```text
+7
+7
+```
+
 注释与条件编译：

 代码块身份：已验证可执行示例