chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿(2026-10-15 用户令)

- CLAUDE.md 硬性红线新增「文件头零工作日志」;code-conventions.md 新增 §1.4.1(含反面案例)
- 全仓 .gd 文件头注清偿:删除全部带日期条目、批次叙事段与迁移退役叙述,保留并改写为
  现在时的职责、接口契约、GDD 锚内容(main.gd 头注 42→31 行、save_manager.gd 49→45 行)
- 纯注释改动零行为变更,按用户令免测试免冒烟
This commit is contained in:
DKChan committed 2026-10-15 04:08:38 +08:00
1 parent d5eea25f9c
commit 5f9d8e7b77
94 files changed
+386 -458

No files matched your search

+9
View File
@@ -40,6 +40,15 @@
> **反面案例(2026-09-11,用户:"是没有代码规范吗")**:ID 前缀是跟随 GDD 文档名的事实约定,
> 从未成文;同目录 `config_db`/`rng_service` 无前缀与 A/B/C 系列并存——两套命名即规范缺失的铁证。
### 1.4.1 文件头零工作日志(2026-10-15 用户立规)
文件头注释只描述现在——职责、契约、GDD 锚。禁止任何变更叙事进文件头:
带日期条目、批次叙事段(「XX批」「T几」「迭代N」开头的"本批做了什么")、迁移/退役经过注记一律禁止;
改动历史查 `git log`/`git blame`,变更背景读对应迭代实现报告。
> **反面案例(2026-10-15,用户令全仓清偿)**:main.gd 文件头曾累积 42 行——11+ 笔提交各自往头注
> 追加一段「本批做了什么」,全部闸静默放行;save_manager.gd 曾达 49 行。同批 17 文件存量已清;
> 红线正文见 CLAUDE.md 硬性红线。
### 1.5 禁止事实约定
任何"大家默认这么做"的惯例必须成文进本文件(或 CLAUDE.md)才算存在。
写代码时发现未成文但必须遵守的约定 → 当场补条文,不许靠惯性延续。