SuperAPI AI 工具集

ddd-when-to-wrap-primitives

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:辅助在做领域驱动设计时决定某个基础类型(primitive)值是否值得封装成领域专用类型或值对象,避免过度封装或封装不足。

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

使用方式:按工作流执行——列出候选基础类型及其风险;对不变量强度、误用风险、行为归属、复用程度和迁移成本评分;优先封装价值最高的候选;保持构造过程显式且错误信息有用。对于非平凡实现、评审或重构工作,需先阅读 references/details.md 再给出最终建议。

输出:返回封装/保留对照表,附理由与所选封装类型的示例 API。

限制:具体实现细节、示例、坏味道与迁移说明放在 references/details.md 中,简短调用体不包含;资料未提供更细的评分权重、阈值或命令。