🐛 fix(sync_standards): preserve project gitattributes and clarify tsl/tsf

- default to managed .gitattributes block (block/overwrite/skip)

- ensure .agents/tsl points to docs/standards/tsl snapshot paths

- document expected structure and TSL/TSF constraints
This commit is contained in:
csh
2025-12-13 19:15:55 +08:00
parent 88f0842134
commit c4efd8f274
9 changed files with 282 additions and 46 deletions
+1 -1
View File
@@ -5,7 +5,7 @@
## 1. 文件与组织
- 一个文件只做一件事;职责明确。
- 文件名使用 `PascalCase`,并与文件内唯一的顶层声明同名(语法要求)。扩展名按类型使用 `.tsl`/`.tsf`
- 文件名使用 `PascalCase`,并与文件内唯一的顶层声明同名(语法要求)。扩展名按类型使用 `.tsl`/`.tsf`(两者都属于 TSL 源文件,风格规则一致)
- 避免循环依赖;公共能力下沉到可复用模块。
- 同类代码按“对外 API → 核心实现 → 辅助工具 → 测试/示例”的顺序组织。
+1
View File
@@ -40,6 +40,7 @@ TSL 的语法要求:每个文件只能有一个顶层声明,且**文件基
- 顶层声明可能是 `class``unit``function`(见类型命名)。
- `.tsl` 脚本文件:顶层声明只能是 `function`,因此文件基名 = 顶层函数名。
- `.tsf` 代码文件:顶层声明可为 `class`/`unit`/`function`,文件基名需与之同名。
- 注:`.tsf` 也是 TSL 源文件,命名/风格与 `.tsl` 遵循同一套规则。
命名建议: