---
name: tb-syntax
description: Use when explaining or writing TBQ3 language syntax, including Params, Vars, Events, data types, variables, sequence variables, arrays, Map variables, control flow, operators, assignment, functions, and formula execution rules.
---

# TBQ3 语法基础

本 skill 只提供写 TB 代码所需的最小语法规则。详细文档入口见 `references/syntax-map.md`。

## 代码组织

- 常见结构为 `Params`、`Vars`、`Events`。
- 参数用于可配置输入，变量用于公式内部状态。
- 事件函数放在 `Events` 下，Bar 策略通常至少包含 `OnBar(ArrayRef<Integer> indexs)`。

## 命名和注释

- 变量、参数、函数名使用简短英文业务名。
- 给用户生成的 TB 代码注释使用中文，简明说明交易意图或关键边界。
- 不确定语法时，先查 `docs/TB语言基础` 或函数文档，不要发明语法。

## 常用类型

- 数值：`Numeric`
- 整数：`Integer`
- 布尔：`Bool`
- 字符串：`String`
- 数组引用常见于事件参数：`ArrayRef<Integer>`

## 控制结构

- 条件判断使用 `If(...) { ... } Else If(...) { ... } Else { ... }`。
- 循环和复杂容器用法应查对应文档后再写，避免凭通用 C++ 习惯生成错误语法。

## 序列和历史引用

- Bar 序列常见历史引用形式如 `High[1]`、`Low[1]`。
- 当前 Bar 和历史 Bar 在回测/实时中的语义不同；交易策略中涉及触发时机时，应结合 `tb-bar-strategy`。

## 查证规则

- 变量、参数、控制结构：读 `references/syntax-map.md` 后打开对应原文。
- 函数名或返回值不确定：使用 `tb-doc-index` 的函数索引或 `rg` 搜索。