📝 docs(tsl): align agent-facing guidance
This commit is contained in:
@@ -22,8 +22,8 @@
|
||||
### 1.1 单一职责
|
||||
|
||||
- 一个文件只做一件事;职责明确。
|
||||
- `.tsl` 建议作为“入口/编排层”:聚合参数/配置、串起流程;可复用逻辑下沉到
|
||||
`.tsf`(`unit`/`class`/`function`)中。
|
||||
- `.tsl` 作为可执行脚本:语句区在前并按顺序执行;需要本文件函数/类时,声明区放在语句区之后。
|
||||
- `.tsf` 作为模块/函数扩展文件:可复用逻辑下沉到 `.tsf`,部署到解释器 `funcext` 后供脚本调用。
|
||||
- 当一个顶层声明同时承担“协议适配 + 业务计算 +
|
||||
I/O/环境依赖 + 临时代码”时,优先拆分边界:核心纯逻辑 → 工具函数 → 边界适配(I/O)。
|
||||
|
||||
@@ -32,6 +32,7 @@
|
||||
- TSL 语法要求(仅 `.tsf`):每个 `.tsf`
|
||||
文件只能有一个顶层声明,且文件基名必须与顶层声明同名。
|
||||
- `.tsl` 允许直接写语句,不要求顶层声明;文件名不强制,但建议清晰可检索。
|
||||
- `.tsl` 中如果同时需要脚本语句和函数/类声明,先写语句区,再写声明区;不要在声明区后继续追加脚本语句。
|
||||
- 推荐文件名使用 `PascalCase` 以提升检索与协作一致性;扩展名按类型使用
|
||||
`.tsl`/`.tsf`(两者都属于 TSL 源文件,风格规则一致)。
|
||||
- 详细约束与命名细则见 `docs/tsl/naming.md`。
|
||||
|
||||
Reference in New Issue
Block a user