⚠️ 开始前必读:演示工具说明

本教程演示所用的 AI IDE 是 Trae。文中涉及「本地环境配置 / 直连数据库」的步骤,必须使用Trae——因为有些工具会运行在沙箱环境中,无法操作你本机的真实环境。

💡 小白科普Trae 是个 AI 编程助手(智能编辑器),你用大白话提需求,它就帮你写代码、配环境;沙箱是 AI 临时隔出来的「虚拟房间」,里面碰不到你电脑上的真实文件和数据库,所以涉及本机操作的步骤得用 Trae 才靠谱。


第一步 · 项目环境准备

任何项目的运行环境永远是最重要的。本次我们使用的是若依(RuoYi)单体项目

为什么选若依?

  • Java 是国内后台管理系统使用最多的开发语言,若依使用 Java 开发;
  • 若依是使用最广的系统开发框架,许多企业都在用,自带用户管理与权限管理;
  • 若依单体依赖最少,只需要 JDK + MySQL 即可一键运行,依赖少、项目经过充分验证。

必装系统环境

名称版本是干嘛的
JDK= 8跑后端 Java 程序的发动机,Java 语言必须
MySQL≥ 5.7存数据(用户、菜单、业务)的仓库,即数据库
Maven≥ 3后端的「快递员」,包管理工具,需要什么装什么
Node.js(MCP 用)≥ 18本项目代码不涉及,仅 MCP 用于插件下载
Git(可选)无要求记录每次内容变更的工具,项目版本管理

软件下载(Windows)

由于网络或其他原因,这些软件对新手来说都不太好下载。这里提供 Windows 10/11 x64 的网盘目录直链,无需登录即可下载。

博主没有 Mac / Linux 电脑,使用 Mac 或 Linux 的同学请自行搜索对应下载方式。

名称下载链接备注(新手必看)
JDK 8https://wwbis.lanzn.com/iPmS426im1wh运行 Java 程序必需的环境。双击安装包一路「下一步」即可,装不对后面项目跑不起来
MySQLhttps://wwbis.lanzn.com/ix3tc2lttm0j数据仓库,存用户/菜单/业务数据。推荐集成工具包(自带 MySQL 多版本和客户端),装好后点一下就能启动,适合新手
Maven 3.6https://wwbis.lanzn.com/iStsE2eb3hha后端的「包管理工具」,自动下载项目依赖。下载后是压缩包,解压到英文路径,再按教程配置本地仓库和国内镜像,否则下载依赖会很慢
Node.jshttps://nodejs.org/dist/v24.18.1/node-v24.18.1-x64.msi本项目代码用不到,仅给 Trae 装 MCP 插件时需要。双击安装包一路「下一步」即可
Git 2.36https://wwbis.lanzn.com/iNsZF2eb3ned记录代码修改历史的版本管理工具(可选)。双击安装包一路「下一步」即可,不用也能完成本教程

提示:JDK 8、MySQL、Node.js、Git 2.36都是直接安装即可,一路默认下一步。如果遇到环境问题,可百度解决,也可以用 AI 辅助。

MySQL 配置

安装好集成工具包后,点击 软件管理 → 数据库,下载需要的版本(建议 5.7.26)。

软件管理-数据库下载
软件管理-数据库下载

点击 数据库工具(客户端),下载:

数据库工具-客户端下载
数据库工具-客户端下载

会默认附带下载一些其他软件,多余的软件在「全部」里直接卸载即可:

卸载多余附带软件
卸载多余附带软件

点击数据库,鼠标悬浮到密码处可以查看密码(使用 SQL_Front 连接工具时要一一对应):

悬浮查看账号密码
悬浮查看账号密码

数据库下载完成后,在首页可以打开工具连接,选择 SQL_Front(打开前一定要先启动 MySQL 服务):

首页打开 SQL_Front 连接
首页打开 SQL_Front 连接

启动端口在此处查看,默认是 3306,可修改,连接时要一一对应:

查看启动端口(默认 3306)
查看启动端口(默认 3306)

点击 属性

点击属性
点击属性

端口、用户、密码要和前边查到的对上:

确认端口用户密码一致
确认端口用户密码一致

配置完点击 打开

点击打开连接
点击打开连接

连接成功
连接成功

MySQL 环境完全配置完成。

Maven 配置(请先配置好 JDK)

可以百度后手工配置,也可以用 AI。但这里建议用百度——因为 AI 有可能会把系统环境变量搞乱。

如果你要用 AI 工具(建议用 Trae),下面提供一份 Windows 版提示词:

AI Maven 环境配置提示词

使用说明
1. 将下方"提示词正文"完整复制粘贴给 AI
2. 将所有 {{占位符}} 替换为你的实际值(下方有占位符清单参考)
3. Maven 压缩包请自行准备并放到指定目录
4. 本提示词假设 JDK 已安装并配置好 JAVA_HOME,Maven 依赖 JDK 运行

占位符清单

  [1] {{WORK_DIR}}
      含义: 工作目录(解压目标目录)
      示例: C:\Program Files\ENV

  [2] {{MAVEN_ZIP}}
      含义: Maven 压缩包完整路径
      示例: C:\Program Files\ENV\apache-maven-3.6.0-bin.zip

  [3] {{MAVEN_VERSION}}
      含义: Maven 版本号
      示例: 3.6.0

  [4] {{LOCAL_REPO}}
      含义: Maven 本地仓库路径
      示例: E:\localMaven

  [5] {{JAVA_VERSION}}
      含义: Java 目标编译版本(对应已安装的 JDK)
      示例: 1.8

================================================================================

提示词正文

你是一位资深的 Windows 系统环境配置专家。请帮我配置 Maven 开发环境。

前提条件:JDK 已安装且 JAVA_HOME 已正确配置,Maven 依赖 JDK 运行。
请严格按照以下约束执行,每一条约束都是为了防止环境配置错误导致系统故障。

一、安装包来源
- Maven 压缩包(我已提供):{{MAVEN_ZIP}}
- 解压目标目录:{{WORK_DIR}}(禁止解压到其他目录)

二、配置要求
1. Maven 本地仓库路径:{{LOCAL_REPO}}(如目录不存在则创建)
2. Maven 国内镜像:必须配置阿里云公共仓库 https://maven.aliyun.com/repository/public
3. JDK 编译版本:默认使用 JDK {{JAVA_VERSION}} 编译

三、严格操作约束(违反任何一条都可能导致系统故障)

约束 1:操作前必须先备份环境变量(最重要!)
在修改任何环境变量之前,必须先执行完整备份:
- 读取并保存 Machine 级别所有环境变量(JAVA_HOME、MAVEN_HOME、M2_HOME、PATH 等)到备份文件
- 读取并保存 User 级别所有环境变量到备份文件
- 读取并保存注册表原始值(HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment)
- 备份文件保存到:{{WORK_DIR}}\env_backup_YYYYMMDD_HHmmss.txt
- 备份文件中必须记录每个变量的注册表值类型(String 或 ExpandString)
- 未完成备份前,禁止进行任何修改操作

约束 2:解压位置必须精确
- Maven 必须解压到工作目录 {{WORK_DIR}}\
- 禁止解压到其他任意目录
- 解压后必须验证关键文件存在:
  - {{WORK_DIR}}\apache-maven-{{MAVEN_VERSION}}\bin\mvn.cmd

约束 3:修改 PATH 前必须逐一验证每个现有路径
- 读取当前 Machine PATH 和 User PATH 的所有条目
- 对每一个已存在的路径条目,必须用 Test-Path 验证目录是否真实存在
- 只有确认目录不存在的路径才允许移除
- 禁止移除任何目录真实存在的路径条目,即使看起来像是"旧的"或"失效的"
- 移除操作必须列出清单并逐条说明移除原因,供人工确认

约束 4:PATH 注册表值类型必须正确
- 写入 PATH 时必须使用 REG_EXPAND_SZ(ExpandString)类型,不能使用 REG_SZ(String)类型
- 如果 PATH 中使用了 %MAVEN_HOME% 变量引用,注册表类型必须是 ExpandString,否则变量不会被展开
- 推荐使用绝对路径写入 PATH,避免依赖变量展开(更可靠)
- 写入后必须验证:读取注册表原始值确认类型正确,再读取展开值确认路径正确
- 推荐使用 Win32 注册表 API(Microsoft.Win32.Registry)操作,而非 .NET 的 Environment.SetEnvironmentVariable(后者会把 ExpandString 降级为 String)

约束 5:环境变量写入后必须广播刷新
- 修改完成后必须调用 SendMessageTimeout 广播 WM_SETTINGCHANGE 消息
- 通知参数:wParam=IntPtr.Zero, lParam="Environment", fuFlags=2, uTimeout=5000
- 提示用户重新打开终端窗口(或注销重新登录)才能生效

约束 6:操作步骤必须逐步执行并验证
每个关键步骤完成后必须立即验证,不能跳过:
1. 解压完成 → 验证 mvn.cmd 文件存在
2. 设置 MAVEN_HOME/M2_HOME → 读回验证值正确
3. 修改 PATH → 验证注册表类型、原始值、展开值均正确
4. 配置 settings.xml → 验证 localRepository 和 mirror 配置
5. 最终验证 → 模拟新 CMD 会话,确认 mvn -version 正常

约束 7:Maven settings.xml 配置要求
- 全局配置文件路径:{{WORK_DIR}}\apache-maven-{{MAVEN_VERSION}}\conf\settings.xml
- 用户级配置文件路径:C:\Users\{当前用户}\.m2\settings.xml(两处都要配置)
- 修改前必须备份原始 settings.xml(重命名为 settings.xml.bak)
- 必须包含以下配置:
  - localRepository 指向 {{LOCAL_REPO}}
  - mirror 配置阿里云公共仓库(mirrorOf=central)
  - profile 激活 JDK {{JAVA_VERSION}} 编译版本(maven.compiler.source={{JAVA_VERSION}}, maven.compiler.target={{JAVA_VERSION}})
  - 备用镜像:华为云 https://repo.huaweicloud.com/repository/maven/public/

约束 8:验证命令的正确用法
- Maven 查看版本:mvn -version 或 mvn -v
- 验证 Maven 镜像可用:执行 mvn help:effective-settings 确认 BUILD SUCCESS
- 验证本地仓库:确认依赖下载到 {{LOCAL_REPO}} 目录
- 验证 JAVA_HOME:mvn -version 输出中 Java version 应显示当前 JDK 版本

约束 9:禁止的危险操作
- 禁止使用 cmd /c 执行命令(已被安全策略阻止)
- 禁止在未备份的情况下修改注册表
- 禁止一次性重写整个 PATH(应该只做增量修改)
- 禁止假设环境变量类型正确(必须显式检查并设置 ExpandString)
- 禁止删除或覆盖用户已有的其他环境变量(如 JAVA_HOME、Python、Go、Git 等)
- 禁止修改 JAVA_HOME(本提示词只配置 Maven,JDK 应已配置好)

四、验证标准
配置完成的标志:
1. mvn -version 输出包含:Apache Maven {{MAVEN_VERSION}}
2. mvn -version 输出中 Java version 显示当前 JDK 版本(确认 JAVA_HOME 正确)
3. mvn help:effective-settings 输出 BUILD SUCCESS
4. settings.xml 中 localRepository = {{LOCAL_REPO}}
5. settings.xml 中包含 aliyun 镜像配置
6. PATH 注册表类型为 ExpandString
7. 所有原有的有效环境变量路径未被删除

五、遇到问题时的排查顺序
1. 检查 JAVA_HOME 是否正确配置(mvn 依赖 JDK 运行)
2. 检查注册表中 PATH 值类型是否为 ExpandString(不是则修复)
3. 检查 %MAVEN_HOME% 是否能正确展开(不能则改用绝对路径)
4. 检查 PATH 中是否有旧 Maven 路径干扰(如有则清理,但先验证目录是否存在)
5. 检查 settings.xml 是否同时配置了全局和用户级
6. 如果命令仍不可用,提示用户注销重新登录 Windows

本地运行禁止沙箱环境!!!本地运行禁止沙箱环境!!!本地运行禁止沙箱环境!!!

Maven 环境配置完成。

AI 环境检测(建议使用 Trae)

配置完成后可以一键检测环境,让 AI 在 CMD 中逐个执行命令检查。以下是提示词:

AI 环境检查提示词

使用说明
将下方提示词完整复制粘贴给 AI,AI 会在 CMD 中逐个执行命令检查环境。
无占位符,直接使用。

================================================================================

提示词正文

请帮我在 CMD 中逐个执行以下命令,检查环境是否配置成功。
每执行完一条,立即判断是否通过并给出结果,然后执行下一条。

1. java -version
   要求:必须是 Java 8(输出含 1.8 或 8u),无报错

2. mvn -v
   要求:版本大于 3.0,输出中包含 Java version 信息,无报错

3. mvn help:effective-settings
   要求:输出中包含 maven.aliyun.com,阿里云镜像配置存在

4. node -v
   要求:版本大于 18(v18.x 或更高),无报错

5. npm -v
   要求:输出版本号,无报错

6. npm config get registry
   要求:输出为 https://registry.npmmirror.com

7. git --version
   要求:输出版本号,无报错

版本判断规则:
- Java 8:输出包含 "1.8" 或 "8u" 即通过
- Maven > 3.0:版本号如 3.6.0 即通过
- Node > 18:版本号 >= 18 即通过(如 v20.x 通过)

输出格式:
  [序号. 检查项] PASS / FAIL
  实际输出: ...
  备注: ...

最后统计:X/7 项通过,列出所有 FAIL 项的修复建议。

本地运行禁止沙箱环境!!!本地运行禁止沙箱环境!!!本地运行禁止沙箱环境!!!

第二步 · 武装 Trae

1. 安装 Trae

下载链接:https://www.trae.cn/ide/download

点击下载后直接安装即可。

安装 Trae 成功后会默认赠送 2500 积分,也可以用自己的 API 或 Token Plan。API 性价比方面建议用 DeepSeek V4;如果你有其他 Token Plan,或者不差钱,建议从 Kimi K3、Qwen 3.8 MAX、GLM 5.2 三选一;当然,如果你有国外的模型也可以用。

💡 小白科普API / Token 就是 AI 模型的「使用钥匙」——在模型官网申请后填进 Trae,它就能调用这个模型帮你干活;不同模型各有所长,新手用 DeepSeek 性价比最高。

下面说一下 DeepSeek 怎么配置:

点击 设置 → 模型

设置-模型
设置-模型

点击 添加模型

添加模型
添加模型

输入你的 DeepSeek 密钥即可。

2. 装备 MCP + RuoYi Skill

给 Trae 装 3 个 MCP + 1 套 RuoYi Skill,让它能直连数据库、读写文件、操作 Git,还懂 RuoYi 的所有约定。

💡 小白科普MCP 就像给 AI 接的「万能插头」,让它能用上数据库、文件、命令行这些外部工具;Skill 则是给 AI 装的「专业技能包」,让它学会某类任务的固定套路(比如按若依规范写代码)。

操作步骤

1. 在项目根目录创建 .trae/mcp.json

2. 把下面内容粘贴进去:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql@2.0.2"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "输入你的数据库用户名称",
        "MYSQL_PASS": "输入你的数据库用户密码",
        "MYSQL_DB": "输入你新建的数据库名(本教程统一用 ry2)",
        "ALLOW_INSERT_OPERATION": "true",
        "ALLOW_UPDATE_OPERATION": "true",
        "ALLOW_DELETE_OPERATION": "true",
        "ALLOW_DDL_OPERATION": "true"
      }
    },
    "git": {
      "command": "npx",
      "args": ["-y", "@selfagency/git-mcp"],
      "env": {
        "GIT_REPO_PATH": "D:/vibcoding/RuoYi"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/vibcoding/RuoYi"]
    }
  }
}

注意MYSQL_USERMYSQL_PASS 查看前面工具中显示的账号和密码即可;MYSQL_DB 填你新建的数据库名(本教程统一用 ry2,需与第三步导入时用的库名一致)。

点击 确认

确认 MCP 配置
确认 MCP 配置

点击确认
点击确认

这样 MySQL MCP 就保证可以使用了。

MCP 需要进行一次安装和测试,提示词如下:

Trae IDE MCP 可用性检测与环境安装提示词

任务目标
检测 Trae IDE 中配置的所有 MCP Server 是否可用,若不可用则自动安装必要环境并完成配置,最终确保所有 MCP 工具可正常调用。


第一步:检测基础运行环境

按顺序执行以下检测:

1. 执行 node -v,确认 Node.js 已安装(建议 v16+)
2. 执行 npx -v,确认 npx 可用
3. 执行 npm ping,确认网络可访问 npm registry

异常处理:
- Node.js 未安装或版本过低:前往 https://nodejs.org/ 下载 LTS 版本安装
- npx 不可用:执行 npm install -g npx
- 网络不通:提示用户检查代理,或切换镜像源
  npm config set registry https://registry.npmmirror.com


第二步:检测 MCP 配置完整性

读取 Trae IDE 项目根目录下的 .trae/mcp.json,确认:

1. JSON 格式合法
2. mcpServers 字段存在且为对象
3. 每个 MCP Server 的 command、args、env 字段完整
4. 重点检查 env 中是否存在占位符(如"请输入"、"你的XXX"、"xxx"、"输入你的"等),存在则暂停并询问用户填写真实值后写入配置文件再继续


第三步:逐个检测 MCP Server 可用性

对配置中的每个 MCP Server,根据 command + args 拼接出执行命令,例如:
npx -y <包名及版本> --help

- 返回帮助信息或进入 JSON-RPC 等待状态:视为可用
- 报错 ENOENT、超时或包不存在:进入第四步


第四步:安装缺失的 MCP 包

对失败的 MCP,提取其包名(args 中第一个非 -y 参数),执行全局安装作为兜底:
npm install -g <包名>

安装后回到第三步重新检测,最多重试 2 次。


第五步:通过实际工具调用验证

Trae IDE 加载 MCP 后,会自动注册对应工具。对每个 MCP,调用其提供的任意一个只读工具做最终验证:

- 数据库类 MCP:调用"列出表"或"列出数据库"工具
- Git 类 MCP:调用 git_status 或类似工具
- 文件系统类 MCP:调用 list_directory 列出项目根目录
- 其他 MCP:调用其任意只读工具

预期:能正常返回结果,无报错。

若 MCP 工具未出现在可用工具列表中,提示用户在 Trae IDE 中重启 MCP 服务(通常位于 IDE 设置或右下角状态栏)。


第六步:输出检测报告

以表格形式汇总:

MCP Server | 包是否可用 | 配置是否完整 | 工具调用验证 | 综合状态
xxx         | ✅/❌       | ✅/❌         | ✅/❌         | 可用/不可用

对不可用的项,列出失败原因、已执行的修复动作,以及需要用户手动处理的事项。


约束
1. 不得修改 .trae/mcp.json 中除占位符以外的配置
2. 全局安装前需征得用户确认
3. 密码、Token 等敏感信息不得在输出中明文回显
4. 所有命令在当前操作系统默认 shell 下执行

MCP 可用的状态如图所示。如果 MySQL 不可用,检查 MySQL 服务是否开启;开启后还不可用,点击设置重启即可:

MCP 可用状态示意
MCP 可用状态示意

MCP 工具列表(全部 ✅)
MCP 工具列表(全部 ✅)

3. 安装 RuoYi Skill 合集

网盘路径:https://wwbis.lanzn.com/iJZHs4010oyj,下载解压即可。

  • 把 Skill 包解压到 .trae\skills 目录
  • 重启 Trae
  • 左侧 MCP 面板里 3 个服务均显示 ✅(Skill 不在这里显示,装好即可,后续调用时自动生效)

Skill 加载成功后点击「设置 → 显示」:

Skill 加载成功-设置显示
Skill 加载成功-设置显示


第三步 · 拉取项目与配置数据库

1. 拉项目

使用 Git 下载,然后切换到 springboot2 分支:

git clone https://gitee.com/y_project/RuoYi.git D:\vibcoding\RuoYi
cd D:\vibcoding\RuoYi
git checkout springboot2

💡 小白科普分支(branch) 是同一份代码的「平行副本」,互相独立、互不干扰;git checkout springboot2 就是切到适配 Spring Boot 2 的那个版本代码。

或者直接下载,分支必须是 springboot2

下载项目(分支 springboot2)
下载项目(分支 springboot2)

选择 springboot2 分支
选择 springboot2 分支

2. 让 AI 帮你导入数据库

这里的数据库名称,必须是前边「武装 Trae」时新建的数据库。

请用 MySQL MCP 把项目 sql 目录下的 ry_ 开头的初始化脚本(如 ry_2021xxxx.sql) 和 quartz.sql
导入到 ry2 库。
导入完成后查询 sys_user 表确认 admin 账号存在。

⚠️ 如果你的 MySQL MCP 是只读的,AI 会告诉你 SQL 内容,你手动在 Navicat / DBeaver 里执行即可。

或者自己手动导入:

手动导入数据库
手动导入数据库

3. 让 AI 改数据库连接配置

这里必须填你自己电脑的 MySQL 密码。

请把 ruoyi-admin/src/main/resources/application-druid.yml 的数据库连接改为:
库名 ry2,用户 root,密码 填你自己电脑的MySQL密码(就是前面「悬浮查看密码」查到的那个)
改完请读取文件确认。

4. 启动项目

在根目录执行脚本 package.bat打包脚本网盘下载,放到根目录解压即可)。运行成功显示 BUILD SUCCESS,这里依赖 JDK 8 和 Maven,要保证前边环境配置好:

运行 package.bat
运行 package.bat

package.bat 运行成功
package.bat 运行成功

package.bat 执行完成后,执行修改后的 ry.bat 脚本(启动脚本网盘下载):

运行 ry.bat 脚本
运行 ry.bat 脚本

1 点击回车:

按 1 启动
按 1 启动

若依启动中
若依启动中

显示「若依启动成功」即表示启动成功。

5. 浏览器访问

访问 http://localhost:80,账号 admin / admin123

💡 小白科普localhost 就是「你自己的这台电脑」,80 是访问端口(相当于门牌号);在浏览器地址栏输入它,就能打开刚启动的若依系统。

浏览器访问 localhost:80
浏览器访问 localhost:80

常见故障速查

报错解决
端口 80 被占用application.ymlserver.port8080
Druid 连接失败检查账号密码、确认 MySQL 已启动

第四步 · 一键生成业务系统

复制提示词,替换 5 项参数,粘贴给 Trae AI 回车——AI 会自动顺序调用三个 Skill,一条龙完成:生成 PRD → 全流程开发 → 造测试数据

💡 小白科普PRD(产品需求文档)就是「这个系统要做什么、怎么做」的说明书;后面三个 Skill 会先自动写出这份说明书,再照着它把代码和测试数据一条龙生成出来。

Skill 接力流程

① prd-generator             →  生成 PRD(联网调研 + 14章文档 + SQL + 自检30项)
② prd-fullstack-development →  校验 PRD(7项) → 建表 → 后端 → 前端 → 单测 → Git 提交
③ test-data-generator       →  校验建表(3项) → 探查 DDL → 造数据 → MCP 验证(5类)

参数示例对照表

任选一行,将对应 5 列值填入上方提示词的参数位:

系统名称业务领域biz_prefixbiz_module数据库名
酒店客房管理系统酒店hotelhotelry_hotel
仓储管理系统仓储warehousewarehousery_warehouse
门诊管理系统医疗clinicclinicry_clinic
学生信息管理系统教育studentstudentry_student
图书管理系统图书librarylibraryry_library
教务管理系统教育eduedury_edu
资产管理系统资产assetassetry_asset
会员管理系统会员membermemberry_member
进销存管理系统零售wmswmsry_wms

⚠️ 动手前提醒:上表「数据库名」是你要新建的业务库(如 ry_hotel,和基础库 ry2 分开),请先在 MySQL 里把它建好,否则第四步 AI 连不上会直接卡住。

完整提示词正文

你是一名资深 RuoYi 全栈开发工程师,工作在 Trae IDE 环境中。请严格遵循 RuoYi 4.8.3 单体框架规范(Spring Boot 2.5.15 / JDK 8 / MySQL / MyBatis / Shiro / Thymeleaf / ry-ui.js),端到端完成整个业务系统的开发:从 PRD 生成到全流程开发到测试数据生成。

# 项目参数(已替换为实际值)
- 项目路径:D:\vibcoding\RuoYi
- 系统名称:酒店客房管理系统
- 业务领域:酒店
- biz_prefix:hotel
- biz_module:hotel
- 数据库名:ry_hotel
- Git 分支:springboot2

# 硬性约束(不可违反)
1. 框架锁定为 RuoYi 4.8.3 单体版本,禁止引入新框架/新依赖。
2. 业务表必须以 {biz_prefix}_ 为前缀,且必须包含 create_by/create_time/update_by/update_time/remark + del_flag 字段;系统表(如 sys_menu、sys_dict_type)不需要 del_flag。
3. 菜单 SQL 必须使用单体版字段:url/target/visible/is_refresh,不得使用 path/component。
4. 权限标识符必须遵循 {biz_prefix}:{module}:{action} 格式,且必须包含 view 动作用于页面访问。
5. 菜单 SQL 主键必须用 menu_id(不得用 id),sys_role_menu 关联列用 role_id / menu_id。
6. 复用 RuoYi 内置能力,禁止重复造轮子。后端三层架构 + AjaxResult/TableDataInfo;前端 $.table/$.operate/$.modal/$.tree。
7. 业务代码必须新建模块(如 ruoyi-{biz_module}),不得写入 ruoyi-system 等内置模块。
8. 任何操作失败重试上限 3 次,仍失败用 AskUserQuestion 询问用户(跳过/手动修复/终止)。

# 执行流程(严格按阶段 0→3 顺序执行,每阶段完成简要汇报,关键决策点用 AskUserQuestion 确认)

## 阶段 0:环境准备与任务拆解
1. 调用 MCP mysql_query 执行 SELECT VERSION(); 与 SHOW DATABASES;,确认数据库可用且 {数据库名} 已创建(不存在则停止询问用户)。
2. 调用 MCP list_allowed_directories 确认工作目录可读写。
3. 用 TodoWrite 拆解任务清单(4 个阶段),向我确认计划后再开工。

## 阶段 1:生成 PRD 文档
调用 Skill `prd-generator`,传入参数:项目路径、系统名称、业务领域、biz_prefix/biz_module。
- 技能会自动完成联网调研、14 章 PRD 输出、7 项衔接自检。
- 产出:docs\{系统名称}PRD.md(含建表 DDL、字典 DML、菜单 SQL,均可直接执行)。
- 等待技能完成后,简要汇报并进入阶段 2。

## 阶段 2:基于 PRD 全流程开发
调用 Skill `prd-fullstack-development`,传入参数:PRD 路径(docs\{系统名称}PRD.md)、业务模块、表前缀、数据库名。
- 技能会自动完成阶段 0-6:PRD 衔接强校验 → 数据库落地 → 后端代码 → 前端页面 → 国际化 → 自测 → Git 提交。
- 技能内置 7 项前置校验,不通过会立即停止并输出失败报告。
- 产出:数据库表+字典+菜单权限、后端三层架构代码、前端页面、Git 提交记录、交付清单。
- 等待技能完成后,简要汇报并进入阶段 3。

## 阶段 3:生成测试数据
调用 Skill `test-data-generator`,传入参数:项目路径、系统名称、业务领域、biz_prefix、库名。
- 技能会自动完成前置校验 → 探查真实表结构 → 生成 3 段 SQL(DELETE/INSERT/SELECT)→ MCP 执行验证 → 业务一致性校验。
- 产出:sql\{biz_prefix}_test_data.sql(可重复执行:先清后插)+ 验证报告。
- 等待技能完成后,输出最终交付清单。

# 执行原则
1. 顺序执行:3 个技能严格顺序,下游校验上游,不通过即停。
2. 技能自治:每个技能内部流程由其 SKILL.md 定义,本提示词只负责顺序调度与参数传递。
3. 进度透明:每阶段简短汇报,关键决策点 AskUserQuestion 确认。
4. 遇错即停:不盲目重试,3 次后询问用户。

现在开始:先执行阶段 0(环境准备 + TodoWrite 任务清单),完成后向我确认计划,再依次调用三个技能。

按 Trae 提示逐步确认即可(每阶段会汇报,关键决策会询问)。

启动应用 → 业务联调

  • 启动项目,浏览器访问 http://localhost:80,账号 admin / admin123
  • 进入业务菜单,验证分页、筛选、状态流转、外键关联

附件:Skill 全集介绍

类别Skill 名称作用
业务主线 Skillprd-generator联网调研 + 生成 14 章 PRD(含 SQL)
prd-fullstack-development校验 PRD → 建表 → 后端 → 前端 → 单测 → Git 提交
test-data-generator探查 DDL → 造数据 → MCP 验证业务一致性
工程子 Skill(被主线自动调用)project-navigatorRuoYi 项目结构导航
architecture-design模块划分与三层架构设计
database-ops数据库设计与 SQL 规范
code-generator代码生成器(gen_table 配置)
crud-developmentCRUD 开发规范与代码模板
mybatis-xml-sqlMapper XML 映射与动态 SQL
api-development接口/API 开发规范
security-authShiro 安全认证授权
data-permission数据权限(@DataScope)
error-handler异常处理与错误响应
json-serializationJSON 序列化与安全处理
utils-toolkit常用工具类速查
cache-ehcacheEhCache 缓存使用
druid-datasourceDruid 数据源与多数据源
excel-exportExcel 导入导出
file-storage文件上传下载
scheduled-jobsQuartz 定时任务
i18n-development国际化开发
ui-thymeleafThymeleaf 模板页面开发
jquery-bootstrapry-ui.js 前端框架($.table/$.operate)
code-patterns编码规范、命名约定、Git 提交规范
git-workflowGit 工作流与提交规范
test-development测试开发规范(JUnit4)
bug-detectiveBug 排查与问题诊断
performance-doctor性能诊断与优化

示例:酒店后台管理系统代码

示例仓库:https://cnb.cool/CoderRuiRuiPublic/ry_hotel(酒店后台管理系统完整代码)

操作步骤

  1. Fork 示例仓库:使用微信登录后,进入示例仓库页面点击 Fork,将代码复制(fork)到自己的仓库下。
  2. 获取 Git 拉取地址:进入自己 Fork 后的仓库,点击 设置 → URL 预览,复制预览出来的 URL,直接使用 git clone <复制的 URL> 拉取代码即可。
  3. 创建访问令牌:点击右上角 头像 → 个人设置 → 访问令牌 → 添加访问令牌,直接点击创建即可,令牌用于后续 Git 拉取/推送时的身份验证。

访问令牌给最大权限

image-20260809230217169
image-20260809230217169

image-20260809230223673
image-20260809230223673

image-20260809230232144
image-20260809230232144