♻️ refactor(tsl): decouple skill routing from static docs
删除静态文档中对 tsl-syntax-reference / tsl-api-reference 的导航路由， 改由运行时按需自动触发；语法/API 事实的所有权与 fail-closed 约束 只保留在 rulesets/tsl/index.md 这一唯一权威载体。 - docs/tsl/index.md：删 4 行 skill 路由及重复的所有权/fail-closed 段，回归纯分流 - docs/tsl/modules/index.md：删 API 路由及指向已删 syntax 的 3 处回跳 - docs/index.md：删 skill 导航行及 2 条指向不存在文件的死 catalog 链 - docs/tsl/syntax/index.md：删除旧路径兼容 stub，不再保留任何兼容 - rulesets/tsl/index.md：删首跳 2 条 skill 导航，保留事实边界与 Fail closed - 同步修正相关测试断言 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Claude Fable 5
@@ -8,9 +8,5 @@
|
||||
|
||||
| 任务信号 | 入口 | 阻断条件 |
|
||||
| ---------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------- |
|
||||
| 要生成或编写 TSL 代码、先定文件模型与起手骨架 | [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) | 不写代码，只查语法、函数或命名事实 |
|
||||
| 查语法写法、语言规则、排查语法错误 | [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) | 要找的是函数，不是语法 |
|
||||
| 取金融数据：行情、财务、板块、选股 | 使用 [tsl-api-reference Skill](../../skills/tsl-api-reference/SKILL.md) | 不是取数，是语法或语言规则 |
|
||||
| 查 API/函数的名字、参数、返回值 | 使用 [tsl-api-reference Skill](../../skills/tsl-api-reference/SKILL.md) | 要查的是语法，不是 API 事实 |
|
||||
| 命名与代码风格：变量、函数、类型、文件取名，注释与代码组织 | 取名看 [naming.md](naming.md)；注释与组织看 [code_style.md](code_style.md) | 要查的是语法或函数事实 |
|
||||
| 具体模块能力：Python 调 TSL、策略回测、微信通知/告警 | [modules/index.md](modules/index.md) | 只是纯语法或普通取数 |
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
# 模块入口
|
||||
|
||||
遇到不确定时：[pytsl_api.md](pytsl_api.md)、[tsbacktesting.md](tsbacktesting.md)、[wechat_message.md](wechat_message.md)、`tsl-api-reference`、项目自身文档、`scripts/*` 入口脚本、CI 配置
|
||||
遇到不确定时：[pytsl_api.md](pytsl_api.md)、[tsbacktesting.md](tsbacktesting.md)、[wechat_message.md](wechat_message.md)、项目自身文档、`scripts/*` 入口脚本、CI 配置
|
||||
|
||||
本页只负责把“现成模块、外部集成和模块 API”任务路由到正确事实页。目标页是模块 API 事实页时，智能体可以继续使用该页的签名、参数表、返回值和代码骨架；本页自身不生成代码。
|
||||
|
||||
金融函数与通用函数库的名称、签名、参数和返回值由 `tsl-api-reference` skill 唯一拥有、按需自动触发，本页不再为其提供路由入口。
|
||||
|
||||
## 智能体模块路由规则
|
||||
|
||||
- 先判断任务是否属于模块 API、业务流程、通用语法、通用函数库或项目执行上下文。
|
||||
@@ -19,9 +21,6 @@
|
||||
| 2 | 用 Python 执行 TSL、调用服务器 TSL 函数、查行情、批量取数、异步取数 | [pytsl_api.md](pytsl_api.md) | 使用 pyTSL 类、函数、参数和返回结构 |
|
||||
| 3 | 发送微信通知、微信告警、微信模板消息、查询微信消息发送状态 | [wechat_message.md](wechat_message.md) | 使用微信消息接口、模板字段和展示规则 |
|
||||
| 4 | 写策略回测框架、组合回测、读取回测资产/持仓/交易/绩效结果 | [tsbacktesting.md](tsbacktesting.md) | 使用 `TSBackTesting` 对象模型、成员变量和查询接口 |
|
||||
| 5 | 查询行情、财务、板块、选股等金融函数 | 使用 `tsl-api-reference` skill 关键词查 API | 使用数据仓库函数事实 |
|
||||
| 6 | 询问 TSL 语言语法怎么写 | [../syntax/index.md](../syntax/index.md) | 回到语法主线 |
|
||||
| 7 | 查询通用函数库函数签名、参数或返回值 | 使用 `tsl-api-reference` skill：已知名走 `--name`，未知名走 `--kw` | 回到 API reference 检索 |
|
||||
|
||||
## 模块页职责
|
||||
|
||||
@@ -33,7 +32,7 @@
|
||||
|
||||
## 冲突处理
|
||||
|
||||
- Python 执行一段 TSL 或调用服务器函数时，先读 [pytsl_api.md](pytsl_api.md)；TSL 代码本身再按 [../syntax/index.md](../syntax/index.md) 或 `tsl-api-reference` 补充。
|
||||
- Python 执行一段 TSL 或调用服务器函数时，先读 [pytsl_api.md](pytsl_api.md)；TSL 语法由 `tsl-syntax-reference` skill 唯一拥有、按需自动触发。
|
||||
- Python 调用回测脚本时，先读 [pytsl_api.md](pytsl_api.md) 确认执行方式，再读 [tsbacktesting.md](tsbacktesting.md) 确认回测框架写法。
|
||||
- 回测框架、交易字段和结果接口优先读 [tsbacktesting.md](tsbacktesting.md)；策略信号、证券池、费用口径等项目事实必须来自用户需求或项目实际接口。
|
||||
- 微信通知内容来自业务结果时，先用业务页确定内容，再用 [wechat_message.md](wechat_message.md) 组织模板字段。
|
||||
@@ -46,7 +45,4 @@
|
||||
| 我要用 Python 调 TSL / 查行情 / 批量取数 | [pytsl_api.md](pytsl_api.md) |
|
||||
| 我要发微信通知 / 告警 / 查询状态 | [wechat_message.md](wechat_message.md) |
|
||||
| 我要写 `TSBackTesting` 回测框架 | [tsbacktesting.md](tsbacktesting.md) |
|
||||
| 我要查行情 / 财务 / 板块 / 选股函数 | 使用 `tsl-api-reference` skill |
|
||||
| 我要确认 TSL 语法 | [../syntax/index.md](../syntax/index.md) |
|
||||
| 我要查通用函数库 | 使用 `tsl-api-reference` skill |
|
||||
| 我要确认真实账号 / 服务地址 / 部署入口 / 脚本入口 | 项目自身文档、`scripts/*`、CI 配置 |
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
# TSL 语法入口已迁移
|
||||
|
||||
TSL/TSF 语法事实现由仓库内唯一事实源 [tsl-syntax-reference Skill](../../../skills/tsl-syntax-reference/SKILL.md) 管理。
|
||||
|
||||
本页仅为旧路径兼容入口，不保存语法规则或专题路由。独立部署时请安装 `tsl-syntax-reference` 后再处理 TSL/TSF 语法任务。
|
||||
Reference in New Issue
Block a user