cshandClaude Fable 5
59fe4eb83d
新增 --map 模式，扫描 24 页「本篇职责」段实时生成 TSL 概念地图， 帮助从零写代码时把自然语言需求映射到该查的 TSL 概念（property、 unit、operator 重载等），随后仍用 --query 取精确语法。地图从 references 实时生成，零漂移；--check 增加护栏，职责段被清空即报错。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
69 lines
3.7 KiB
Markdown
69 lines
3.7 KiB
Markdown
---
|
|
name: tsl-syntax-reference
|
|
description: 当需要编写、修改、审查或解释 TSL/TSF 代码，或排查语法错误并核对语言与运行时规则时使用。
|
|
---
|
|
|
|
# TSL Syntax Reference
|
|
|
|
## 唯一检索入口
|
|
|
|
本 Skill 只通过随附的 `scripts/lookup.py` 检索权威 TSL/TSF 语法事实，不手工选择或顺序通读 `references/` 页面。`<this-skill-dir>` 指本 `SKILL.md` 所在目录。根据任务意图选择模式，并用用户的原始术语、错误文本和关键语法词组成查询：
|
|
|
|
```bash
|
|
python <this-skill-dir>/scripts/lookup.py --query "命名参数 默认参数" --mode write
|
|
python <this-skill-dir>/scripts/lookup.py --query "invalid statement 声明区" --mode diagnose
|
|
python <this-skill-dir>/scripts/lookup.py --query "数组下标" --mode explain
|
|
```
|
|
|
|
- `write`：编写或修改代码。
|
|
- `diagnose`：定位语法错误或错误写法。
|
|
- `explain`：解释语言规则或代码含义。
|
|
|
|
以 lookup 返回的章节作为本次任务的事实来源；需要补充时改进查询词并再次检索，不得绕过 lookup 手工路由。需要复取输出中列出的某个章节时，用 `--section <Section ID>` 单独取回。
|
|
|
|
## 从零起手先看概念地图
|
|
|
|
面对自然语言需求、还不确定该往哪个 TSL 概念上想时（尤其从零编写、周围无参考代码），先运行：
|
|
|
|
```bash
|
|
python <this-skill-dir>/scripts/lookup.py --map
|
|
```
|
|
|
|
它列出全部专题的职责摘要，用于把需求映射到 TSL 特有概念（如 `property`、`unit`、`operator` 重载、原生矩阵运算、命名参数、`with` 环境等，这些在别的语言里未必存在或写法不同）。地图只负责提示该查什么概念，不含语法细节；选定概念后仍用 `--query` 取精确语法。不要把地图当成可照写来源。
|
|
|
|
## 事实边界
|
|
|
|
本 Skill 只拥有 TSL/TSF 的语言语法、文件模型、表达式、控制流、对象、运行时语言结构和 TS-SQL 外形。其他事实交给对应所有者：
|
|
|
|
- API 名称、签名、参数、返回值和金融取数事实：使用 `tsl-api-reference` skill。
|
|
- 命名、代码风格、工具链和模块集成：使用目标仓库相应文档、脚本或 CI。
|
|
- 项目路径、数据结构、部署方式和运行参数：只使用目标项目的真实文档与配置。
|
|
|
|
不要把外部领域事实复制或猜测进本 Skill。
|
|
|
|
## 代码块身份
|
|
|
|
生成或判断代码时，必须遵守 lookup 结果中紧邻代码围栏的身份。只允许以下五种身份：
|
|
|
|
- `可直接照写示例`：可作为源码外形，但仍需按当前任务替换业务内容。
|
|
- `反例 / 不可照写`：只用于识别错误边界，不得复制为实现。
|
|
- `输出片段`：只表示结果，不得当作源码。
|
|
- `配置片段 / 概念骨架`：只表达结构或配置意图，不得假定为可直接运行代码。
|
|
- `仅服务端可执行示例`：只在相应服务端运行环境中成立，不得当作通用本地可执行示例。
|
|
|
|
## 缺口时停止
|
|
|
|
lookup 无匹配或返回非零状态、结果没有支持当前结论、代码块身份缺失或冲突、运行时版本不明、项目事实缺失、依赖的 Skill 不可用时，明确说明缺失项并停止。不得改为手工浏览全部参考页，也不得凭经验、相似语言或猜测产生新的 TSL 写法。
|
|
|
|
## 执行 TSL 前读取项目指引
|
|
|
|
需要实际执行 TSL 时，先读取目标文件附近最近的 `AGENTS.md`，完成平台检测并严格使用其中指定的解释器环境。不同平台或多个 Windows 环境不得混用、默认任选或自行回退。
|
|
|
|
## 维护校验
|
|
|
|
维护本 Skill、参考页或 lookup 实现后必须运行：
|
|
|
|
```bash
|
|
python <this-skill-dir>/scripts/lookup.py --check
|
|
```
|