用途
domain-analysis 是一个面向 DDD(领域驱动设计)领域建模的架构技能,属于 duc01226/easy-claude 技能集。当工作流步骤或用户要求进行 DDD 领域建模(上下文、聚合、实体、ERD 与事件)时使用。其目标是从业务证据出发,产出经用户确认的领域模型与 ERD,使后续实现能够保持领域不变量与边界。
主要能力
技能包含两种模式:
- 默认模式(无参数):业务领域分析。按固定步骤执行:定位活动计划与领域参考、加载业务上下文、识别限界上下文、建模实体与聚合、映射关系、识别领域事件、生成 ERD、用户验证访谈、领域实体变更评估、更新主计划。
- --mode=review [changes | scan [<module>]] [--report-only]:对领域实体与值对象进行 DDD 设计质量评审,包含检查清单 A–P、健康评分与已验证发现的修复循环;--report-only 为只读叶子模式,不执行修复。该模式原为 /domain-entities-review 斜杠命令,现通过模式参数直接调用。
默认分析流程会:从业务制品中提取名词(候选实体)、动词(事件)、角色(权限/视图)与流程(业务工作流);按 DDD 原则对实体分组并记录每个上下文的名称、目的、Core/Supporting/Generic 分类、主要职责、团队归属与通用语言;对每个概念按实体与值对象矩阵分类并应用聚合边界规则;记录上下文内关系与跨上下文集成模式(ACL、Customer-Supplier、Open Host Service、Conformist);识别领域事件并区分内部领域事件与集成契约;生成 Mermaid ER 图,用注释分组实体、Crow's Foot 基数、关键业务字段与实际标识类型;最后进行 5–8 个问题的用户验证访谈并持久化决策。
使用方式
技能通过名称调用(如 $domain-analysis),在 Codex 环境中加载注册的 .agents/skills/<name>/SKILL.md 并执行。评审模式通过 --mode=review 选择,可附加 changes、scan [<module>]、--report-only 等参数。技能要求按顺序执行步骤,除非用户批准偏离;每步先建立跟踪任务,保留进度与证据。
输出文件包括:{plan-dir}/research/domain-analysis.md(完整领域分析报告)、{plan-dir}/phase-01-domain-model.md(含 ERD 的已确认领域模型)、{plan-dir}/plan.md(追加领域模型摘要)、docs/project-reference/domain-entities-reference.md(新增/修改实体,路径可由 docs/project-config.json 的 docsRoots.projectReference.path 覆盖)。报告结构包含执行摘要、上下文映射、逐上下文实体/聚合详情、关系表、值对象目录、领域事件目录、Mermaid ERD、反模式警告与未决问题,且要求不超过 250 行,优先使用表格。
适用场景
适用于需要从业务证据推导领域模型、确认限界上下文与聚合边界、生成 ERD 与领域事件目录的架构设计阶段;也适用于对已有领域实体与值对象做设计质量评审。技能建议在边界划分或聚合边界存在争议、模型涉及 3 个以上服务、或跨聚合不变量等情况下考虑升级到 $llm-council。
限制
技能要求从业务制品推导决策并引用证据与置信度(超过 80% 才行动,否则需验证);新增实体前需比较 3 个以上已有参考实体。用户验证访谈为强制步骤,不可跳过。参考更新需用户批准。评审决策不接受未解决风险,也不让失败的关卡通过。关于该技能的具体收费、价格、平台支持范围与效果,资料中暂未提供。