RuoYi-Vue-Plus AI 智能编程助手配置指南

基础设施（6 个）

辅助工具（8 个）

AI 协作（3 个）

项目管理（3 个）

快捷命令（10 个）

路径：.claude/commands/ 和 .codex/skills/

智能钩子系统（3 个）

路径：.claude/hooks/

核心机制：每次用户提问，钩子自动注入技能评估提示，AI 必须先匹配技能、激活技能、再执行任务，确保每次响应都符合项目规范。

智能代理（2 个）

路径：.claude/agents/

文档模板（3 个）

路径：.claude/templates/

开发文档（8 篇）

路径：.claude/docs/

配置文件（2 个）

目录结构总览

RuoYi-Vue-Plus/
├── .claude/ # Claude Code 配置
│   ├── commands/ # 10 个快捷命令
│   │   ├── dev.md # 完整功能开发
│   │   ├── crud.md # 快速 CRUD 生成
│   │   ├── check.md # 代码规范检查
│   │   ├── progress.md # 项目进度分析
│   │   ├── next.md # 下一步建议
│   │   ├── sync.md # 全量状态同步
│   │   ├── start.md # 项目快速了解
│   │   ├── init-docs.md # 文档初始化
│   │   ├── update-status.md # 增量状态更新
│   │   └── add-todo.md # 添加待办事项
│   │
│   ├── skills/ # 40+ 专业技能
│   │   ├── crud-development/ # CRUD 开发
│   │   ├── api-development/ # API 开发
│   │   ├── database-ops/ # 数据库操作
│   │   ├── security-guard/ # 安全开发
│   │   ├── redis-cache/ # Redis 缓存
│   │   ├── workflow-engine/ # 工作流引擎
│   │   ├── ... (40+ 技能)
│   │   └── banana-image/ # AI 图片生成
│   │
│   ├── hooks/ # 智能钩子
│   │   ├── skill-forced-eval.js # 技能强制评估
│   │   ├── pre-tool-use.js # 工具预处理
│   │   └── stop.js # 停止处理
│   │
│   ├── agents/ # 智能代理
│   │   ├── project-manager.md # 项目管理助手
│   │   └── code-reviewer.md # 代码审查助手
│   │
│   ├── templates/ # 文档模板
│   │   ├── 待办清单模板.md
│   │   ├── 需求文档模板.md
│   │   └── 项目状态模板.md
│   │
│   ├── docs/ # 开发文档
│   │   ├── 框架说明.md
│   │   ├── 后端开发指南.md
│   │   └── ... (8 篇文档)
│   │
│   ├── audio/ # 音频资源
│   │   └── completed.wav
│   │
│   ├── settings.json # 全局配置
│   └── framework-config.json # 框架配置
├── .codex/ # Codex CLI 配置
│   └── skills/ # 40+ 专业技能（与 Claude 同步）
│       ├── crud-development/
│       ├── dev/ # 快捷命令转技能
│       ├── crud/
│       ├── check/
│       ├── progress/
│       ├── next/
│       ├── sync/
│       ├── start/
│       ├── init-docs/
│       ├── update-status/
│       ├── add-todo/
│       └── ... (40+ 技能)
└── CLAUDE.md # 项目规范主文件

技术规范内置

本配置包深度集成 RuoYi-Vue-Plus 开发规范：

架构规范

• ✅ 三层架构：Controller → Service → Mapper（无 DAO 层）
• ✅ 包名规范：org.dromara.*
• ✅ 实体基类：TenantEntity（多租户支持）
• ✅ 对象转换：MapstructUtils.convert()
• ✅ 主键策略：雪花 ID（非自增）

API 规范

代码检查项

• 🔴 严重：包名必须是 org.dromara.*
• 🔴 严重：禁止完整类型引用
• 🔴 严重：API 路径必须规范
• 🟡 警告：必须使用 @SaCheckPermission
• 🟡 警告：必须使用 MapstructUtils
• 🟡 警告：BO 必须使用 @AutoMapper

环境要求

• Claude Code：需安装 Claude Code CLI
• OpenAI Codex：需安装 Codex CLI
• RuoYi-Vue-Plus：5.X 版本

使用方法

1. 将 .claude/ 和 .codex/ 目录复制到您的 RuoYi-Vue-Plus 项目根目录
2. 将 CLAUDE.md 复制到项目根目录
3. 启动 Claude Code 或 Codex CLI
4. 输入 /start 开始体验