From 7f49a8c27b22cb31966d8528b6ae3c24c835bfc2 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Wed, 28 Oct 2026 06:46:22 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AE=BE=E8=AE=A1(=E6=8B=86?= =?UTF-8?q?=E5=88=86=E8=BE=B9=E7=95=8C=E7=BA=AA=E5=BE=8B=E8=90=BD=E6=96=87?= =?UTF-8?q?):=20code-conventions=20=C2=A71.1=E6=8B=86=E5=88=86=E5=88=A4?= =?UTF-8?q?=E6=8D=AE=E8=A1=A5=E5=85=A8=E2=80=94=E2=80=94=E7=94=A8=E6=88=B7?= =?UTF-8?q?2026-10-28=E8=A3=81=E3=80=8C=E4=BB=BB=E4=BD=95=E6=8B=86?= =?UTF-8?q?=E5=88=86=E6=BB=A1=E8=B6=B3DDD=E8=81=8C=E8=B4=A3=E5=88=87?= =?UTF-8?q?=E5=88=86=E4=B8=8E=E7=B1=BB=E7=9A=84=E9=AB=98=E5=86=85=E8=81=9A?= =?UTF-8?q?=E3=80=8D,=E8=BF=AD=E4=BB=A340=E5=AE=9E=E7=8E=B0=E6=89=80?= =?UTF-8?q?=E8=A7=81=E5=87=91=E9=98=88=E5=80=BC=E6=8B=86=E5=88=86=E7=AB=8B?= =?UTF-8?q?=E8=A7=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ①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先例) --- design/engineering/code-conventions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/design/engineering/code-conventions.md b/design/engineering/code-conventions.md index 9d422761..26b24b42 100644 --- a/design/engineering/code-conventions.md +++ b/design/engineering/code-conventions.md @@ -12,7 +12,7 @@ ### 1.1 禁止上帝对象 一个类只承载一个职责。场景主脚本（main）= **组合根**：模式流转、信号接线、核心写调用的唯一出口；渲染、文案拼装、状态装配一律拆分为独立视图/装配器类。单文件超过 ~400 行即触发审视。 -拆分判据（硬纪律）：重构类需求卡片必须写明——禁止为迎合机检消息文本（含计数）而保留或新增无效成员/别名；机检键与卡片契约互斥时，实现段一律停卡呈报，不得自造第三条路。 +拆分判据（硬纪律）：拆分/收敛/重构类需求卡片与实现段一律写明并遵守——①拆分边界沿职责轴、不沿阈值轴：每个拆出单元（私有函数族/新件/段件/状态件/参数束）须有可陈述的职责语句与单一变化原因；②拆出单元须有集体身份：成员共同表达一个可命名的领域概念，命不出名字、只能说「剩下的成员」的打包＝凑计数袋，禁；③「过阈值」只许作为发现信号，作为拆分或收拢的动机即违规；④按上述纪律拆不出内聚单元 → 停卡呈报走豁免/还债通道，禁硬拆凑绿；⑤禁止为迎合机检消息文本（含计数）而保留或新增无效成员/别名；机检键与卡片契约互斥时，实现段一律停卡呈报，不得自造第三条路。①–④＝拆分边界纪律（2026-10-28 用户裁：任何拆分满足领域驱动设计〔DDD〕的职责切分与类的高内聚）。 ### 1.2 一切功能以类封装，禁止裸函数堆 设计稿与实现同尺度：功能 = 类（状态 + 行为 + 信号），类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下（静态装配器/工厂），不允许无主散落。