📦 deps(standards): vendor playbook

2025-12-14 17:55:55 +08:00
parent e75027b80a eada742d75
commit dbdde4ed48
49 changed files with 2756 additions and 0 deletions
@@ -0,0 +1,32 @@
+# 代码质量（Code Quality）
+
+本文件定义代理对代码质量的最低要求与审查清单（TSL）。
+
+## 1. 总体要求
+
+- 对 `.tsl`/`.tsf` 文件一律按 TSL 规范处理（`.tsf` 也是 TSL 源文件）：遵守标准快照中的 `docs/tsl/code_style.md` 与 `docs/tsl/naming.md`（在目标项目中通常 vendoring 到 `docs/standards/playbook/docs/tsl/`）。
+- 改动聚焦目标；避免“顺手重构”。
+- API 变更要显式说明影响与迁移方式。
+
+## 2. 可读性
+
+- 复杂逻辑拆分为具名函数/变量。
+- 避免深层嵌套与重复代码。
+- 必要注释解释“为什么”而不是“做什么”。
+
+## 3. 错误处理
+
+- 错误必须显式处理；禁止静默吞错。
+- 失败路径要可观测（返回/抛出/日志）。
+
+## 4. 复杂度与规模
+
+- 单函数尽量 ≤ 60 行；超过应说明原因或拆分。
+- 单次 PR 尽量小步提交，便于 review。
+
+## 5. Review 清单
+
+- 是否有无关改动？
+- 是否有清晰的动机与行为说明？
+- 是否保持模块内风格一致？
+- 是否需要补测试/示例？