| 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 搜索。