SuperAPI AI 工具集

j5ik2o-ddd-when-to-wrap-primitives

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:在领域驱动设计(DDD)中,判断某个原始类型值是否值得封装成领域专用类型或值对象,避免过度封装带来的仪式感成本。

主要能力:给出“应封装”与“暂不封装”的判断标准。应封装的情形包括:值有领域名称与不变量;同一原始类型的两个值可能被混淆;校验逻辑重复或容易被遗忘;行为天然属于该值;非法状态会带来实际业务风险。暂不封装的情形包括:值没有行为或不变量;封装只是转发原始操作;类型是局部、临时或纯技术性的;团队会为很小的安全性付出高额仪式成本。

使用方式:先列出候选原始值及其风险,再对不变量强度、误用风险、行为、复用与迁移成本打分,优先封装价值最高的候选;保持构造显式、错误报告有用。对于非平凡的实现、评审或重构工作,在给出最终建议前阅读 references/details.md,其中包含详细规则、示例、坏味道与迁移说明。

输出:返回一张 wrap/keep 表格,包含理由与所选封装类型的示例 API。

限制:资料未提供具体安装命令、平台支持、收费方式或效果数据;该技能本身不自动执行重构,需结合项目实际判断。