playbook/AGENTS.md

TSL Agent Instructions

本文件只保留 TSL 多领域首跳路由、优先级、事实边界和阻断条件，不保存具体语法实现。

范围与优先级

• 更靠近目标代码的规则可以更严格，但不能削弱事实所有者给出的约束。
• 用户明确要求优先；与仓库真实项目事实冲突时，先报告冲突并停止相关生成。
• 只读取命中任务所需的事实所有者，不顺序通读全部文档，也不跨领域复制事实。

文档首跳

• 命名偏好：读取 docs/tsl/naming.md。
• 代码风格：读取 docs/tsl/code_style.md。
• 验证命令和工具链：读取 docs/tsl/toolchain.md、项目脚本或 CI。
• Python 调 TSL、回测和通知等模块集成：读取 docs/tsl/modules/index.md。
• 路径、数据结构、部署、运行参数和环境约束等项目事实：只读取目标项目的真实文档、配置和最近的 AGENTS.md。

事实边界

• 语法 Skill 不拥有 API、命名、风格、工具链、模块或项目事实。
• API Skill 不拥有语言语法、项目部署或模块集成事实。
• 命名和风格文档只表达仓库偏好，不得替代语法事实。
• 项目事实优先于通用示例；示例不得反推不存在的项目能力。

Fail closed

• tsl-syntax-reference 缺失或不可用时，停止生成或修改 TSL/TSF 代码，不凭相似语言补全语法。
• tsl-api-reference 缺失或不可用时，停止猜测函数名、签名、参数和返回值。
• 工具链、模块或项目事实缺失时，停止相关执行与集成判断，并明确报告缺失项。