メニュー
若依(RuoYi)框架权限配置专家，专注于权限问题的诊断和解决。当用户遇到以下问题时自动触发： - 权限校验失败、Access Denied错误 - 按钮/菜单不显示 - @PreAuthorize权限标识不匹配 - v-hasPermi权限值错误 - sys_menu或sys_role_menu配置问题 - 若依框架的权限系统相关问题 - 开发新功能时的权限配置指导 使用此skill可以帮助用户快速定位权限问题根源，提供标准化的权限配置方案。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | expert-ruoyi-permission |
| description | 若依(RuoYi)框架权限配置专家，专注于权限问题的诊断和解决。当用户遇到以下问题时自动触发： - 权限校验失败、Access Denied错误 - 按钮/菜单不显示 - @PreAuthorize权限标识不匹配 - v-hasPermi权限值错误 - sys_menu或sys_role_menu配置问题 - 若依框架的权限系统相关问题 - 开发新功能时的权限配置指导 使用此skill可以帮助用户快速定位权限问题根源，提供标准化的权限配置方案。 |
⚠️ 最重要原则
sys_menu.perms = 后端@PreAuthorize = 前端v-hasPermi = API权限标识四个环节中任何一个不一致，就会出现权限问题！
┌─────────────────────────────────────────────────────────────────┐
│ 1. 数据库 sys_menu 表配置菜单/按钮权限 │
│ - menu_name: 菜单名称 │
│ - perms: 权限标识符（唯一！） │
│ - menu_type: M=目录, C=菜单, F=按钮 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 2. sys_role_menu 表分配权限 │
│ - 将菜单ID 和 角色ID 关联 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 3. 后端 Controller 使用 @PreAuthorize │
│ - 必须与 sys_menu.perms 完全一致！ │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 4. 前端 v-hasPermi 使用 │
│ - 必须与 sys_menu.perms 完全一致！ │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 5. 清除缓存 + 重新登录 │
│ - Redis 缓存或用户权限缓存 │
└─────────────────────────────────────────────────────────────────┘
错误信息：请求地址'/xxx'权限校验失败
排查步骤：
1. 查询数据库 sys_menu 表的 perms 值
SELECT menu_id, menu_name, perms FROM sys_menu WHERE perms LIKE '%关键词%';
2. 对比后端 Controller @PreAuthorize 值
@PreAuthorize("@ss.hasPermi('perms值')")
3. 对比前端 v-hasPermi 值
v-hasPermi="['perms值']"
4. 检查 sys_role_menu 是否分配
SELECT * FROM sys_role_menu WHERE menu_id = ?;
排查步骤：
1. 检查 sys_menu 表是否有 type='F' 的按钮记录
SELECT * FROM sys_menu WHERE menu_type = 'F' AND perms LIKE '%关键词%';
2. 检查按钮 perms 与前端 v-hasPermi 是否一致
3. 检查按钮是否分配给用户角色
SELECT r.role_name FROM sys_role_menu rm
JOIN sys_role r ON rm.role_id = r.role_id
WHERE rm.menu_id = (按钮的menu_id);
排查步骤：
1. 检查 sys_menu 表配置
- visible = '0' 表示显示
- visible = '1' 表示隐藏
2. 检查角色是否有该菜单权限
SELECT m.menu_name, r.role_name
FROM sys_role_menu rm
JOIN sys_menu m ON rm.menu_id = m.menu_id
JOIN sys_role r ON rm.role_id = r.role_id
WHERE m.perms = 'xxx';
3. 检查用户角色
SELECT u.user_name, r.role_name
FROM sys_user_role ur
JOIN sys_user u ON ur.user_id = u.user_id
JOIN sys_role r ON ur.role_id = r.role_id
WHERE u.user_name = 'xxx';
SELECT m.menu_id, m.menu_name, m.perms, m.menu_type
FROM sys_user_role ur
JOIN sys_role_menu rm ON ur.role_id = rm.role_id
JOIN sys_menu m ON rm.menu_id = m.menu_id
WHERE ur.user_id = (SELECT user_id FROM sys_user WHERE user_name = 'xxx')
ORDER BY m.menu_id;
SELECT r.role_id, r.role_name, m.menu_name, m.perms
FROM sys_role_menu rm
JOIN sys_role r ON rm.role_id = r.role_id
JOIN sys_menu m ON rm.menu_id = m.menu_id
WHERE m.perms = 'evaluation:approval:apply:list';
-- 给多个角色分配同一菜单权限
INSERT INTO sys_role_menu (role_id, menu_id)
SELECT role_id, 3001
FROM sys_role
WHERE role_id IN (1, 2, 100, 102);
-- 1. 创建菜单（列表页）
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component,
menu_type, visible, perms, icon, create_time)
VALUES ('项目申请', 3000, 1, 'apply-list', 'asset-evaluation-approval/apply-list',
'C', '0', 'evaluation:approval:apply:list', '#', NOW());
-- 2. 创建按钮权限（新增）
INSERT INTO sys_menu (menu_name, parent_id, order_num, path, component,
menu_type, visible, perms, icon, create_time)
VALUES ('项目申请新增', 3001, 1, '', '', 'F', '0',
'evaluation:approval:apply:add', '#', NOW());
-- 3. 分配给角色
INSERT INTO sys_role_menu (role_id, menu_id)
SELECT role_id, 3001 FROM sys_role WHERE role_id IN (1, 2);
// 后端 Controller
@PreAuthorize("@ss.hasPermi('evaluation:approval:apply:list')")
@GetMapping("/projects")
public TableDataInfo list() { ... }
@PreAuthorize("@ss.hasPermi('evaluation:approval:apply:add')")
@PostMapping
public AjaxResult add() { ... }
<!-- 前端 -->
<el-button v-hasPermi="['evaluation:approval:apply:add']">新增</el-button>
{模块}:{子模块}:{操作}:{具体操作}
示例：
| 权限标识 | 说明 |
|---|---|
evaluation:approval:apply:list | 资产评估-核准-申请-列表 |
evaluation:approval:apply:add | 资产评估-核准-申请-新增 |
evaluation:approval:apply:edit | 资产评估-核准-申请-编辑 |
evaluation:approval:apply:remove | 资产评估-核准-申请-删除 |
: 分隔层级□ 1. 在 sys_menu 表添加菜单记录
□ 2. 设置正确的 perms 权限标识
□ 3. 在 sys_role_menu 表分配给相关角色
□ 4. 后端 Controller 添加 @PreAuthorize(perms值)
□ 5. 前端组件添加 v-hasPermi="[perms值]"
□ 6. 清除 Redis 缓存
□ 7. 重新登录测试
1. 数据库 perms 值是什么？
↓
2. 后端 @PreAuthorize 值是什么？
↓
3. 前端 v-hasPermi 值是什么？
↓
4. sys_role_menu 是否有分配？
↓
5. Redis 缓存是否过期？
↓
6. 用户是否重新登录？
| 字段 | 说明 | 注意事项 |
|---|---|---|
| menu_id | 菜单ID | 主键 |
| menu_name | 菜单名称 | 显示用 |
| parent_id | 父菜单ID | 0=顶级 |
| order_num | 显示顺序 | 数字越小越靠前 |
| path | 路由路径 | 相对路径 |
| component | 组件路径 | 相对于 src/views |
| menu_type | 菜单类型 | M=目录,C=菜单,F=按钮 |
| visible | 显示状态 | 0=显示,1=隐藏 |
| status | 状态 | 0=正常,1=禁用 |
| perms | 权限标识 | 核心字段 |
| 字段 | 说明 |
|---|---|
| role_id | 角色ID |
| menu_id | 菜单ID |
// 数据库: evaluation:approval:apply:list
// 后端: @PreAuthorize("@ss.hasPermi('evaluation:approval:list')") // ❌ 少了 apply
// 正确写法
@PreAuthorize("@ss.hasPermi('evaluation:approval:apply:list')") // ✓
<!-- 数据库: evaluation:approval:apply:add -->
<!-- 前端: v-hasPermi="['eval:approval:add']" --> <!-- ❌ 前缀错误，少了 apply -->
<!-- 正确写法 -->
<v-hasPermi="['evaluation:approval:apply:add']"> <!-- ✓ -->
-- 菜单配置正确，但角色没有分配
INSERT INTO sys_menu (...) VALUES (...); -- ✓ 菜单已创建
-- 但忘记执行：
INSERT INTO sys_role_menu (role_id, menu_id) VALUES (1, 3001); -- ❌ 遗漏！
详细文档请查看：references/permission-guide.md
"PDD框架下的业务分析Skill，运用专业方法论进行需求分析和业务建模。当用户输入/analyze、/audit、/doc等命令，或需要对业务流程、管理制度、Excel表单进行专业分析时触发。支持中文触发：业务分析、需求分析、需求建模、5W1H分析、MECE、流程分析。"
"PDD熵减智能体，持续监控和偿还技术债务，防止系统腐化。当用户需要代码清理、文档更新、技术债务管理、架构对齐、熵减、垃圾回收、清理技术债务时自动触发。即使用户只说'熵减'、'清理技术债务'或'垃圾回收'，也应触发此Skill。支持中文触发：熵减、技术债务、代码清理、文档更新、架构对齐、垃圾回收。"
根据开发规格实现功能点代码的核心Skill。当用户想要开始编码实现、根据规格文档生成代码、实现功能点时调用此Skill。此Skill会自动调用pdd-template-engine生成基础代码框架，然后由software-engineer补充业务逻辑。即使只有规格文档没有明确说'实现'，只要涉及代码生成、功能开发，都应触发此Skill。支持中文触发：实现功能点、编码实现、开始编码、功能开发、代码实现、PDD实现。
PRD驱动开发的主入口Skill，协调整个开发流程。当用户想要基于PRD文档进行功能开发、从需求文档生成代码、执行PDD方法论流程、开发业务模块、实现完整功能、'搞个功能'、'资产转让'、'国有产权转让'、'帮我搞个资产转让的功能'时必须调用此Skill。即使用户没有明确说'使用PDD'，只要涉及PRD文档、需求文档、功能点开发、规格文档、模块开发、根据文档开发、业务功能实现、'开发ZCCZ'、'我想开发'、'搞个功能'等场景，都应触发此Skill。此Skill会自动协调pdd-ba、pdd-extract-features、pdd-generate-spec、pdd-implement-feature等子Skill完成从需求分析到代码交付的完整流程。注意：单一接口设计、调试问题、文档查询等场景不应触发此Skill。支持中文触发：PRD驱动开发、PDD开发、功能开发、启动PDD。
"交通事故责任评估与判定专业技能。当用户需要交通事故责任分析、事故现场照片评估、交通法规咨询、事故责任划分、法律依据查询时触发此技能。适用于车辆碰撞事故、行人事故、非机动车事故等各类道路交通事故的责任认定场景。无论用户使用'交通事故'、'车祸'、'责任判定'、'交通法规'、'事故定责'等何种表述，只要涉及交通事故评估或责任认定，均应调用此技能。支持中文触发：交通事故、车祸、责任判定、交通法规、事故定责、责任划分、事故评估、追尾、碰撞、违章、赔偿。"
自动化重构专家技能，将收集到的质量改进任务转化为具体的代码操作。当用户需要代码重构、消除重复、简化复杂度时自动触发。即使用户只说'重构代码'、'消除重复'或'简化代码'，也应触发此Skill。支持中文触发：重构代码、消除重复、简化复杂度、自动重构、代码重构、PDD重构。