📝 docs(tsl): align agent-facing guidance

docs/tsl/syntax/index.md

@@ -6,7 +6,7 @@
 是否含已验证反例：否
 遇到不确定时跳转到：[02_quickstart.md](02_quickstart.md)（优先）、[03_core_model.md](03_core_model.md)、[07_expressions_and_operators.md](07_expressions_and_operators.md)、[09_objects_and_classes.md](09_objects_and_classes.md)、[12_pitfalls.md](12_pitfalls.md)
 
-这里是 TSL 语法手册入口。只处理“语言怎么写”，不处理金融业务语义。
+这里是 TSL 语法手册入口。只处理“agent 应该怎样识别并生成语言写法”，不处理金融业务语义。本文档不是人类教程；它给 agent 提供判断顺序、关键词分流和可靠示例入口。
 
 ## 元数据读法
 
@@ -20,10 +20,20 @@
 
 ## 这本手册怎么读
 
-- 默认先走“按任务跳转”，不要先顺序读完整套。
+- 默认先走“Agent 判断流程”和“按任务跳转”，不要先顺序读完整套。
 - 只有刻意系统学习时，才按下面的“推荐读法”顺序进入。
 - 当前这套正式语法手册不再只覆盖主线入门，而是负责完整吸收旧 8 个语言章节。
 
+## Agent 判断流程
+
+1. 先识别用户是否已经给出 `.tsl` / `.tsf` 后缀；给出后缀时，后缀就是判断依据。
+2. 未给后缀时，再按交付目标判断：可执行代码对应 `.tsl`，通用模块对应 `.tsf`；仍不明确时向用户确认。
+3. 如果是 `.tsl`，按可执行脚本处理：先写语句区，语句按顺序执行；需要函数/类时，把声明区放在语句区之后。
+4. 如果是 `.tsf`，按模块/函数扩展处理：生成可部署到解释器 `funcext` 的声明；部署后脚本可以直接调用暴露的顶层函数。
+5. 再识别关键词属于值/变量、函数、类、unit、表达式、控制流、运行时、TS-SQL 或其他专题。
+6. 只进入关键词命中的最小页面；写代码前优先复制已验证可执行示例的结构，不要从多个页面拼接未经验证的新骨架。
+7. 遇到反例、解释器差异或资料冲突时，先按 [12_pitfalls.md](12_pitfalls.md) 和对应专题页收口；仍无结论时不要发明语法。
+
 ## 如果你马上要写 TSL
 
 1. [02_quickstart.md](02_quickstart.md)（先看语言核心事实速查和最短骨架）