📝 docs(tsl): align agent-facing guidance

2026-05-28 19:12:34 +08:00
parent c48354e0cb
commit d8eb418277
63 changed files with 1921 additions and 371 deletions
@@ -2,12 +2,17 @@

 文档类型：业务骨架
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：项目实际接口定义、[../modules/tsbacktesting.md](../modules/tsbacktesting.md)、[selection_and_signal_patterns.md](selection_and_signal_patterns.md)、[../syntax/index.md](../syntax/index.md)

 这一篇收拢回测、组合、交易与结果读取流程。

+## Agent 回测/交易判断规则
+
+- 先判断比例类组合还是数量类组合，再看交易输入和结果读取。
+- 本页只给业务流程骨架，不给对象 API 真值。
+- 对象创建方式、交易数据入口、结果接口和项目封装必须回项目实际接口定义。
+- 不要发明项目实际接口、回测对象创建方式、交易入口或结果读取调用链。
+
 ## 这一篇解决什么问题

 回答“回测对象如何组织、交易流程如何设置、结果怎样取出和解释”。
@@ -2,12 +2,16 @@

 文档类型：检索页
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[market_data_context.md](market_data_context.md)、[../syntax/index.md](../syntax/index.md)、[../reference/index.md](../reference/index.md)

 这里是金融层的入口决策页，不是代码页。它只解决“业务任务该往哪一层跳”，不重新定义语言基础语法。

+## Agent Finance Entry 判断规则
+
+- 先判断任务属于市场数据、序列指标、选股信号还是回测交易。
+- finance 只给业务组织方式；代码细节必须回 syntax、reference 或项目实际接口。
+- 不要发明项目实际接口、数据字段、函数签名或业务上下文。
+
 ## 这一篇解决什么问题

 回答“什么时候应该进入 finance 层、进入后先去哪个业务主题页，以及什么时候该回到 syntax / reference 层”。
@@ -2,12 +2,16 @@

 文档类型：检索页
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[../syntax/index.md](../syntax/index.md)（优先）、[market_data_context.md](market_data_context.md)、[../reference/index.md](../reference/index.md)

 这里是业务层入口。只讨论金融任务如何使用 TSL，不重讲基础语法。

+## Agent Finance 路由规则
+
+- 只用 finance 判断金融业务任务该怎么分层，不用 finance 重写语法规则。
+- 金融任务需要真实数据字段、回测接口或项目封装时，先回项目实际接口定义。
+- 不要发明项目实际接口、字段名、对象创建方式或函数签名。
+
 ## 先看这 5 条

 - 如果你的问题是“语言怎么写”，不要留在 finance，回到 [../syntax/index.md](../syntax/index.md)。
@@ -2,14 +2,19 @@

 文档类型：业务骨架
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[series_and_indicator_model.md](series_and_indicator_model.md)、[../syntax/index.md](../syntax/index.md)、[../modules/tsbacktesting.md](../modules/tsbacktesting.md)

 本页用于判断金融脚本运行时的数据语境，不提供独立语法模板。

 这一篇整理金融场景中的市场数据语境与执行环境。

+## Agent 市场数据判断规则
+
+- 先确认脚本运行时是否已经有市场数据上下文。
+- 只把本页用于判断业务语境，不把市场字段当成 TSL 通用语法。
+- 如果字段来源、周期、复权口径或数据入口不明确，回项目实际接口定义。
+- 不要发明项目实际接口、市场字段或默认数据上下文。
+
 ## 这一篇解决什么问题

 回答“金融脚本运行时的数据上下文是什么、哪些概念属于业务层而不是语言层”。
@@ -2,12 +2,17 @@

 文档类型：业务骨架
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[series_and_indicator_model.md](series_and_indicator_model.md)、[backtest_and_trade_flow.md](backtest_and_trade_flow.md)、[../syntax/index.md](../syntax/index.md)

 这一篇收拢选股、筛选和信号生成的业务模式。

+## Agent 选股/信号判断规则
+
+- 先确认任务输出是筛选结果、交易信号、评分排序还是回测输入。
+- 条件表达的语法回 syntax；金融任务组织留在 finance。
+- 需要真实字段、信号函数或输出接口时，回项目实际接口定义。
+- 不要发明项目实际接口、字段名、信号函数签名或输出结构。
+
 ## 这一篇解决什么问题

 回答“如何把条件表达和金融筛选任务组织成稳定的选股/信号脚本”。
@@ -2,12 +2,17 @@

 文档类型：业务骨架
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[market_data_context.md](market_data_context.md)、[selection_and_signal_patterns.md](selection_and_signal_patterns.md)、[../syntax/index.md](../syntax/index.md)

 这一篇处理金融序列与指标计算模式。

+## Agent 序列/指标判断规则
+
+- 先确认输入是单值还是逐 bar 序列。
+- 指标公式只在业务上下文里成立，不替代 syntax 的表达式规则。
+- 需要真实字段、指标函数或窗口口径时，回项目实际接口定义或 reference 参数事实页。
+- 不要发明项目实际接口、字段名、指标函数签名或历史窗口语义。
+
 ## 这一篇解决什么问题

 回答“指标、序列、逐 bar 计算和相关金融表达方式如何组织，以及 AI 应该先建立什么样的业务心智模型”。