✨ feat(skills): add tsl syntax reference skill

README.md

@@ -15,7 +15,7 @@ Playbook：工程规范与智能体规则合集，当前覆盖：
 
 - `docs/index.md`：文档导航入口
 - `docs/common/`：跨语言规范（提交信息、版本号）
-- `docs/tsl/`：TSL 规范（语法手册、金融业务、模块、函数检索、代码风格、命名、工具链）
+- `docs/tsl/`：TSL 静态路由、金融业务、模块、函数检索、代码风格、命名和工具链；语法事实由 `tsl-syntax-reference` 管理
 - `docs/cpp/`：C++ 规范（C++23/Modules、Google 基线、Conan、clangd）
 - `docs/python/`：Python 规范（Google 基线、black/isort/flake8/pylint/mypy/pytest）
 - `docs/typescript/`：TypeScript 规范（Google 基线、prettier/eslint/vitest）
@@ -84,30 +84,34 @@ project_name = "MyProject"
 
 ```txt
 Layer 1: rulesets/          (≤50 行/语言，模板源)
-  ├─ 语言特有的核心约束
+  ├─ 语言核心约束或事实所有者路由
   └─ 指向 Skills 和 docs
 
 Layer 2: skills/           (按需加载，$skill-name 触发)
   ├─ commit-message: 提交信息规范
   ├─ style-cleanup: 代码风格整理
+  ├─ tsl-syntax-reference: TSL 语法条目、写法验证和错误边界
+  ├─ tsl-api-reference: TSL API 名称、签名、参数和返回值
   └─ thirdparty/: 第三方同步 skills
 
-Layer 3: docs/             (权威静态文档)
-  └─ 完整语法手册/代码风格/工具链配置
+Layer 3: docs/             (仓库内静态文档)
+  └─ 静态规范/代码风格/工具链/模块与集成文档
 ```
 
 **各层职责**：
 
-| 层级    | 加载方式                       | 内容                           | 作用                       |
-| ------- | ------------------------------ | ------------------------------ | -------------------------- |
-| Layer 1 | 自动，始终在上下文             | 语言特有的核心约束             | 快速判断能做/不能做        |
-| Layer 2 | `$<skill-name>` 触发或智能体判定 | 操作指南、最佳实践、工作流     | 指导具体怎么做             |
-| Layer 3 | 按需读取特定章节               | 完整语言手册、代码风格、工具链 | 最终权威（冲突时以此为准） |
+| 层级    | 加载方式                         | 内容                                   | 作用                                  |
+| ------- | -------------------------------- | -------------------------------------- | ------------------------------------- |
+| Layer 1 | 自动，始终在上下文               | 核心约束、优先级、所有者路由和阻断规则 | 快速定位事实所有者并判断能做/不能做   |
+| Layer 2 | `$<skill-name>` 触发或智能体判定 | 操作指南、工作流和可安装参考知识       | 执行任务或查询 Skill 所拥有的事实     |
+| Layer 3 | 按需读取特定章节                 | 静态规范、代码风格、工具链和模块文档   | 管理仓库内静态事实，不覆盖 Skill 事实 |
+
+TSL 语法事实唯一由 `tsl-syntax-reference` 管理；`rulesets/tsl/index.md` 和 `docs/tsl/` 只负责路由、边界及各自拥有的非语法事实。
 
 **目录结构**：
 
 - `rulesets/index.md`：规则集索引（跨语言）
-- `rulesets/tsl/index.md`：TSL 核心约定（45 行）
+- `rulesets/tsl/index.md`：TSL 领域路由与事实边界
 - `rulesets/cpp/index.md`：C++ 核心约定（46 行）
 - `rulesets/python/index.md`：Python 核心约定（44 行）
 - `rulesets/typescript/index.md`：TypeScript 核心约定（47 行）
@@ -119,8 +123,8 @@ Layer 3: docs/             (权威静态文档)
 
 **.agents/（Layer 1）修改规则**：
 
-- 可做：更新核心约定、添加语言特有的硬性约束(命名/语法/工具链)
-- 不可做：添加推荐型最佳实践（→ skill）、详细语法解释（→ skill/docs）、超过 50 行（→ 拆分）
+- 可做：更新核心约定或事实所有者路由、添加语言特有的项目级硬性边界
+- 不可做：添加推荐型最佳实践（→ skill）、复制其他事实所有者的详细内容、超过 50 行（→ 拆分）
 
 **Skills（Layer 2）创建规则**：
 
@@ -130,6 +134,17 @@ Layer 3: docs/             (权威静态文档)
 
 本仓库内置 AI agent skills，支持 Codex CLI 和 Claude Code，用于按需加载的工作流与知识库。
 
+TSL 完整能力需要同时安装 `tsl-syntax-reference` 与 `tsl-api-reference`：
+
+```toml
+[install_skills]
+agents_home = "~/.agents"
+mode = "list"
+skills = ["tsl-syntax-reference", "tsl-api-reference"]
+```
+
+`[sync_standards]` 只部署规则集和文档，不会自动安装 Skill；Skill 安装由 `[install_skills]` 显式配置。
+
 安装与使用详见 [SKILLS.md](SKILLS.md)。
 
 ## 在其他项目中使用本 Playbook
@@ -236,8 +251,8 @@ Layer 3: docs/             (权威静态文档)
 
 本仓库提供多套智能体规则集（同步后位于目标项目的 `.agents/tsl/` / `.agents/cpp/` / `.agents/python/` / `.agents/typescript/` / `.agents/markdown/`）：
 
-- 各规则集都包含语言特有的核心约定
-- 并在 `index.md` 中叠加语言级"硬约束"（TSL/TSF 语法限制、C++23/Modules、Python 风格、TypeScript 类型约束、Markdown 代码格式化等）
+- 各规则集包含语言核心约定或事实所有者路由
+- 并在 `index.md` 中叠加语言级硬约束或阻断边界（TSL 使用语法/API 双 Skill 路由与 fail-closed；其他语言保留各自的版本、风格、类型或格式约束）
 
 **多语言项目推荐结构**（示例：TSL + C++ + Python + TypeScript + Markdown）：