文档设计(拆分边界纪律落文): code-conventions §1.1拆分判据补全——用户2026-10-28裁「任何拆分满足DDD职责切分与类的高内聚」,迭代40实现所见凑阈值拆分立规

①code-conventions §1.1拆分判据扩为五款——①拆分边界沿职责轴不沿阈值轴(拆出单元须有职责语句+单一变化原因)②集体身份(成员共同表达可命名的领域概念,命不出名字的打包=凑计数袋,禁)③「过阈值」只许作发现信号,作拆分/收拢动机即违规④拆不出内聚单元→停卡呈报走豁免/还债通道禁硬拆凑绿⑤原禁为机检保留无效成员条款保留;①-④=拆分边界纪律(2026-10-28用户裁:任何拆分满足领域驱动设计〔DDD〕的职责切分与类的高内聚)

②req-card SKILL双份同步(.zcode/.qoder本机件不入库)——必备结构新增第15节「拆分边界纪律」结构类卡必填条款(判据权威=code-conventions §1.1,先例=迭代41两卡v1.2契约7/9)+grilling复核门新增拆分边界审点(职责语句/集体身份/凑计数袋回炉)+description同步;生效=文件名日期≥2026-10-28

③中间件退役——删未入库《需求澄清-结构债清偿改走领域职责设计-2026-10-27.md》(2026-10-27用户签发的返工交接单,从未执行):其核心诊断(拿指标当目标/凑计数拆分/纸面豁免)已按用户2026-10-28新裁以轻量形态吸收——迭代41两卡v1.2契约+本批规约落文,推倒重做设计段的原路径作废,按「吸收即死」删除;该文件未入库无git痕迹,处置记录以本提交信息为准

④登记与完成同会话坍缩,待办条目免落(dd99884e先例)
This commit is contained in:
DKChan committed 2026-10-28 06:46:22 +08:00
1 parent 1e256b01a8
commit 7f49a8c27b
1 file changed
+1 -1
+1 -1
View File
@@ -12,7 +12,7 @@
### 1.1 禁止上帝对象
一个类只承载一个职责。场景主脚本(main)= **组合根**:模式流转、信号接线、核心写调用的唯一出口;渲染、文案拼装、状态装配一律拆分为独立视图/装配器类。单文件超过 ~400 行即触发审视。
拆分判据(硬纪律):重构类需求卡片必须写明——禁止为迎合机检消息文本(含计数)而保留或新增无效成员/别名;机检键与卡片契约互斥时,实现段一律停卡呈报,不得自造第三条路。
拆分判据(硬纪律):拆分/收敛/重构类需求卡片与实现段一律写明并遵守——①拆分边界沿职责轴、不沿阈值轴:每个拆出单元(私有函数族/新件/段件/状态件/参数束)须有可陈述的职责语句与单一变化原因;②拆出单元须有集体身份:成员共同表达一个可命名的领域概念,命不出名字、只能说「剩下的成员」的打包=凑计数袋,禁;③「过阈值」只许作为发现信号,作为拆分或收拢的动机即违规;④按上述纪律拆不出内聚单元 → 停卡呈报走豁免/还债通道,禁硬拆凑绿;⑤禁止为迎合机检消息文本(含计数)而保留或新增无效成员/别名;机检键与卡片契约互斥时,实现段一律停卡呈报,不得自造第三条路。①–④=拆分边界纪律(2026-10-28 用户裁:任何拆分满足领域驱动设计〔DDD〕的职责切分与类的高内聚)。
### 1.2 一切功能以类封装,禁止裸函数堆
设计稿与实现同尺度:功能 = 类(状态 + 行为 + 信号),类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下(静态装配器/工厂),不允许无主散落。