refactor: 跟随者与勇士移动

dev.md

@@ -3,8 +3,8 @@
 ## 项目结构
 
 - `public`: mota-js 样板所在目录
-- `packages`: 核心引擎代码 monorepo
-- `packages-user`: 用户代码 monorepo
+- `packages`: 核心引擎代码 monorepo（`@motajs/`）
+- `packages-user`: 用户代码 monorepo（`@user/`）
 - `src`: 游戏入口代码
 
 依赖关系为单向：`src` → `packages-user` → `packages`。`packages` 与 `packages-user` 均可独立打包为库模式，`src` 为游戏的入口代码。
@@ -62,7 +62,7 @@
 | 代码文件名                                     | 小驼峰                                     |
 | Markdown 文档文件名                            | 连字符命名法                               |
 
-不使用下划线命名法。
+不使用下划线命名法，私有属性或方法不要以下划线开头。
 
 ### 注释规范
 
@@ -85,9 +85,10 @@
 - 未使用的变量或方法以下划线开头命名。
 - 合理使用 `readonly`、`protected`、`private` 关键字。
 - 可选参数过多时（大于两个），考虑改用对象参数。
-- 尽量避免 `as` 类型断言，除非必要。
+- 尽量避免 `as` 类型断言，除非必要。绝对不允许出现连续 `as`，例如 `as unknown as xxx`。
 - 函数类型单独开一个 `type` 类型别名，除非函数类型本身较短（小于 20 字符，且不会因为此函数类型导致换行）。
 - 当任何时候必须出现对象类型的时候，单独声明一个 `interface`，不得出现直接的对象类型。
+- 对于某个类中的对象成员，必须使用接口作为类型，不得使用类作为类型，除非某些极特殊情况。
 
 ### 其他要求
 
@@ -99,7 +100,7 @@
 - 只进行必要的非空判断，非必要时直接使用非空断言 `!`。
 - 除非参数要求传入函数等情况，不建议在函数内定义局部函数。
 - 语句尽量不换行，除非必要，尤其注意三元运算符与 `private readonly` 类成员。
-- 一般不建议写 `getter` 和 `setter`，但某些场景下还是可以使用的。
+- 一般不建议写 `getter` 和 `setter`，但在极少数场景下还是可以使用的。
 
 ## 双端分离