45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# TSL 代理规则集
|
||
|
||
本规则集定义 AI/自动化代理在处理 TSL 代码时必须遵守的核心约束。
|
||
|
||
## 范围与优先级
|
||
|
||
- 作为仓库级基线规则集使用；更靠近代码目录的规则更具体并可覆盖基线。
|
||
- 当代理规则与 docs 冲突：安全/合规优先，其次保持仓库一致性。
|
||
|
||
## 代理工作原则（铁律）
|
||
|
||
1. 先理解目标与上下文，再动手改代码
|
||
2. 修改要小而清晰；避免无关重构
|
||
3. 发现安全问题（明文密钥/鉴权漏洞）立即标注或修复
|
||
4. 不引入新依赖或工具，除非明确要求
|
||
|
||
## TSL 核心约定（不可违反）
|
||
|
||
- 文件结构：一文件一顶层声明；文件名 = 声明名；`.tsl` 仅 `function`，`.tsf` 可 `function/class/unit`
|
||
- 格式：4 空格缩进；关键字小写；多语句用 `begin/end`
|
||
- 命名：类型/函数/property `PascalCase`；变量/参数 `snake_case`；私有 `snake_case_`；常量 `kPascalCase`
|
||
|
||
## 安全红线（不可触碰）
|
||
|
||
- 不得在代码/日志/注释中写入明文密钥、密码、Token、API Key
|
||
- 修改鉴权/权限逻辑必须说明动机与风险
|
||
- 不确定是否敏感时按敏感信息处理
|
||
|
||
## 权威来源
|
||
|
||
- 语法手册：`docs/standards/playbook/docs/tsl/syntax_book/index.md`
|
||
- 函数库：`docs/standards/playbook/docs/tsl/syntax_book/function/`（按需检索，禁止整份加载）
|
||
- 代码风格：`docs/standards/playbook/docs/tsl/code_style.md`
|
||
- 命名规范：`docs/standards/playbook/docs/tsl/naming.md`
|
||
|
||
## Skills（按需加载）
|
||
|
||
- `$tsl-guide`
|
||
- `$commit-message`
|
||
|
||
## 与开发规范的关系
|
||
|
||
- 本仓库内：`docs/standards/playbook/docs/tsl/` 与 `docs/standards/playbook/docs/common/`
|
||
- 目标项目 subtree：`docs/standards/playbook/docs/tsl/` 与 `docs/standards/playbook/docs/common/`
|