leniu-dev 2.0.0

package/.codex/skills/openspec-verify-change/SKILL.md

@@ -0,0 +1,176 @@
+---
+name: openspec-verify-change
+description: |
+  Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.
+
+  触发场景：
+  - 实现完成后需要验证是否与规格一致
+  - 归档前检查任务完成度和代码正确性
+  - 需要生成变更的完整性/正确性/一致性报告
+
+  触发词：验证变更、验证、opsx:verify、openspec verify、检查实现、校验变更、验收
+license: MIT
+compatibility: Requires openspec CLI.
+metadata:
+  author: openspec
+  version: "1.0"
+  generatedBy: "1.1.1"
+---
+
+Verify that an implementation matches the change artifacts (specs, tasks, design).
+
+**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
+
+**Steps**
+
+1. **If no change name provided, prompt for selection**
+
+   Run `openspec list --json` to get available changes. Use the **AskUserQuestion tool** to let the user select.
+
+   Show changes that have implementation tasks (tasks artifact exists).
+   Include the schema used for each change if available.
+   Mark changes with incomplete tasks as "(In Progress)".
+
+   **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
+
+2. **Check status to understand the schema**
+   ```bash
+   openspec status --change "<name>" --json
+   ```
+   Parse the JSON to understand:
+   - `schemaName`: The workflow being used (e.g., "spec-driven")
+   - Which artifacts exist for this change
+
+3. **Get the change directory and load artifacts**
+
+   ```bash
+   openspec instructions apply --change "<name>" --json
+   ```
+
+   This returns the change directory and context files. Read all available artifacts from `contextFiles`.
+
+4. **Initialize verification report structure**
+
+   Create a report structure with three dimensions:
+   - **Completeness**: Track tasks and spec coverage
+   - **Correctness**: Track requirement implementation and scenario coverage
+   - **Coherence**: Track design adherence and pattern consistency
+
+   Each dimension can have CRITICAL, WARNING, or SUGGESTION issues.
+
+5. **Verify Completeness**
+
+   **Task Completion**:
+   - If tasks.md exists in contextFiles, read it
+   - Parse checkboxes: `- [ ]` (incomplete) vs `- [x]` (complete)
+   - Count complete vs total tasks
+   - If incomplete tasks exist:
+     - Add CRITICAL issue for each incomplete task
+     - Recommendation: "Complete task: <description>" or "Mark as done if already implemented"
+
+   **Spec Coverage**:
+   - If delta specs exist in `openspec/changes/<name>/specs/`:
+     - Extract all requirements (marked with "### Requirement:")
+     - For each requirement:
+       - Search codebase for keywords related to the requirement
+       - Assess if implementation likely exists
+     - If requirements appear unimplemented:
+       - Add CRITICAL issue: "Requirement not found: <requirement name>"
+       - Recommendation: "Implement requirement X: <description>"
+
+6. **Verify Correctness**
+
+   **Requirement Implementation Mapping**:
+   - For each requirement from delta specs:
+     - Search codebase for implementation evidence
+     - If found, note file paths and line ranges
+     - Assess if implementation matches requirement intent
+     - If divergence detected:
+       - Add WARNING: "Implementation may diverge from spec: <details>"
+       - Recommendation: "Review <file>:<lines> against requirement X"
+
+   **Scenario Coverage**:
+   - For each scenario in delta specs (marked with "#### Scenario:"):
+     - Check if conditions are handled in code
+     - Check if tests exist covering the scenario
+     - If scenario appears uncovered:
+       - Add WARNING: "Scenario not covered: <scenario name>"
+       - Recommendation: "Add test or implementation for scenario: <description>"
+
+7. **Verify Coherence**
+
+   **Design Adherence**:
+   - If design.md exists in contextFiles:
+     - Extract key decisions (look for sections like "Decision:", "Approach:", "Architecture:")
+     - Verify implementation follows those decisions
+     - If contradiction detected:
+       - Add WARNING: "Design decision not followed: <decision>"
+       - Recommendation: "Update implementation or revise design.md to match reality"
+   - If no design.md: Skip design adherence check, note "No design.md to verify against"
+
+   **Code Pattern Consistency**:
+   - Review new code for consistency with project patterns
+   - Check file naming, directory structure, coding style
+   - If significant deviations found:
+     - Add SUGGESTION: "Code pattern deviation: <details>"
+     - Recommendation: "Consider following project pattern: <example>"
+
+8. **Generate Verification Report**
+
+   **Summary Scorecard**:
+   ```
+   ## Verification Report: <change-name>
+
+   ### Summary
+   | Dimension    | Status           |
+   |--------------|------------------|
+   | Completeness | X/Y tasks, N reqs|
+   | Correctness  | M/N reqs covered |
+   | Coherence    | Followed/Issues  |
+   ```
+
+   **Issues by Priority**:
+
+   1. **CRITICAL** (Must fix before archive):
+      - Incomplete tasks
+      - Missing requirement implementations
+      - Each with specific, actionable recommendation
+
+   2. **WARNING** (Should fix):
+      - Spec/design divergences
+      - Missing scenario coverage
+      - Each with specific recommendation
+
+   3. **SUGGESTION** (Nice to fix):
+      - Pattern inconsistencies
+      - Minor improvements
+      - Each with specific recommendation
+
+   **Final Assessment**:
+   - If CRITICAL issues: "X critical issue(s) found. Fix before archiving."
+   - If only warnings: "No critical issues. Y warning(s) to consider. Ready for archive (with noted improvements)."
+   - If all clear: "All checks passed. Ready for archive."
+
+**Verification Heuristics**
+
+- **Completeness**: Focus on objective checklist items (checkboxes, requirements list)
+- **Correctness**: Use keyword search, file path analysis, reasonable inference - don't require perfect certainty
+- **Coherence**: Look for glaring inconsistencies, don't nitpick style
+- **False Positives**: When uncertain, prefer SUGGESTION over WARNING, WARNING over CRITICAL
+- **Actionability**: Every issue must have a specific recommendation with file/line references where applicable
+
+**Graceful Degradation**
+
+- If only tasks.md exists: verify task completion only, skip spec/design checks
+- If tasks + specs exist: verify completeness and correctness, skip design
+- If full artifacts: verify all three dimensions
+- Always note which checks were skipped and why
+
+**Output Format**
+
+Use clear markdown with:
+- Table for summary scorecard
+- Grouped lists for issues (CRITICAL/WARNING/SUGGESTION)
+- Code references in format: `file.ts:123`
+- Specific, actionable recommendations
+- No vague suggestions like "consider reviewing"

package/.codex/skills/performance-doctor/SKILL.md

@@ -0,0 +1,297 @@
+---
+name: performance-doctor
+description: |
+  后端性能问题诊断与优化。包含 SQL 优化、缓存策略、批量操作优化、接口优化、日志分析。
+
+  触发场景:
+  - 接口响应慢
+  - SQL 慢查询优化
+  - 缓存策略设计
+  - 分页查询优化
+  - N+1 查询问题
+  - 批量操作超时
+
+  触发词:性能优化、慢查询、SQL优化、索引优化、缓存、Redis缓存、N+1、分页优化、EXPLAIN、响应慢、批量操作
+
+  注意:如果是排查功能性 Bug(代码报错、逻辑错误),请使用 bug-detective。
+---
+
+# 后端性能优化指南
+
+## 诊断流程
+
+```
+1. 定位 -> 接口层面(响应时间) / SQL层面(慢查询) / 缓存层面(命中率)
+2. 分析 -> SQL 日志 / Arthas JVM 诊断 / 日志分析
+3. 优化 -> 索引 / 缓存 / 批量处理
+4. 验证 -> 对比优化前后指标
+```
+
+### 性能指标
+
+| 指标 | 良好 | 需优化 | 工具 |
+|------|------|--------|------|
+| 接口响应 | < 200ms | > 500ms | p6spy/SkyWalking |
+| 数据库查询 | < 50ms | > 200ms | SQL 日志 |
+| 内存使用 | < 70% | > 85% | Arthas/JVM 监控 |
+
+---
+
+## 1. MyBatis-Plus 查询优化
+
+### 查询构建规范
+
+```java
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+
+private LambdaQueryWrapper<XxxEntity> buildQueryWrapper(XxxQueryDTO query) {
+    LambdaQueryWrapper<XxxEntity> lqw = Wrappers.lambdaQuery();
+    lqw.eq(query.getDeptId() != null, XxxEntity::getDeptId, query.getDeptId());
+    lqw.like(StrUtil.isNotBlank(query.getKeyword()), XxxEntity::getName, query.getKeyword());
+    lqw.between(query.getStartTime() != null && query.getEndTime() != null,
+        XxxEntity::getCreateTime, query.getStartTime(), query.getEndTime());
+    return lqw;
+}
+```
+
+### 更新构建规范
+
+```java
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+
+// 精确更新
+baseMapper.update(null,
+    new LambdaUpdateWrapper<XxxEntity>()
+        .set(XxxEntity::getStatus, status)
+        .eq(XxxEntity::getId, id));
+
+// 条件更新（非null才设置）
+baseMapper.update(null,
+    new LambdaUpdateWrapper<XxxEntity>()
+        .set(ObjectUtil.isNotNull(entity.getName()), XxxEntity::getName, entity.getName())
+        .set(XxxEntity::getPhone, entity.getPhone())
+        .eq(XxxEntity::getId, entity.getId()));
+```
+
+### 批量更新
+
+```java
+import com.baomidou.mybatisplus.extension.toolkit.Db;
+
+// 推荐：Db 工具类批量更新
+Db.updateBatchById(entityList);
+
+// 避免：循环单个更新（N次数据库访问）
+```
+
+### N+1 查询修复
+
+```java
+// ❌ 错误：循环查询
+for (Order order : orders) {
+    User user = userMapper.selectById(order.getUserId());
+}
+
+// ✅ 正确：批量查询 + Map 映射
+List<Long> userIds = orders.stream().map(Order::getUserId).distinct().toList();
+Map<Long, User> userMap = userMapper.selectBatchIds(userIds).stream()
+    .collect(Collectors.toMap(User::getId, Function.identity()));
+for (Order order : orders) {
+    User user = userMap.get(order.getUserId());
+}
+```
+
+---
+
+## 2. 缓存优化
+
+### Redisson 缓存操作
+
+```java
+import org.redisson.api.RedissonClient;
+import org.redisson.api.RBucket;
+
+// 设置缓存
+RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
+bucket.set(userVo, Duration.ofMinutes(30));
+
+// 获取缓存
+UserVo cached = redissonClient.<UserVo>getBucket("user:" + id).get();
+
+// 删除缓存
+redissonClient.getBucket("user:" + id).delete();
+```
+
+### Spring Cache 注解
+
+```java
+@Cacheable(value = "user", key = "#id")
+public UserVo getById(Long id) { ... }
+
+@CacheEvict(value = "user", key = "#bo.id")
+public int update(UserBo bo) { ... }
+```
+
+> **@Cacheable 禁止返回不可变集合**（`List.of()`、`Set.of()`），Redis 反序列化会失败。必须用 `new ArrayList<>(List.of(...))`。
+
+### 分布式锁
+
+```java
+import org.redisson.api.RLock;
+
+// 注入 RedissonClient
+RLock lock = redissonClient.getLock("lock:order:" + orderId);
+try {
+    if (lock.tryLock(3, 10, TimeUnit.SECONDS)) {
+        try {
+            // 业务逻辑
+        } finally {
+            if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                lock.unlock();
+            }
+        }
+    } else {
+        throw new [你的异常类]("业务处理中，请稍后再试");
+    }
+} catch (InterruptedException e) {
+    Thread.currentThread().interrupt();
+    throw new [你的异常类]("操作被中断");
+}
+```
+
+### 限流
+
+```java
+import org.redisson.api.RRateLimiter;
+import org.redisson.api.RateType;
+import org.redisson.api.RateIntervalUnit;
+
+RRateLimiter limiter = redissonClient.getRateLimiter("api:rate:" + userId);
+limiter.trySetRate(RateType.OVERALL, 100, 60, RateIntervalUnit.SECONDS);
+if (!limiter.tryAcquire()) {
+    throw new [你的异常类]("请求过于频繁");
+}
+```
+
+### 本地缓存（Caffeine）
+
+```java
+import com.github.benmanes.caffeine.cache.Cache;
+import com.github.benmanes.caffeine.cache.Caffeine;
+
+private final Cache<Long, UserVo> localCache = Caffeine.newBuilder()
+    .maximumSize(1000)
+    .expireAfterWrite(5, TimeUnit.MINUTES)
+    .build();
+
+public UserVo getUser(Long id) {
+    return localCache.get(id, key -> {
+        RBucket<UserVo> bucket = redissonClient.getBucket("user:" + id);
+        UserVo cached = bucket.get();
+        return cached != null ? cached : baseMapper.selectById(id);
+    });
+}
+```
+
+---
+
+## 3. 索引优化
+
+```sql
+-- 为高频查询字段添加索引
+CREATE INDEX idx_status ON xxx_table(status);
+
+-- 复合索引：遵循最左前缀原则
+CREATE INDEX idx_status_create_time ON xxx_table(status, create_time);
+
+-- 使用 EXPLAIN 分析查询
+EXPLAIN SELECT * FROM xxx_table WHERE status = 1 AND create_time > '2026-01-01';
+```
+
+---
+
+## 4. 批量操作优化
+
+```java
+// 推荐：分批处理（每批500条）
+public void batchInsert(List<XxxEntity> list) {
+    int batchSize = 500;
+    for (int i = 0; i < list.size(); i += batchSize) {
+        int end = Math.min(i + batchSize, list.size());
+        baseMapper.insertBatch(list.subList(i, end));
+    }
+}
+
+// 批量更新同理
+@Transactional(rollbackFor = Exception.class)
+public void batchUpdate(List<XxxDTO> list) {
+    int batchSize = 500;
+    for (int i = 0; i < list.size(); i += batchSize) {
+        int end = Math.min(i + batchSize, list.size());
+        List<XxxEntity> batch = list.subList(i, end).stream()
+            .map(dto -> BeanUtil.copyProperties(dto, XxxEntity.class))
+            .toList();
+        Db.updateBatchById(batch);
+    }
+}
+```
+
+---
+
+## 5. 性能日志分析
+
+### SQL 监控
+
+开发环境 p6spy 默认开启：`spring.datasource.dynamic.p6spy: true`
+
+日志格式：
+```
+2026-01-08 22:12:10 [req-123] [...] INFO p6spy - Consume Time:245 ms
+Execute SQL:SELECT * FROM user WHERE status = 1
+```
+
+### 分析命令
+
+```bash
+# 慢 SQL（>200ms）
+grep "Consume Time" ./logs/console.log | grep -E "Consume Time:[2-9][0-9]{2,}|[0-9]{4,}"
+
+# N+1 检测（同一 SQL 重复多次）
+grep "Execute SQL" ./logs/console.log | sed 's/WHERE.*/WHERE .../' | sort | uniq -c | sort -rn | head -20
+
+# 错误日志
+grep "ERROR" ./logs/console.log | tail -50
+```
+
+### AI 主动读日志的触发条件
+
+| 场景 | 关键词 | 分析重点 |
+|------|--------|---------|
+| 接口慢 | "接口慢"、"超时" | SQL 执行时间、N+1 查询 |
+| SQL 慢 | "SQL慢"、"查询慢" | p6spy Consume Time |
+| 内存/CPU | "内存高"、"卡顿" | OOM、GC、线程池满 |
+| 频繁报错 | "一直报错" | ERROR 日志、异常频率 |
+
+---
+
+## 常见问题速查
+
+| 问题 | 原因 | 方案 |
+|------|------|------|
+| 接口响应慢 | SQL 无索引 | 添加索引，EXPLAIN 分析 |
+| 接口响应慢 | N+1 查询 | 批量查询 + Map 映射 |
+| 接口响应慢 | 未缓存 | Redisson 或 @Cacheable |
+| 分页查询慢 | 深分页 | 游标分页或限制页码 |
+| 批量操作超时 | 数据量太大 | 分批500条处理 |
+| 内存溢出 | 大数据量一次加载 | 分批/流式处理 |
+
+---
+
+## 监控工具
+
+| 工具 | 用途 | 使用方式 |
+|------|------|---------|
+| **p6spy** | SQL 监控、执行时间 | 开发环境默认开启 |
+| **Arthas** | JVM 诊断、火焰图 | `java -jar arthas-boot.jar` |
+| **SkyWalking** | 分布式链路追踪 | 需单独部署 |

package/.codex/skills/progress/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: progress
+description: |
+  当需要分析项目开发进度、查看模块完成情况时自动使用此 Skill。
+
+  触发场景：
+  - 需要查看项目整体开发进度
+  - 需要分析各模块的完成度
+  - 需要统计代码中的 TODO/FIXME
+  - 需要生成项目进度报告
+
+  触发词：项目进度、progress、进度报告、完成度、开发进度、模块进度、进度分析、进度梳理
+---
+
+# /progress - 项目进度梳理
+
+作为项目进度分析助手，帮您快速分析后端开发进度、识别完成度和待办事项。
+
+## 🎯 执行流程
+
+### 第一步：扫描后端模块（强制执行）
+
+```bash
+# 查找所有业务模块
+Glob pattern: "ruoyi-modules/ruoyi-*/src/main/java/**/controller/*Controller.java"
+
+# 排除系统模块（不统计进度）
+# - ruoyi-system （系统管理框架）
+# - ruoyi-generator （代码生成器）
+# - ruoyi-common （公共库）
+```
+
+自动检测到的模块示例：
+- `ruoyi-demo`
+- `ruoyi-business`
+- 其他自定义业务模块
+
+### 第二步：分析代码完整性
+
+对每个功能检查 **7 个必需的文件**：
+
+| 类型 | 文件 | 完整文件路径 | 必须 | 说明 |
+|------|------|------------|------|------|
+| Entity | `Xxx.java` | `domain/Xxx.java` | ✅ | 数据模型 |
+| BO | `XxxBo.java` | `domain/bo/XxxBo.java` | ✅ | 业务对象 |
+| VO | `XxxVo.java` | `domain/vo/XxxVo.java` | ✅ | 视图对象 |
+| Service 接口 | `IXxxService.java` | `service/IXxxService.java` | ✅ | 服务定义 |
+| Service 实现 | `XxxServiceImpl.java` | `service/impl/XxxServiceImpl.java` | ✅ | 服务实现 |
+| Mapper | `XxxMapper.java` | `mapper/XxxMapper.java` | ✅ | 数据访问 |
+| Controller | `XxxController.java` | `controller/XxxController.java` | ✅ | 接口层 |
+
+### 第三步：扫描代码待办（TODO/FIXME）
+
+```bash
+# 扫描需要处理的代码注释
+Grep pattern: "TODO:|FIXME:" path: ruoyi-modules/ glob: "*.java" output_mode: content -B 1
+```
+
+### 第四步：代码质量分析
+
+```bash
+# 检查代码规范性
+Grep pattern: "package com\.ruoyi\." path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
+Grep pattern: "BeanUtil\.copy|BeanUtils\.copy" path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
+```
+
+---
+
+## 📊 输出格式
+
+```markdown
+# 📊 项目进度报告
+
+**生成时间**：YYYY-MM-DD HH:mm
+**检查范围**：全量后端代码
+
+---
+
+## 🎯 项目概况
+
+- **项目名称**：RuoYi-Vue-Plus 纯后端版
+- **技术栈**：Spring Boot 3 + MyBatis Plus + Sa-Token
+- **数据库**：MySQL/MariaDB
+- **当前阶段**：[开发中/测试中/已上线]
+
+---
+
+## 📈 后端模块进度汇总
+
+| 模块 | 功能数 | 完成数 | 完成率 | 状态 |
+|------|--------|--------|--------|------|
+| demo | 3 | 3 | 100% | ✅ 已完成 |
+| business | 5 | 3 | 60% | 🔄 进行中 |
+| **合计** | **8** | **6** | **75%** | 🔄 进行中 |
+
+---
+
+## 📋 功能详情分析
+
+### demo 模块 (100% 完成)
+
+| 功能 | Entity | BO | VO | Service | Mapper | Controller | 完成度 |
+|------|--------|----|----|---------|--------|------------|--------|
+| Notice | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
+| Config | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
+| Test | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 100% |
+
+---
+
+## 🔍 代码质量分析
+
+| 指标 | 评分 | 说明 |
+|------|------|------|
+| 代码规范性 | 良好 ✅ | 包名规范、类名规范 |
+| 注释完整度 | 待补充 ⚠️ | 部分功能缺少业务注释 |
+| 权限注解完整度 | 需改进 ⚠️ | 部分接口缺少 @SaCheckPermission |
+| 对象转换规范 | 良好 ✅ | 正确使用 MapstructUtils |
+
+---
+
+## 📝 代码待办事项
+
+### TODO 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `UserServiceImpl.java` | 87 | TODO | 优化用户查询性能 | 中 |
+
+### FIXME 项 (X 个)
+
+| 文件 | 行号 | 类型 | 内容 | 优先级 |
+|------|------|------|------|--------|
+| `PaymentService.java` | 156 | FIXME | 修复退款金额计算错误 | 高 |
+
+---
+
+## 💡 改进建议
+
+### 高优先级（需立即处理）
+
+1. **补充缺失的 BO/VO**
+2. **完善权限注解**
+3. **修复 FIXME 问题**
+
+### 中优先级（逐步完善）
+
+1. **补充接口注释**
+2. **优化查询性能**
+
+---
+
+## 📊 完成度判定标准
+
+| 完成率 | 状态 | 说明 | 推荐行动 |
+|--------|------|------|---------|
+| 100% | ✅ 已完成 | 全部 7 个文件均已完成 | 可进行代码审查 |
+| 71-99% | 🟢 基本完成 | 缺少 1-2 个文件 | 补充缺失文件 |
+| 50-70% | 🟡 进行中 | 缺少 2-3 个文件 | 加快开发进度 |
+| 1-49% | 🔴 早期阶段 | 仅有少量文件 | 继续开发 |
+| 0% | ⚫ 待开发 | 无相关文件 | 使用 `/dev` 开始开发 |
+
+---
+
+## 🚀 快速操作
+
+```bash
+# 1. 快速生成缺失功能
+/crud Payment
+
+# 2. 检查并修复代码规范
+/check business
+
+# 3. 继续开发新功能
+/dev 新功能名称
+```
+```
+
+---
+
+## 使用示例
+
+```
+用户：/progress
+用户：/progress business （仅检查 business 模块）
+用户：/progress demo （仅检查 demo 模块）
+
+Claude：
+🔍 正在扫描项目结构...
+📊 分析代码完整性...
+🔍 扫描代码待办事项...
+
+[输出完整的进度报告]
+```