架构收窄批第1步(规约先行): 架构文档只写约束面+写权限收为用户专属。doc-conventions 架构事实唯一源行去「测试与质量域」归口+新增约束面定义与写权限条款; 禁实现内容行「实现事实归architecture.md」改「归代码与代码头注」; test-conventions §6 闸状态登记改指 game/tests/README.md+§8.3 oracle 锚增节锚形态(整节重排同批重锚义务); code-conventions §1.6 拆件定稿节先例引用改指 board_installer.gd 构造面; AGENTS.md 测试导航行补工具手册指路+架构导航行与红线行同步约束面口径与写权限。技能面(不入git主区直改): batch-closure 吸收判据架构文档改「仅约束面且须用户落文」; doc-design 反哺落点明文排除架构文档。凭据: --docs 域闸【验收通过】无新增红(流水线闸 PASS 34条目, doc_term 疑似现行0)

This commit is contained in:
DKChan committed 2026-11-07 07:06:22 +08:00
1 parent 5c4d6000ef
commit aa0b23c951
5 files changed
+16 -8

No files matched your search

+1 -1
View File
@@ -37,7 +37,7 @@
### 1.6 拆分交接与封装边界
本节管拆分类改动的交接面与封装面,与 §1.1 拆分判据(职责轴)配合使用:§1.1 管怎么切,本节管切完之后件与件之间怎么往来。
1. **拆分交接定义**:拆出一个新类时,交付物必须同时写明职责边界与交接定义——新类构造时需要哪些依赖,由拆出它的类在构造它时一次交给它;新类需要回调拆出它的类的哪些方法,以 Callable 形式交付。两者齐备才算拆分合格。为什么:只切职责不定义交接,新件会伸手回原类内部拿东西,封装从拆件那天起就破了。正面先例=装板件的引用束注入(表数据、随机流、装板所需对象与出错回调一次性交付——架构文档「战斗编排域拆件定稿」节 BoardInstaller 行在册)。
1. **拆分交接定义**:拆出一个新类时,交付物必须同时写明职责边界与交接定义——新类构造时需要哪些依赖,由拆出它的类在构造它时一次交给它;新类需要回调拆出它的类的哪些方法,以 Callable 形式交付。两者齐备才算拆分合格。为什么:只切职责不定义交接,新件会伸手回原类内部拿东西,封装从拆件那天起就破了。正面先例=装板件的引用束注入(表数据、随机流、装板所需对象与出错回调一次性交付——先例本体=`game/core/board_installer.gd` 构造面,沿革 git 历史可考)。
2. **封装边界**:任何代码不得访问其他对象的下划线成员;跨对象往来只走公开方法与属性。为什么:下划线只是命名约定,语言不设防、无编译期检查——此条是封装硬纪律,违者即红。
---