用途:创建或重构领域逻辑,使业务规则集中在可测试的模块边界内,具备显式不变量与确定性错误行为,防止规则泄漏到控制器、任务或适配器。
输入:要实现的领域概念(1–3 句);必须始终成立的不变量(must/must-not 列表);调用该模块的入口点(端点处理器/任务/集成适配器);可选仓库画像 <repo>/REPO_PROFILE.json。
输出:领域模块,含清晰输入输出、显式不变量、确定性错误返回;单元测试覆盖正常路径、不变量违反、至少一个边界情况。
非目标:端点接线(用 backend/endpoint-scaffold)、模式与迁移(用 backend/persistence-layer-change)、外部 API IO(用 backend/integration-adapter)、UI 逻辑。
工作流:定位正确的领域边界(沿用现有模块/目录模式);定义模块公共 API(带显式类型的函数或类);显式编码不变量(校验前置条件,必要时校验后置条件);定义错误行为(类型化错误码,若存在则对齐 shared/error-taxonomy,避免跨边界抛原始异常,除非仓库标准如此);编写聚焦规则而非接线的单元测试;确保调用方只做编排、不重复实现规则;运行画像要求的校验。
检查:不变量显式且被强制执行;错误确定且映射清晰;抽取后调用方更薄;单元测试覆盖正常路径、至少 2 个不变量失败、边界情况;若配置了类型检查/lint 则通过。
失败模式:不变量不清或有争议时,建议先做 $decision-capture;规则散落多个模块时建议合并(但不做大范围重构);因耦合难以测试时,抽取依赖并注入接口。
遥测:记录 skill: backend/domain-logic-module、domain_area、invariants_added_or_changed 数量、tests_added 数量、files_touched、outcome(success | partial | blocked)。
限制:资料未提供具体安装命令、收费、平台与效果信息。