lumina: Skill for Claude Code

Lumina MyBatis-Plus 使用规范

功能概述

本技能包用于确保 Lumina 框架项目正确使用 MyBatis-Plus，包括基础 CRUD、复杂查询、分页、批量操作等。

核心原则

1. 优先使用 MyBatis-Plus - 所有简单 CRUD 操作必须使用 MyBatis-Plus
2. 复杂 SQL 才用 XML - 仅当 MyBatis-Plus 无法满足时，才使用 XML Mapper
3. 禁止 SQL 函数和存储过程 - 不允许在 SQL 中编写函数、存储过程、触发器
4. 业务逻辑在 Java 代码中 - 所有业务逻辑必须在 Java 代码中实现，不允许写在 SQL 中

MyBatis-Plus 基础使用

Mapper 接口

/**
 * Agent Mapper - 继承 BaseMapper，获得基础 CRUD 能力
 */
@Mapper
public interface AgentMapper extends BaseMapper<AgentDO> {
    
    // 基础 CRUD 方法已由 BaseMapper 提供，无需重复定义：
    // - insert(AgentDO entity)
    // - deleteById(Serializable id)
    // - updateById(AgentDO entity)
    // - selectById(Serializable id)
    // - selectList(Wrapper<AgentDO> queryWrapper)
    // - selectPage(IPage<AgentDO> page, Wrapper<AgentDO> queryWrapper)
    // - selectCount(Wrapper<AgentDO> queryWrapper)
    
    // 复杂查询才需要自定义方法（见 5.2.2）
}

常用操作示例

条件查询

// 根据名称查询
AgentDO agentDO = agentMapper.selectOne(
    new LambdaQueryWrapper<AgentDO>()
        .eq(AgentDO::getAgentName, agentName)
        .eq(AgentDO::getDeleted, 0)
);

// 条件查询列表
LambdaQueryWrapper<AgentDO> wrapper = new LambdaQueryWrapper<AgentDO>()
    .eq(AgentDO::getDeleted, 0);
if (StringUtils.isNotBlank(dto.getAgentName())) {
    wrapper.like(AgentDO::getAgentName, dto.getAgentName());
}
List<AgentDO> list = agentMapper.selectList(wrapper);

分页查询

// 创建分页对象
Page<AgentDO> page = new Page<>(dto.getPageNum(), dto.getPageSize());

// 构建查询条件
LambdaQueryWrapper<AgentDO> wrapper = new LambdaQueryWrapper<AgentDO>()
    .eq(AgentDO::getDeleted, 0)
    .orderByDesc(AgentDO::getCreateTime);

// 执行分页查询
Page<AgentDO> result = agentMapper.selectPage(page, wrapper);

条件更新

// 更新状态
agentMapper.update(null,
    new LambdaUpdateWrapper<AgentDO>()
        .set(AgentDO::getStatus, status.getValue())
        .set(AgentDO::getUpdateTime, LocalDateTime.now())
        .eq(AgentDO::getAgentId, agentId)
        .eq(AgentDO::getDeleted, 0)
);