✨ feat(skills): add tsl syntax reference skill
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
是否可直接用于生成代码:仅部分
|
||||
是否含可直接照写示例:否
|
||||
是否含不可照写反例:否
|
||||
遇到不确定时:风格/命名看 [naming.md](naming.md);语法事实看 [syntax/index.md](syntax/index.md);验证命令或自动化入口只看项目脚本、CI,或目标项目已真实填写且没有 `<...>` 占位符的 [toolchain.md](toolchain.md)
|
||||
遇到不确定时:风格/命名看 [naming.md](naming.md);语法事实使用 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md);验证命令或自动化入口只看项目脚本、CI,或目标项目已真实填写且没有 `<...>` 占位符的 [toolchain.md](toolchain.md)
|
||||
|
||||
本页记录本仓库代码风格偏好,不代表 TSL 语法事实。
|
||||
|
||||
@@ -22,14 +22,14 @@
|
||||
### 1.1 单一职责
|
||||
|
||||
- 一个文件只做一件事;职责明确。
|
||||
- 文件模型和顶层声明规则以 `docs/tsl/syntax/02_core_model.md` 为准;本页只规定组织偏好。
|
||||
- 文件模型和顶层声明规则由 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) 管理;本页只规定组织偏好。
|
||||
- 可复用逻辑优先集中到可复用声明文件;入口/编排层只保留必要流程。
|
||||
- 当一个顶层声明同时承担“协议适配 + 业务计算 +
|
||||
I/O/环境依赖 + 临时代码”时,优先拆分边界:核心纯逻辑 → 工具函数 → 边界适配(I/O)。
|
||||
|
||||
### 1.2 文件名与顶层声明
|
||||
|
||||
- 文件模型和顶层声明规则以 `docs/tsl/syntax/02_core_model.md` 为准;文件和实体如何命名见
|
||||
- 文件模型和顶层声明规则由 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) 管理;文件和实体如何命名见
|
||||
`docs/tsl/naming.md`。
|
||||
- 文件名不强制表达完整职责,但应清晰可检索。
|
||||
- 推荐文件名使用 `PascalCase` 以提升检索与协作一致性;扩展名按类型使用
|
||||
@@ -91,7 +91,7 @@ end
|
||||
- 多语句分支使用 `begin/end` 包裹:在 `then/else` 后换行写 `begin`,`end`
|
||||
单独成行。
|
||||
- `else/elseif` 等分支关键字另起一行,与上一块的 `end` 对齐。
|
||||
- 控制流块(`if`/`while`/`for`/`case`/`try` 等)的 `end` 后不加分号;顶层声明(函数/过程/类/`unit`)的 `end` 后加分号(这是语法要求,见 `syntax/05_functions_and_calls.md` 和 `syntax/09_units_and_scope.md`)。
|
||||
- 控制流块与顶层声明的分号规则属于语法事实,使用 [tsl-syntax-reference Skill](../../skills/tsl-syntax-reference/SKILL.md) 核对;本页只规定风格偏好。
|
||||
- 单语句分支可省略 `begin/end`(保持清晰优先;一旦分支变复杂就回退到块结构):
|
||||
|
||||
代码块身份:配置片段 / 概念骨架
|
||||
|
||||
Reference in New Issue
Block a user