✨ feat(skills): add tsl syntax reference skill

rulesets/tsl/index.md

@@ -1,30 +1,32 @@
 # TSL 智能体规则
 
-本文件不是语法手册，只放硬约束、首跳路由和阻断条件。
+本文件只保留 TSL 多领域首跳路由、优先级、事实边界和阻断条件，不保存具体语法实现。
 
-- 更靠近代码目录的规则可以更严格，但不能削弱文档事实和禁止发明语法规则。
-- TSL 事实以 `docs/tsl/**`、项目自身文档和块级 `代码块身份` 为准；本文件不复写完整语法。
-- 用户明确指令不能覆盖文档事实使用规则或禁止发明语法规则。
+## 范围与优先级
 
-## 代码生成协议
-
-- 生成或修改代码前先判断交付目标与 `.tsl` / `.tsf` 文件模型；文件模型影响正确性且需求不明时先确认。
-- 禁止凭 Pascal、Python、JavaScript、TypeScript 或其他语言的相似写法补全 TSL 语法。
-- 无文档结论、文件模型不明或项目执行事实缺失时停止，不发明语法。
-
-## TSL 核心事实
-
-- `.tsl` / `.tsf` 后缀由用户指定时，后缀优先。
-- 未指定后缀时：入口流程、脚本任务或一次性任务初判 `.tsl`；可复用函数、过程、类、模块或扩展初判 `.tsf`。
-- `.tsl` 代码需要本文件内函数或类时，先写可执行语句区，再写声明区；声明区后不要继续追加脚本语句。
-- `.tsf` 只按可复用顶层声明或 `unit` 组织，不写顺序执行入口。
-- 对象创建、函数调用、`unit`、运行时上下文、TS-SQL 和矩阵等细节只从对应专题页取事实。
+- 更靠近目标代码的规则可以更严格，但不能削弱事实所有者给出的约束。
+- 用户明确要求优先；与仓库真实项目事实冲突时，先报告冲突并停止相关生成。
+- 只读取命中任务所需的事实所有者，不顺序通读全部文档，也不跨领域复制事实。
 
 ## 文档首跳
 
-- 需要任何 TSL 语法、文件模型、函数、模块或金融数据事实时，第一跳统一进 `docs/tsl/index.md`，由它路由到具体页；不在本文件内猜文件路径，也不全目录搜索。
+- TSL/TSF 语法、文件模型、语言规则、代码编写/修改/审查/解释和语法错误：使用 `tsl-syntax-reference` skill。
+- API/函数名称、签名、参数、返回值和金融取数：使用 `tsl-api-reference` skill。
+- 命名偏好：读取 `docs/tsl/naming.md`。
+- 代码风格：读取 `docs/tsl/code_style.md`。
+- 验证命令和工具链：读取 `docs/tsl/toolchain.md`、项目脚本或 CI。
+- Python 调 TSL、回测和通知等模块集成：读取 `docs/tsl/modules/index.md`。
+- 路径、数据结构、部署、运行参数和环境约束等项目事实：只读取目标项目的真实文档、配置和最近的 `AGENTS.md`。
 
-## 文档事实使用策略
+## 事实边界
 
-- 页面级元数据只做粗判断；生成代码时以块级 `代码块身份` 为准：只有 `可直接照写示例` 能当源码外形，`反例 / 不可照写`、`输出片段`、`配置片段 / 概念骨架` 不得照抄。
-- `code_style.md` 与 `naming.md` 只表达风格偏好，不代表 TSL 语法事实。
+- 语法 Skill 不拥有 API、命名、风格、工具链、模块或项目事实。
+- API Skill 不拥有语言语法、项目部署或模块集成事实。
+- 命名和风格文档只表达仓库偏好，不得替代语法事实。
+- 项目事实优先于通用示例；示例不得反推不存在的项目能力。
+
+## Fail closed
+
+- `tsl-syntax-reference` 缺失或不可用时，停止生成或修改 TSL/TSF 代码，不凭相似语言补全语法。
+- `tsl-api-reference` 缺失或不可用时，停止猜测函数名、签名、参数和返回值。
+- 工具链、模块或项目事实缺失时，停止相关执行与集成判断，并明确报告缺失项。