RuoYi 经典单体版 AI 智能开发助手 | Claude Code + Codex 双引擎 | 30+ 专业技能 | 开箱即用
商品简介
基于 RuoYi 经典单体版（Java 17 + Spring Boot + MyBatis XML + Apache Shiro + Thymeleaf + jQuery + Bootstrap + EhCache + Quartz），深度定制的 AI 智能编程助手配置包。支持 Claude Code 和 OpenAI Codex 双 AI 引擎，内置 30+ 专业开发技能、6 大快捷命令、智能钩子系统，让 AI 真正理解您的项目架构和开发规范。
核心亮点
双 AI 引擎支持
| 引擎 | 配置目录 | 入口文件 | 说明 |
|---|---|---|---|
| Claude Code | .claude/ | CLAUDE.md | Anthropic Claude 官方 CLI 工具配置 |
| OpenAI Codex | .codex/ | AGENTS.md | OpenAI Codex CLI 工具配置 |
两套配置完全同步，无论您使用哪个 AI 工具，都能获得一致的智能开发体验。
30+ 专业开发技能
AI 不再是通用助手，而是深度理解 RuoYi 经典架构的专业开发伙伴。涵盖 MyBatis XML SQL 编写、Thymeleaf 模板开发、Shiro 权限管理、EhCache 缓存策略、Quartz 定时任务等 RuoYi 独有技术栈。
6 大快捷命令
一键执行复杂开发任务，告别重复劳动。从全栈功能开发到代码规范检查，一条命令搞定。
智能钩子系统
自动评估用户需求，精准匹配技能，确保每次响应都符合项目规范。
完整功能清单
一、快捷命令（6 个）
路径：.claude/commands/ 和 .codex/skills/
| 命令 | 功能 | 使用场景 |
|---|---|---|
/dev | 完整功能开发 | 从零开始开发新功能，自动生成 Controller + Service + Mapper + XML + Thymeleaf 页面 |
/crud | 快速 CRUD | 基于已有数据库表，快速生成完整的增删改查代码 |
/check | 代码规范检查 | 检查代码是否符合 RuoYi 规范，发现潜在问题 |
/progress | 项目进度报告 | 查看当前开发任务的完成情况和待办事项 |
/next | 下一步建议 | AI 分析当前状态，给出下一步开发建议 |
/start | 项目快速启动 | 快速了解项目结构和开发环境配置 |
二、专业技能库（30+ 个）
路径：.claude/skills/ 和 .codex/skills/
核心开发技能
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| crud-development | CRUD、增删改查、新建模块、Domain、Service、Controller、Mapper | 完整业务模块 CRUD 开发，遵循 Controller-Service-Mapper 三层架构 |
| api-development | API设计、接口规范、URL设计、接口路径、AjaxResult、TableDataInfo | API 接口设计规范，URL 路径设计、请求响应约定 |
| database-ops | 数据库、MySQL、SQL、表、字段、索引、字典、建表、菜单 | 数据库表设计、SQL 编写、字典管理、菜单权限配置 |
| mybatis-xml-sql | mybatis、mapper xml、resultmap、动态sql、sql片段、foreach | MyBatis 原生 XML SQL 映射开发，动态 SQL、关联查询、批量操作 |
| error-handler | 异常处理、ServiceException、try-catch、全局异常、Shiro异常 | 异常处理与错误码管理，统一错误响应 |
| architecture-design | 架构设计、模块划分、三层架构、分层设计、Controller-Service-Mapper | 系统架构设计、模块划分、代码重构策略 |
| project-navigator | 项目结构、文件在哪、目录、模块、代码位置 | 项目结构导航，快速定位代码文件 |
| test-development | 测试、单元测试、JUnit5、Mockito、Mock、断言 | 单元测试、集成测试、MockMvc 测试开发 |
安全与权限
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| security-auth | 安全、Shiro、@RequiresPermissions、登录认证、ShiroUtils、密码加密、验证码 | Apache Shiro 认证授权，权限注解、Session 管理、密码加密、UserRealm 配置 |
| data-permission | 数据权限、@DataScope、行级权限、数据隔离、部门权限 | @DataScope 数据权限开发，行级数据隔离，支持 5 种权限类型 |
前端 / UI（Thymeleaf + jQuery + Bootstrap）
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| ui-thymeleaf | thymeleaf、模板、html页面、前端页面、表单页面、字典渲染 | Thymeleaf 服务端渲染模板开发，Fragment 复用、内联 JS、Shiro 权限标签 |
| jquery-bootstrap | jquery、bootstrap、.operate、$.modal、layer弹窗 | 前端 JS 框架开发，Bootstrap Table 封装、Layer 弹窗、表单操作 |
基础设施
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| cache-ehcache | ehcache、缓存、字典缓存、系统参数、CacheUtils | EhCache 本地缓存配置、Shiro 会话缓存、字典缓存管理 |
| druid-datasource | druid、数据源、连接池、多数据源、主从、读写分离 | Druid 连接池与动态多数据源配置，连接池调优、监控控制台 |
| scheduled-jobs | 定时任务、Quartz、SysJob、Cron、调度、invokeTarget | Quartz 定时任务开发，Cron 表达式、并发控制、Misfire 策略 |
| file-storage | 文件上传、文件下载、FileUploadUtils、上传路径 | 本地文件存储开发，文件上传下载、路径映射、类型校验 |
| json-serialization | JSON、序列化、FastJSON、Jackson、@JSONField | JSON 序列化处理，FastJSON/Jackson 双库使用、XSS 过滤 |
| i18n-development | 国际化、多语言、i18n、MessageSource | Spring MessageSource 后端国际化和 Thymeleaf 模板国际化 |
| performance-doctor | 性能优化、慢查询、SQL优化、索引优化、Druid、EhCache | 性能诊断与优化，SQL 优化、连接池调优、Shiro Session 优化 |
| excel-export | Excel、导出、导入、@Excel、ExcelUtil、POI | Apache POI + @Excel 注解体系，Excel 导入导出开发 |
辅助工具
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| brainstorm | 头脑风暴、方案、怎么设计、有什么办法、创意 | 创意探索与方案设计 |
| task-tracker | 创建任务、跟踪任务、记录进度 | 开发任务进度跟踪，中断恢复 |
| git-workflow | Git、提交、commit、分支、合并 | Git 版本控制操作规范 |
| tech-decision | 选型、用什么、对比、哪个好、优缺点 | 技术选型与方案对比 |
| bug-detective | Bug、报错、不工作、调试、排查 | Bug 排查与问题定位 |
| code-patterns | 规范、禁止、命名、Git提交、代码风格 | 全栈编码规范速查 |
| utils-toolkit | 工具类、DateUtils、StringUtils、BeanUtils | 工具类使用指南与最佳实践 |
框架专属技能（L4 级别）
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| mybatis-xml-sql | mybatis、resultmap、动态sql、foreach、association | MyBatis 原生 XML SQL 映射，RuoYi 独有的 Mapper XML 开发规范 |
| ui-thymeleaf | thymeleaf、th:、fragment、shiro标签 | Thymeleaf 服务端渲染（非 SPA），RuoYi 独有的页面开发模式 |
| jquery-bootstrap | .operate、$.modal、ry-ui、bootstrap table | RuoYi 封装的前端 JS 框架，区别于 Vue/React |
| druid-datasource | druid、连接池调优、监控控制台 | Druid 数据源专属配置与监控 |
| cache-ehcache | ehcache、shiro缓存、缓存清理 | EhCache 本地缓存（非 Redis），RuoYi 独有缓存方案 |
| code-generator | 代码生成、velocity、gen_table | 基于 Velocity 模板的代码生成器 |
AI 协作
| 技能 | 触发词 | 功能描述 |
|---|---|---|
| collaborating-with-codex | Codex、协作、多模型 | 与 OpenAI Codex 协同开发，任务委托与代码审查 |
| collaborating-with-gemini | Gemini、协作、多模型 | 与 Google Gemini 协同开发，前端原型与 UI 设计 |
| add-skill | 添加技能、创建技能、新技能 | 技能创建与维护指南 |
智能钩子系统
skill-forced-eval（技能强制评估）
每次用户提问时，钩子自动：
- 分析用户需求关键词
- 从 30 个技能中匹配相关技能
- 注入技能评估提示，强制 AI 激活对应技能
- 确保 AI 按 RuoYi 项目规范响应，而非给出通用回答
pre-tool-use（工具使用前检查）
在 AI 执行文件操作前，自动检查：
- 文件路径是否在项目范围内
- 是否误操作敏感文件（如配置文件、数据库脚本）
- 代码规范预检（包名、分层、命名约定）
技术栈
| 层级 | 技术 | 版本 |
|---|---|---|
| 后端语言 | Java | 17 |
| 后端框架 | Spring Boot | 4.0.3 |
| ORM 框架 | MyBatis（原生 XML） | 3.x |
| 认证框架 | Apache Shiro | 2.x |
| 缓存框架 | EhCache | 内置 |
| 定时任务 | Quartz | 2.x |
| 数据库连接池 | Druid | 最新 |
| 模板引擎 | Thymeleaf | 3.x |
| 前端框架 | jQuery + Bootstrap | 3.x / 3.x |
| 弹窗组件 | Layer | 3.x |
| 数据表格 | Bootstrap Table | 1.x |
| 树形组件 | zTree | 3.x |
| 数据库 | MySQL | 5.7+ |
模块结构
| 模块 | 用途 |
|---|---|
ruoyi-admin | Web 入口，所有 Controller + Thymeleaf 模板 |
ruoyi-framework | 框架核心：Shiro、AOP、拦截器、数据源 |
ruoyi-system | 系统业务：用户/角色/部门/菜单/字典 |
ruoyi-common | 通用工具、基类、注解、异常、常量 |
ruoyi-quartz | 定时任务（Quartz） |
ruoyi-generator | 代码生成器（Velocity） |
安装使用
第一步：获取配置包
下载完整配置包。
第二步：放入项目根目录
将以下文件/目录放入您的 RuoYi 项目根目录：
.claude/ # Claude Code 配置（skills、commands、hooks）
.codex/ # OpenAI Codex 配置（完全同步）
CLAUDE.md # Claude Code 入口指令文件
AGENTS.md # Codex 入口指令文件
第三步：启动 AI 工具
启动 Claude Code 或 Codex CLI，AI 将自动加载所有技能和配置。
# Claude Code
claude
# OpenAI Codex
codex
AI 会自动识别 RuoYi 项目结构，使用 MyBatis XML、Shiro 权限注解、Thymeleaf 模板等正确的技术规范来辅助开发。
