lumina: Skill for Claude Code

Lumina 领域模型实践规范

功能概述

本技能包用于确保 Lumina 框架项目的领域模型设计符合规范，包括实体设计、业务方法封装、值对象使用等。

领域实体设计

简单场景（推荐）

/**
 * Agent 领域实体 - 简单场景示例
 * 
 * <p>简单场景：直接使用基本类型，不封装 Value Object
 */
@Data
public class Agent {
    
    private Long agentId;
    private String agentName;  // 直接使用 String
    private AgentType agentType;  // 使用枚举
    private AgentStatus status;
    
    /**
     * 执行任务 - 领域方法
     * 
     * <p>业务逻辑封装在领域实体中
     */
    public TaskResult executeTask(Task task) {
        // 业务规则校验
        if (!this.canExecute()) {
            throw new AgentCannotExecuteException("Agent当前状态无法执行任务");
        }
        
        // 业务逻辑
        return task.execute(this);
    }
    
    /**
     * 是否可以执行 - 业务规则
     */
    public boolean canExecute() {
        return status == AgentStatus.ACTIVE;
    }
    
    /**
     * 激活 Agent - 领域方法
     */
    public void activate() {
        if (this.status == AgentStatus.ACTIVE) {
            throw new IllegalStateException("Agent已经是激活状态");
        }
        this.status = AgentStatus.ACTIVE;
    }
    
    /**
     * 停用 Agent - 领域方法
     */
    public void deactivate() {
        if (this.status == AgentStatus.INACTIVE) {
            throw new IllegalStateException("Agent已经是停用状态");
        }
        this.status = AgentStatus.INACTIVE;
    }
}

复杂场景（可选）

/**
 * 复杂场景：使用 Value Object 封装业务规则
 * 
 * <p>当字段需要封装业务规则时，使用 Value Object
 */
@Value
public class AgentName {
    private final String value;
    
    public AgentName(String value) {
        if (StringUtils.isBlank(value)) {
            throw new IllegalArgumentException("Agent名称不能为空");
        }
        if (value.length() > 100) {
            throw new IllegalArgumentException("Agent名称长度不能超过100");
        }
        this.value = value;
    }
}

/**
 * 复杂场景的 Entity 使用 Value Object
 */
@Data
public class Agent {
    private AgentId agentId;  // Value Object
    private AgentName agentName;  // Value Object
    private AgentType agentType;
    private AgentStatus status;
    
    // ... 业务方法
}