2.3 KiB
2.3 KiB
name, description
| name | description |
|---|---|
| no-game-references | 编写或修改 C# 代码时加载此规则：确保命名、注释、Tooltip、Header 中不出现其他游戏的专有名称（如 HK / Hollow Knight / Silksong / Ori 等）或明确引用。触发场景：新建 .cs 文件、修改已有 .cs 文件、Code Review .cs 代码是否合规。 |
代码命名与注释：禁止引用其他游戏
规则
在编写或修改任何 C# 代码时，命名（变量名、方法名、类名）、注释（//、///）、[Tooltip]、[Header] 字段标签 中均不得出现以下内容：
- 其他游戏的专有名称（如：空洞骑士、丝之歌、奥日，以及对应英文 Hollow Knight、HK、Silksong、Ori 等）
- 其他游戏中的专属机制/道具名称（如：Mothwing Cloak、Monarch Wings、暗影披风 等）
- "对齐 XX 游戏"、"仿 XX 风格"、"参考 XX"、"类比 XX"等措辞中明确出现游戏名
正确做法：描述功能特点
若某设计参考了其他游戏的机制，只描述该机制的功能特点，不写出游戏名。
| ❌ 禁止 | ✅ 替换为 |
|---|---|
// 对齐空洞骑士手感 |
// 下落比上升更快，手感紧实 |
[Header("跳跃（对齐空洞骑士手感）")] |
[Header("跳跃")] |
[Tooltip("HK ~0.12s")] |
[Tooltip("推荐 0.12s")] |
// 类比 HK Monarch Wings，随时可二段跳 |
// 上升阶段即可触发二段跳 |
// 仿丝之歌风格 Lookahead |
// 速度自适应 Lookahead：速度越快，预测距离越大 |
/// 模拟空洞骑士的标志性相机手感 |
/// 实现下落快、起跳缓的非对称相机追随手感 |
// 对齐 HK：碰到实体墙不会压墙卡住 |
// 碰到实体墙立即中止，避免压墙卡住 |
private void ApplyHKComposerDefaults(...) |
private void ApplyComposerDefaults(...) |
[Tooltip("对齐空洞骑士 = 1 格血")] |
[Tooltip("建议设为 1，确保任意触碰即扣一格血量")] |
允许保留的通用术语
以下术语为业界通用设计词汇，不视为游戏专名，可正常使用：
Pogo/pogo（踩踏弹跳，通用机制术语）Charm（可收集护符，本项目自有道具类型）platformer、横版平台游戏（泛指游戏类型）Metroidvania（泛指游戏类型）手感、风格（描述本项目自身功能的通用词）