leniu-dev 2.0.0

package/.codex/skills/add-todo/SKILL.md

@@ -0,0 +1,269 @@
+---
+name: add-todo
+description: |
+  当需要快速添加待办任务、记录开发事项时自动使用此 Skill。
+
+  触发场景：
+  - 需要快速添加一个待办任务
+  - 需要记录开发中发现的问题
+  - 需要批量添加多个待办事项
+  - 需要为特定模块添加任务
+
+  触发词：添加待办、add-todo、待办事项、任务添加、记录任务、新增待办、快速待办
+---
+
+# /add-todo - 快速添加待办事项
+
+作为待办事项管理助手，帮我快速添加待办任务。支持自动创建缺失文档、联动项目状态。
+
+---
+
+## 使用方式
+
+```bash
+/add-todo 实现用户权限管理
+/add-todo 修复登录bug，优先级高
+/add-todo 优化接口性能，3天，中等优先级
+/add-todo ruoyi-demo 实现测试功能
+/add-todo ruoyi-system 修复缓存问题，高，截止1月30号
+```
+
+---
+
+## 第一步：智能检测文档状态
+
+### 检查待办清单.md
+
+如果 `docs/待办清单.md` 不存在：
+1. 读取模板 `.claude/templates/待办清单模板.md`
+2. 替换时间占位符为当前时间
+3. 创建 `docs/待办清单.md`
+4. 输出提示：`📝 已自动创建 docs/待办清单.md`
+
+---
+
+## 第二步：解析任务信息
+
+### 从用户输入中提取
+
+| 信息 | 解析方式 | 默认值 |
+|------|---------|--------|
+| 任务名称 | 必填，主体内容 | - |
+| 优先级 | "高"/"中"/"低"，或"紧急"/"重要" | 中 |
+| 预计时间 | "X天"/"X周" | 待定 |
+| 所属模块 | 模块名前缀如"ruoyi-demo"、"ruoyi-system" | 通用 |
+| 截止日期 | "截止XX"或"deadline XX" | 待定 |
+
+### 优先级映射
+
+| 用户输入 | 映射到 |
+|---------|--------|
+| 高、紧急、urgent、critical、ASAP | 🔥 高优先级 |
+| 中、一般、normal、默认 | 📌 中优先级 |
+| 低、可延后、optional、nice-to-have | 💡 低优先级 |
+
+### 模块识别
+
+| 用户输入 | 识别结果 |
+|---------|---------|
+| `ruoyi-demo 测试功能` | 模块: ruoyi-demo |
+| `ruoyi-system 用户管理` | 模块: ruoyi-system |
+| `后端 权限管理` | 模块: 后端 |
+| `权限管理` | 模块: 通用（无前缀） |
+
+---
+
+## 第三步：添加到待办清单.md
+
+### 读取现有内容
+- 读取 `docs/待办清单.md`
+- 解析各优先级区域的位置
+
+### 添加任务
+
+根据优先级添加到对应区域：
+
+```markdown
+## 🔥 高优先级（紧急重要）
+- [ ] [任务名称]
+  - 截止日期: YYYY-MM-DD（如果有）
+  - 描述: [任务描述]（如果有）
+  - 所属模块: ruoyi-xxx（如果识别到）
+  - 预计工作量: X天（如果有）
+  - 添加时间: YYYY-MM-DD HH:MM
+
+## 📌 中优先级（重要不紧急）
+...
+
+## 💡 低优先级（可延后）
+...
+```
+
+### 更新统计信息
+- 更新"待办总数": X 项
+- 更新"最后更新": 当前时间
+
+---
+
+## 第四步：联动更新项目状态.md（如果存在）
+
+### 检查项目状态.md
+
+如果 `docs/项目状态.md` 存在：
+1. 读取项目状态文档
+2. 将新任务添加到"待办"区域
+3. 格式与待办清单保持一致
+
+### 添加格式
+
+```markdown
+## 📋 待办
+- [ ] [任务名称]
+  - 优先级: 高/中/低
+  - 预计工作量: X天
+  - 所属模块: ruoyi-xxx
+```
+
+---
+
+## 第五步：输出确认信息
+
+```markdown
+✅ 已添加待办任务：
+
+📌 **[任务名称]**
+- 优先级: 高/中/低
+- 预计时间: X天
+- 所属模块: ruoyi-xxx（如果有）
+- 截止日期: YYYY-MM-DD（如果有）
+
+📁 已更新文件:
+- docs/待办清单.md
+- docs/项目状态.md（如果存在）
+
+📊 当前待办总数: X 项
+```
+
+---
+
+## 批量添加支持
+
+### 多任务添加
+
+用户可以一次添加多个任务：
+
+```bash
+/add-todo 实现用户登录；实现用户注册；实现密码重置
+```
+
+或分行：
+
+```
+/add-todo
+1. 实现用户登录，高优先级
+2. 实现用户注册，中优先级
+3. 实现密码重置，低优先级
+```
+
+### 处理方式
+- 按分号、换行、数字编号分割
+- 依次解析每个任务
+- 批量添加并汇总报告
+
+---
+
+## 智能建议
+
+### 添加后提示
+
+添加任务后，根据情况给出建议：
+
+**待办过多时（>15项）**：
+```
+💡 提示：当前待办已有 18 项，建议：
+- 运行 /progress 梳理优先级
+- 考虑将低优先级任务归档
+```
+
+**高优先级过多时（>5项）**：
+```
+⚠️ 提示：高优先级任务已有 6 项
+建议重新评估优先级，确保"紧急"真正紧急
+```
+
+**相似任务检测**：
+```
+💡 提示：检测到相似待办：
+- 已有: "实现用户登录功能"
+- 新增: "用户登录"
+是否为同一任务？
+```
+
+---
+
+## 示例
+
+### 示例 1：简单添加
+
+```
+用户: /add-todo 修复通知发送错误
+
+AI: ✅ 已添加待办任务：
+
+📌 **修复通知发送错误**
+- 优先级: 中
+- 预计时间: 待定
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新: docs/待办清单.md
+📊 当前待办总数: 8 项
+```
+
+### 示例 2：带参数添加
+
+```
+用户: /add-todo ruoyi-demo 实现导出功能，高优先级，2天
+
+AI: ✅ 已添加待办任务：
+
+🔥 **实现导出功能**
+- 优先级: 高
+- 预计时间: 2天
+- 所属模块: ruoyi-demo
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新:
+- docs/待办清单.md
+- docs/项目状态.md
+
+📊 当前待办总数: 9 项
+```
+
+### 示例 3：自动创建文档
+
+```
+用户: /add-todo 开发后端接口文档
+
+AI: 📝 已自动创建 docs/待办清单.md
+
+✅ 已添加待办任务：
+
+📌 **开发后端接口文档**
+- 优先级: 中
+- 预计时间: 待定
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新: docs/待办清单.md
+📊 当前待办总数: 1 项
+```
+
+---
+
+## 与其他命令的关系
+
+| 命令 | 关系 |
+|------|------|
+| `/update-status` | 批量同步 TODO，/add-todo 是单个添加 |
+| `/init-docs` | 初始化文档，/add-todo 可自动补充创建 |
+| `/progress` | 查看进度，包含待办统计 |
+| `/sync` | 全量同步，确保数据一致 |

package/.codex/skills/analyze-requirements/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: analyze-requirements
+description: |
+  需求分析全流程编排。根据输入类型自动调度 Agent 获取数据，输出结构化需求报告和开发任务清单。
+
+  触发场景：
+  - 收到 Axure 原型截图需要分析需求
+  - 需要将产品需求转化为开发任务
+  - 云效任务需要拆解为开发步骤
+  - 需求评审前需要结构化分析
+
+  触发词：分析需求、需求分析、原型分析、需求拆解、分析原型图
+---
+
+# 需求分析全流程
+
+## 核心原则
+
+**先判断复杂度，简单需求直接分析，复杂需求走 Agent 编排。分析完成后推荐开发流程。**
+
+## 步骤 0：复杂度判断（必须先做）
+
+```
+用户提供需求线索
+  │
+  ├─ 简单需求？ ──→ 快速路径（直接分析输出任务清单）
+  │   - 纯文字描述，功能明确
+  │   - 单表 CRUD，无需看原型图
+  │   - 用户已给出完整字段列表
+  │
+  └─ 复杂需求？ ──→ Agent 路径（启动 requirements-analyzer）
+      - 提供了 Axure 原型截图
+      - 提供了云效任务编号
+      - 多页面/多模块联动
+      - 业务流程复杂，需要状态流转设计
+```
+
+## 快速路径（简单需求）
+
+```
+理解需求 → 设计表结构 → 列出接口清单 → 输出任务清单 → 推荐 /crud 或 /dev
+```
+
+不启动 Agent，直接在主对话中完成。输出格式参考下方"输出规范"。
+
+## Agent 路径（复杂需求）
+
+```
+步骤 1：收集信息（从用户消息中提取）
+  - Axure 原型截图路径
+  - 云效任务编号
+  - 需求描述文字
+  - 关联模块信息
+
+步骤 2：启动 requirements-analyzer Agent
+  └── requirements-analyzer(Opus) 内部自动编排：
+      ├── image-reader(Haiku) × N张 → 提取原型图结构（有截图时）
+      ├── task-fetcher(Haiku) → 获取云效任务详情（有任务号时）
+      └── 汇总分析 → 输出需求报告 + 任务清单
+
+步骤 3：Opus 主会话接收报告 → 推荐开发流程
+```
+
+## Agent 启动规则
+
+### 按信息量决定启动方式
+
+| 用户提供的信息 | 启动方式 |
+|---------------|---------|
+| 只有文字描述 | 快速路径（不启动 Agent） |
+| 文字 + 原型截图 | requirements-analyzer → 内部调 image-reader |
+| 文字 + 云效任务号 | requirements-analyzer → 内部调 task-fetcher |
+| 原型截图 + 云效任务号 | requirements-analyzer → 内部并行调 image-reader + task-fetcher |
+
+### 启动示例
+
+```
+# 有原型截图
+Agent(subagent_type="requirements-analyzer",
+  prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
+  截图路径：/path/to/image1.png, /path/to/image2.png
+  需求描述：xxx")
+
+# 有云效任务
+Agent(subagent_type="requirements-analyzer",
+  prompt="获取云效任务 SARW-456 的详情，结合以下需求描述分析：xxx")
+```
+
+## 输出规范
+
+无论走快速路径还是 Agent 路径，最终输出必须包含：
+
+1. **业务概述** — 一段话描述需求
+2. **数据库设计** — 建表 SQL（遵循项目规范）
+3. **接口清单** — 路由 + 方法 + 说明
+4. **开发任务拆解** — 按依赖排序的任务列表
+5. **推荐开发流程** — 根据复杂度推荐
+
+### 复杂度 → 开发流程推荐
+
+| 复杂度 | 推荐流程 |
+|--------|---------|
+| 轻量（单表 CRUD） | `/crud` 生成 + `/dev` 补充 |
+| 中等（2-3 表联动） | `/dev` 按任务逐步开发 |
+| 复杂（多模块协作） | OpenSpec `/opsx:new` → `/opsx:ff` → `/opsx:apply` |
+
+## 注意
+
+- 简单需求不要过度编排，直接分析就行
+- 与 `bug-detective` / `fix-bug` 的区别：本技能面向**新功能开发前的需求分析**，不涉及 Bug 排查
+- 数据库设计必须遵循项目规范（雪花 ID、审计字段、del_flag=2 正常）
+- 如果需求信息不完整，主动列出需要确认的点，而不是猜测

package/.codex/skills/api-development/SKILL.md

@@ -0,0 +1,315 @@
+---
+name: api-development
+description: |
+  后端 API 接口设计规范。基于 Spring Boot 的 RESTful API 开发指南。
+
+  触发场景：
+  - 设计 RESTful API 接口
+  - 编写 Controller 层代码
+  - 配置接口权限、日志注解
+  - 接口返回值类型选择
+  - 数据验证和参数校验
+
+  触发词：API、接口、RESTful、Controller、GetMapping、PostMapping、权限注解、日志注解、分页查询、接口规范
+
+  注意：
+  - 参考项目实际架构层次选择合适的分层模式
+---
+
+# API 接口设计规范
+
+## 核心规范
+
+| 原则 | 说明 |
+|------|------|
+| RESTful 风格 | 使用标准 HTTP 方法表达语义 |
+| 认证保护 | 所有业务接口必须添加认证注解 |
+| 参数校验 | 使用分组校验区分新增/修改场景 |
+| 统一响应 | 使用统一的响应格式包装返回数据 |
+
+### HTTP 方法规范
+
+| 操作 | 方法 | 路径示例 |
+|------|------|---------|
+| 列表查询 | GET | `/list` 或 `/page` |
+| 获取详情 | GET | `/{id}` |
+| 新增 | POST | `/` 或 `/add` |
+| 修改 | PUT | `/` 或 `/update` |
+| 删除 | DELETE | `/{ids}` |
+| 导出 | POST | `/export` |
+| 导入 | POST | `/import` |
+
+---
+
+## Controller 标准模板
+
+```java
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/[模块]/[功能]")
+public class XxxController {
+
+    private final XxxService xxxService;
+
+    /**
+     * 分页查询
+     */
+    @GetMapping("/page")
+    public Result<PageResult<XxxVO>> page(XxxQueryDTO query) {
+        return Result.ok(xxxService.pageList(query));
+    }
+
+    /**
+     * 获取详情
+     */
+    @GetMapping("/{id}")
+    public Result<XxxVO> getById(@PathVariable Long id) {
+        return Result.ok(xxxService.getById(id));
+    }
+
+    /**
+     * 新增
+     */
+    @PostMapping
+    public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) {
+        return Result.ok(xxxService.add(dto));
+    }
+
+    /**
+     * 修改
+     */
+    @PutMapping
+    public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) {
+        xxxService.update(dto);
+        return Result.ok();
+    }
+
+    /**
+     * 删除
+     */
+    @DeleteMapping("/{ids}")
+    public Result<Void> delete(@PathVariable List<Long> ids) {
+        xxxService.deleteByIds(ids);
+        return Result.ok();
+    }
+}
+```
+
+---
+
+## 统一响应封装
+
+### Result 包装类（通用模式）
+
+```java
+@Data
+public class Result<T> {
+    private int code;
+    private String message;
+    private T data;
+
+    public static <T> Result<T> ok() {
+        return ok(null);
+    }
+
+    public static <T> Result<T> ok(T data) {
+        Result<T> result = new Result<>();
+        result.setCode(200);
+        result.setMessage("success");
+        result.setData(data);
+        return result;
+    }
+
+    public static <T> Result<T> fail(String message) {
+        Result<T> result = new Result<>();
+        result.setCode(500);
+        result.setMessage(message);
+        return result;
+    }
+}
+```
+
+### 分页响应
+
+```java
+@Data
+public class PageResult<T> {
+    private List<T> records;
+    private long total;
+    private long current;
+    private long size;
+}
+```
+
+---
+
+## 参数校验
+
+### 分组校验
+
+```java
+// DTO 中使用分组
+@Data
+public class XxxDTO {
+    @NotNull(message = "ID不能为空", groups = {UpdateGroup.class})
+    private Long id;
+
+    @NotBlank(message = "名称不能为空", groups = {InsertGroup.class, UpdateGroup.class})
+    @Size(max = 100, message = "名称长度不能超过100个字符")
+    private String name;
+
+    @Min(value = 0, message = "排序不能为负数")
+    private Integer sort;
+}
+
+// Controller 中应用
+@PostMapping
+public Result<Long> add(@Validated(InsertGroup.class) @RequestBody XxxDTO dto) { ... }
+
+@PutMapping
+public Result<Void> update(@Validated(UpdateGroup.class) @RequestBody XxxDTO dto) { ... }
+```
+
+> Jakarta Validation: JDK 17+ 必须 `import jakarta.validation.constraints.*`
+
+### 查询参数
+
+```java
+@Data
+public class XxxQueryDTO {
+    private String keyword;
+    private Integer status;
+
+    @Min(value = 1)
+    private Integer pageNum = 1;
+
+    @Min(value = 1) @Max(value = 100)
+    private Integer pageSize = 10;
+}
+```
+
+---
+
+## 常见场景
+
+### 带分布式锁的导入
+
+```java
+@PostMapping("/import")
+public Result<Void> importExcel(@RequestPart("file") MultipartFile file) {
+    if (file == null || file.isEmpty()) {
+        throw new [你的异常类]("文件不能为空");
+    }
+    RLock lock = redissonClient.getLock("import:lock:" + getCurrentTenantId());
+    try {
+        if (!lock.tryLock(5, 60, TimeUnit.SECONDS)) {
+            throw new [你的异常类]("正在处理中，请稍后再试");
+        }
+        try {
+            xxxService.importExcel(file);
+        } finally {
+            if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                lock.unlock();
+            }
+        }
+    } catch (InterruptedException e) {
+        Thread.currentThread().interrupt();
+        throw new [你的异常类]("导入被中断");
+    }
+    return Result.ok();
+}
+```
+
+### 批量删除
+
+```java
+@DeleteMapping("/{ids}")
+public Result<Void> delete(@PathVariable List<Long> ids) {
+    if (ids == null || ids.isEmpty()) {
+        throw new [你的异常类]("ID列表不能为空");
+    }
+    xxxService.deleteByIds(ids);
+    return Result.ok();
+}
+```
+
+### 文件上传
+
+```java
+@PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+public Result<UploadResult> upload(@RequestPart("file") MultipartFile file) {
+    return Result.ok(ossService.upload(file));
+}
+```
+
+---
+
+## API 文档注解
+
+### Swagger / SpringDoc 注解
+
+```java
+// SpringDoc (OpenAPI 3.0, 推荐)
+@Tag(name = "用户管理")                              // Controller 类
+@Operation(summary = "新增用户")                      // 方法
+@Schema(description = "用户DTO")                      // DTO/VO 类
+@Schema(description = "主键ID", requiredMode = REQUIRED) // 字段
+
+// Swagger 2 (旧项目)
+@Api(value = "用户管理", tags = "用户管理")
+@ApiOperation(value = "新增用户")
+@ApiModel("用户DTO")
+@ApiModelProperty(value = "主键ID", required = true)
+```
+
+---
+
+## 全局异常处理
+
+```java
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler([你的异常类].class)
+    public Result<Void> handleBusinessException([你的异常类] e) {
+        return Result.fail(e.getMessage());
+    }
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public Result<Void> handleValidException(MethodArgumentNotValidException e) {
+        String message = e.getBindingResult().getFieldErrors().stream()
+            .map(FieldError::getDefaultMessage)
+            .collect(Collectors.joining(", "));
+        return Result.fail(message);
+    }
+
+    @ExceptionHandler(Exception.class)
+    public Result<Void> handleException(Exception e) {
+        log.error("系统异常", e);
+        return Result.fail("系统繁忙，请稍后再试");
+    }
+}
+```
+
+---
+
+## 检查清单
+
+- [ ] 认证注解（`@PreAuthorize` / `[你的认证注解]`）
+- [ ] API 文档注解（`@Operation` / `@ApiOperation`）
+- [ ] 参数校验 `@Validated` + 分组
+- [ ] 统一响应包装 `Result<T>`
+- [ ] 敏感操作加分布式锁
+- [ ] 全局异常处理器已配置
+
+---
+
+## 相关技能
+
+| 需要了解 | Skill |
+|---------|-------|
+| 异常处理 | `error-handler` |
+| 数据库设计 | `database-ops` |
+| 缓存 | `redis-cache` |
+| 文件上传 | `file-oss-management` |