leniu-dev 2.0.0

package/.codex/skills/mysql-debug/SKILL.md

@@ -0,0 +1,406 @@
+---
+name: mysql-debug
+description: |
+  MySQL 数据库查询调试技能。通过 mysql CLI 直接查询本地 MySQL 数据库，配合日志进行 Bug 排查。
+  Bug 修复时自动评估是否需要查库，从日志中提取数据库名（租户ID），支持手动指定数据库。
+
+  触发场景：
+  - 结合日志排查 Bug 时需要查询数据库验证数据
+  - 检查数据库中某条记录的实际值
+  - 验证 SQL 执行结果是否符合预期
+  - 排查数据不一致、数据丢失、数据异常问题
+  - 需要查看表结构、索引、数据分布
+
+  触发词：查数据库、查表、执行SQL、查记录、mysql查询、数据库排查、验证数据、查数据、db查询、数据库调试
+---
+
+# MySQL 数据库查询调试技能
+
+## 概述
+
+本技能用于在 Bug 排查过程中直接查询 MySQL 数据库，验证数据状态。配合日志分析定位问题根因。
+
+**核心能力**：
+1. 智能判断 Bug 是否需要查库（明显代码错误跳过）
+2. 从日志自动提取数据库名（租户 ID = 数据库名）
+3. 只读查询，安全排查
+
+---
+
+## 连接信息获取（四级降级，自动查找）
+
+当本技能被激活时，**按以下优先级获取数据库连接信息**：
+
+### 优先级 1：用户对话中指定（最高优先级）
+
+用户直接给出连接信息，或指定环境名：
+- "连 dev 环境查一下" → 使用配置中 dev 环境
+- "去 dev10 查" → **范围匹配** dev 环境（range: "1~15"）
+- 直接给出 host/port/user/password → 直接使用
+
+### 优先级 2：本地项目 `.claude/mysql-config.json`
+
+项目目录下的配置文件，优先于全局配置。
+
+### 优先级 3：全局配置（所有项目共享）
+
+全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建）。
+查找路径：`~/.claude/mysql-config.json` 或 `~/.cursor/mysql-config.json`（取决于使用的工具）。
+**推荐**：公司统一的数据库连接信息放全局，项目特定的覆盖放本地。
+
+### 优先级 4：工程配置文件（零配置，本地开发默认）
+
+从项目的 `bootstrap-dev.yml` 中自动提取连接信息：
+
+**搜索路径**：
+```
+**/bootstrap-dev.yml
+**/bootstrap*.yml（降级）
+```
+
+**解析位置**：`spring.dataset.system.master` 节点
+
+**解析规则**：
+```yaml
+# 从以下字段提取：
+jdbcUrl: jdbc:mysql://127.0.0.1:3306/system_xxx
+username: root
+password: xxx
+```
+
+**提取结果**：
+- host = `127.0.0.1`（从 jdbcUrl 解析）
+- port = `3306`（从 jdbcUrl 解析）
+- user = `root`（username 字段）
+- password = `xxx`（password 字段）
+- 注意：jdbcUrl 中的数据库名（`system_xxx`）为系统库，**不作为查询目标数据库**。查询目标数据库 = 租户ID（从日志提取或用户指定）
+
+### mysql CLI 查找（多路径）
+
+按顺序查找 mysql 客户端：
+
+```bash
+which mysql \
+  || ls /usr/local/mysql/bin/mysql \
+  || ls /opt/homebrew/bin/mysql \
+  || ls /opt/homebrew/opt/mysql-client/bin/mysql
+```
+
+找到任一即可使用。如果全部不存在，输出安装提示：
+```
+brew install mysql-client
+```
+
+### 引导提示（仅当连接信息和 mysql CLI 都无法获取时）
+
+```
+⚠️ 数据库查询功能需要先完成配置：
+
+1. 连接信息获取失败：
+   - 未找到 bootstrap-dev.yml 工程配置文件
+   - 未找到 .claude/mysql-config.json 配置文件
+   → 请创建 .claude/mysql-config.json 或确保项目中存在 bootstrap-dev.yml
+
+2. 安装 MySQL 客户端：
+   brew install mysql-client
+
+完成后重新触发即可使用数据库查询辅助排查。
+```
+
+> 引导提示输出后，Bug 排查仍可继续（走 bug-detective 纯代码分析路径），只是跳过数据库查询环节。
+
+---
+
+## 多环境支持
+
+### 配置文件结构
+
+`.claude/mysql-config.json` 支持多环境配置：
+
+```json
+{
+  "environments": {
+    "local": { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "xxx" },
+    "dev":   { "host": "dev-db.example.com", "port": 3306, "user": "dev_user", "password": "xxx" },
+    "prod":  { "host": "prod-db.example.com", "port": 3306, "user": "readonly", "password": "xxx" }
+  },
+  "default": "local"
+}
+```
+
+### 环境选择规则
+
+| 优先级 | 来源 | 示例 |
+|--------|------|------|
+| 1（最高） | 用户对话中指定 | "连 dev 环境查一下"、"用生产库看看" |
+| 2 | 配置文件 `default` 字段 | `"default": "local"` |
+
+### 环境关键词映射
+
+用户说的话 → 对应环境名：
+
+| 用户说法 | 环境 |
+|---------|------|
+| "本地"、"local"、"本地环境" | `local` |
+| "开发"、"dev"、"测试环境"、"开发环境" | `dev` |
+| "生产"、"prod"、"线上"、"正式环境" | `prod` |
+
+### 连接示例
+
+```bash
+# 用户说"连 dev 环境查一下 order_info"
+# → 读取 environments.dev 的连接信息 + 日志提取的数据库名
+mysql -h dev-db.example.com -P 3306 -u dev_user -p'xxx' 546198574447230976 -e "SELECT ..."
+```
+
+---
+
+## 核心流程：是否需要查库？
+
+### 决策树（Bug 修复时必须先评估）
+
+```
+用户报告 Bug / 提供日志
+  │
+  ├─ 明显的代码错误？ ──→ ✅ 不需要查库，直接修复
+  │   - NPE 且代码中未做空判断
+  │   - 语法错误、拼写错误
+  │   - 类型转换错误（ClassCastException）
+  │   - 缺少 import、注解遗漏
+  │   - 方法签名不匹配
+  │
+  ├─ 数据相关的问题？ ──→ 🔍 需要查库
+  │   - "查不到数据"、"数据为空"
+  │   - "数量不对"、"金额不对"
+  │   - SQL 相关异常（DataIntegrityViolation、DuplicateKey）
+  │   - 关联查询结果异常
+  │   - 状态流转异常（订单状态不对等）
+  │
+  ├─ 不确定是代码还是数据？ ──→ 🔍 需要查库确认
+  │   - 逻辑正确但结果错误
+  │   - 特定租户/特定数据才出现的 Bug
+  │   - 生产有问题但本地无法复现
+  │
+  └─ 配置/环境问题？ ──→ ✅ 不需要查库
+      - 启动失败、Bean 创建异常
+      - 配置文件错误
+      - 依赖版本冲突
+```
+
+### 评估输出格式
+
+在 Bug 修复响应中，先输出评估结论：
+
+```
+📊 数据库查询评估：需要查库
+理由：日志显示 order_info 查询返回空，需要确认数据是否存在
+数据库：546198574447230976（从日志提取）
+```
+
+或：
+
+```
+📊 数据库查询评估：不需要查库
+理由：明显的 NPE，代码中 getUserInfo() 返回值未做空判断
+```
+
+---
+
+## 从日志提取数据库名
+
+### 日志格式说明
+
+本项目的日志格式：
+
+```
+2026-03-04 10:21:40.902,-,546198574447230976,, DEBUG 94396 --- [  XNIO-1 task-3] n.x.f.c.request.RequestLoggingFilter : 47  : >>> GET /api/v2/web/xxx
+```
+
+各字段含义：
+
+```
+时间戳                    ,-,租户ID（=数据库名）,, 日志级别 PID --- [线程名] 类名 : 行号 : 日志内容
+```
+
+### 提取规则
+
+1. **自动提取**：从日志行中匹配 `,-,(\d{15,19}),,` 模式，提取的数字即为数据库名
+2. **手动指定**：用户直接说"查 546198574447230976 库"或"数据库名是 xxx"
+3. **优先级**：手动指定 > 日志提取 > 配置文件 default
+
+### 提取示例
+
+```
+日志：2026-03-04 10:21:40.902,-,546198574447230976,, DEBUG ...
+                                ↑
+                          数据库名 = 546198574447230976
+```
+
+连接时使用：
+```bash
+mysql -h 127.0.0.1 -P 3306 -u root -p'password' 546198574447230976 -e "SELECT ..."
+```
+
+---
+
+## 查询执行
+
+### 连接方式
+
+按"连接信息获取"章节的优先级获取 host/port/user/password，数据库名从日志提取或用户指定：
+
+```bash
+# 连接信息来源：用户指定 > mysql-config.json > bootstrap-dev.yml 自动提取
+# 数据库名来源：用户指定 > 日志提取的租户ID
+mysql -h {host} -P {port} -u {user} -p'{password}' {database_from_log_or_user} -e "{SQL}"
+
+# mysql 路径：如果 which mysql 失败，尝试绝对路径
+/opt/homebrew/opt/mysql-client/bin/mysql -h {host} ...
+```
+
+### 常用排查查询模板
+
+#### 查看表结构
+```sql
+DESCRIBE table_name;
+SHOW CREATE TABLE table_name;
+```
+
+#### 按 ID 查记录
+```sql
+SELECT * FROM table_name WHERE id = {id} AND del_flag = 2;
+```
+
+#### 查看最近修改的数据
+```sql
+SELECT * FROM table_name
+WHERE uptime >= '{log_timestamp}'
+ORDER BY uptime DESC
+LIMIT 20;
+```
+
+#### 检查关联数据一致性
+```sql
+SELECT a.id, b.id AS related_id
+FROM table_a a
+LEFT JOIN table_b b ON a.related_id = b.id
+WHERE a.id = {id} AND b.id IS NULL;
+```
+
+#### 统计数据分布
+```sql
+SELECT status, COUNT(*) as cnt
+FROM table_name
+WHERE del_flag = 2
+GROUP BY status;
+```
+
+#### 查看某时间段的操作记录
+```sql
+SELECT * FROM table_name
+WHERE crtime BETWEEN '{start}' AND '{end}'
+ORDER BY crtime DESC
+LIMIT 50;
+```
+
+---
+
+## 安全规范（强制执行，违反即终止）
+
+### 允许执行的 SQL（白名单）
+
+**只允许以下语句类型**：
+- `SELECT` — 查询数据
+- `DESCRIBE` / `DESC` — 查看表结构
+- `SHOW` — 查看建表语句、索引、状态等
+- `EXPLAIN` — 分析执行计划
+
+### 禁止执行的 SQL（黑名单）
+
+**DDL 操作 — 全部禁止**：
+- `CREATE TABLE / VIEW / INDEX / DATABASE`
+- `ALTER TABLE / COLUMN`
+- `DROP TABLE / VIEW / INDEX / DATABASE`
+- `TRUNCATE TABLE`
+- `RENAME TABLE`
+
+**DML 写操作 — 全部禁止**：
+- `INSERT` — 禁止插入数据
+- `UPDATE` — 禁止更新数据
+- `DELETE` — 禁止删除数据
+- `REPLACE` — 禁止替换数据
+
+**权限/管理操作 — 全部禁止**：
+- `GRANT / REVOKE`
+- `SET GLOBAL`
+- `FLUSH`
+
+### 敏感 SQL 拦截（执行前必须分析）
+
+在执行任何 SQL 之前，必须进行安全分析。遇到以下情况时，**不执行 SQL，改为输出分析结果并询问用户**：
+
+| 风险类型 | 检测规则 | 处理方式 |
+|---------|---------|---------|
+| 无 WHERE 全表扫描 | `SELECT * FROM xxx` 无 WHERE 子句 | 提醒用户加条件，或自动加 `LIMIT 10` |
+| 大范围查询 | WHERE 条件覆盖范围过大（如 `del_flag = 2`） | 提醒加更精确条件，强制 `LIMIT 50` |
+| 多表 JOIN 无条件 | JOIN 无 ON 条件（笛卡尔积） | 拒绝执行，提示补充 JOIN 条件 |
+| 子查询嵌套过深 | 超过 3 层嵌套子查询 | 输出 SQL 让用户确认后再执行 |
+| 敏感表查询 | 涉及用户密码表、密钥表 | 输出脱敏后的 SQL 分析，不直接查询 |
+
+### 执行前检查流程
+
+```
+收到/构造 SQL
+  │
+  ├─ 是否在白名单内？ ──→ 否 → 拒绝执行，输出原因
+  │
+  ├─ 是否命中敏感规则？ ──→ 是 → 输出风险分析，询问用户
+  │
+  ├─ 是否包含 LIMIT？ ──→ 否 → 自动追加 LIMIT 50
+  │
+  └─ 通过所有检查 → 执行 SQL
+```
+
+### 查询结果安全
+
+- 查询必须加 `LIMIT`（默认 LIMIT 50）防止返回过多数据
+- 不在输出中暴露密码、手机号（phone）、身份证（id_card）等敏感字段
+- 查询结果中的敏感字段用 `***` 脱敏展示
+- 如需修改数据，**只输出 SQL 语句让用户手动执行**，不代为执行
+
+### 配置文件安全
+
+- `.claude/mysql-config.json` 已加入 `.gitignore`，禁止提交到版本库
+
+---
+
+## 与 bug-detective 配合
+
+本技能是 `bug-detective` 的数据层扩展。当 bug-detective 被触发时，会自动评估是否需要同时激活 mysql-debug：
+
+| 步骤 | bug-detective | mysql-debug |
+|------|--------------|-------------|
+| 1 | 分析日志、定位异常层 | 评估是否需要查库 |
+| 2 | 识别涉及的表和查询 | 从日志提取数据库名 |
+| 3 | 推断可能原因 | 执行 SQL 验证数据 |
+| 4 | 给出修复方案 | 用数据证实/排除假设 |
+
+典型联合使用：
+```
+用户："订单查询接口返回空数据，日志如下..."
+日志：2026-03-04 10:21:40.902,-,546198574447230976,, ERROR ...
+
+→ 评估：需要查库（数据返回空，需确认数据是否存在）
+→ 提取数据库：546198574447230976
+→ 执行：SELECT * FROM order_info WHERE id = xxx AND del_flag = 2
+→ 发现：del_flag = 1（已删除），用户操作了删除但不知情
+→ 修复方案：恢复数据 / 检查前端删除按钮权限
+```
+
+---
+
+## 注意
+
+- 本技能专注于**查询数据库辅助排查**，不涉及建表、迁移等操作（请使用 `database-ops`）
+- 如果是纯代码错误（NPE、语法错误等）不需要查库，请使用 `bug-detective`
+- 如果是 SQL 性能问题（慢查询），请使用 `performance-doctor`

package/.codex/skills/next/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: next
+description: |
+  当需要获取项目开发的下一步建议、规划开发方向时自动使用此 Skill。
+
+  触发场景：
+  - 不知道下一步应该做什么
+  - 需要获取开发优先级建议
+  - 需要分析当前项目状态并给出建议
+  - 需要规划开发工作方向
+
+  触发词：下一步、next、建议、做什么、开发方向、优先级、工作建议、开发建议
+---
+
+# /next - 下一步建议
+
+作为项目开发顾问，根据当前项目状态，为您建议下一步应该做什么。
+
+## 🎯 执行流程
+
+### 第一步：快速扫描项目状态
+
+```bash
+# 查看最近 Git 提交记录
+git log -5 --oneline
+
+# 扫描所有业务模块中的 TODO/FIXME
+Grep pattern: "TODO:|FIXME:" path: ruoyi-modules/ glob: "*.java" output_mode: content -B 2
+
+# 检查代码规范和问题
+Grep pattern: "package com\.ruoyi\.|BeanUtil\.copy" path: ruoyi-modules/ glob: "*.java" output_mode: files_with_matches
+```
+
+### 第二步：分析开发阶段
+
+| 阶段 | 特征 | 功能完成率 |
+|------|------|----------|
+| 🟢 初期 | 基础框架搭建，功能模块较少 | < 30% |
+| 🟡 中期 | 核心功能开发中，模块逐步完善 | 30-70% |
+| 🔴 后期 | 功能基本完成，处于优化阶段 | > 70% |
+
+### 第三步：分类问题和建议
+
+- **紧急问题**：安全漏洞、严重 Bug、编译错误
+- **重要问题**：功能缺陷、设计问题、规范问题
+- **优化建议**：性能优化、代码重构、文档完善
+
+---
+
+## 📊 输出格式
+
+```markdown
+# 🎯 下一步建议
+
+**分析时间**：YYYY-MM-DD HH:mm
+**分析范围**：全量后端代码
+
+---
+
+## 📌 当前状态
+
+### Git 提交分析
+- **最近一次提交**：[commit message] ([commit hash])
+- **最近在做**：[根据提交记录推断]
+- **提交频率**：[活跃/不活跃]
+
+### 代码状态
+- **开发阶段**：🟡 中期（核心功能开发中）
+- **代码质量**：良好（无 com.ruoyi 包名问题）
+- **规范问题**：3 个接口缺少 @SaCheckPermission 注解
+
+### 代码待办统计
+- **TODO 项**：X 个
+- **FIXME 项**：X 个
+- **编译/运行错误**：无
+
+---
+
+## 🚀 建议优先级
+
+### 🔴 高优先级（必须立即处理）
+
+1. **修复 FIXME 问题**
+   - 位置：ruoyi-demo/PaymentService.java:156
+   - 问题：退款金额计算错误
+   - **快速修复**：`/check` 找出所有 FIXME 并逐一解决
+
+2. **补充缺失的权限注解**
+   - 位置：ruoyi-demo 模块 3 个接口
+   - **快速修复**：`/check demo` 查出所有问题接口
+
+### 🟡 中优先级（近期应该做）
+
+1. **补充缺失功能模块**
+   - **快速开发**：`/crud Payment` 快速生成 CRUD 代码
+
+2. **优化 Service 查询层**
+   - **参考代码**：ruoyi-system/SysNoticeServiceImpl.java
+
+### 🟢 低优先级（可以考虑）
+
+1. **性能优化**
+2. **代码重构**
+3. **单元测试**
+
+---
+
+## 💡 具体行动建议
+
+### 如果您想继续开发新功能：
+
+```bash
+/crud Payment        # 快速生成 Payment 模块
+/check business      # 检查并修复规范问题
+```
+
+### 如果您想优化代码质量：
+
+```bash
+/check               # 全量检查
+/check business      # 按模块检查
+```
+
+---
+
+## 🔗 相关命令
+
+| 命令 | 用途 | 何时使用 |
+|------|------|---------|
+| `/start` | 快速了解项目 | 初次接触项目 |
+| `/check` | 代码规范检查 | 开发完成后、定期检查 |
+| `/progress` | 查看项目进度 | 了解完成情况 |
+| `/next` | 获取建议 | 不知道下一步做什么 |
+| `/dev` | 开发新功能 | 从零开始开发 |
+| `/crud` | 快速生成代码 | 表已存在时 |
+| `/add-todo` | 添加待办任务 | 跟踪任务 |
+```

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

@@ -0,0 +1,165 @@
+---
+name: openspec-apply-change
+description: |
+  Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.
+
+  触发场景：
+  - 需要实现 OpenSpec 变更中的任务
+  - 执行变更制品中定义的实现步骤
+  - 将规格和设计转化为实际代码
+  - 逐个完成 tasks.md 中的待办事项
+
+  触发词：实现任务、开始实现、opsx:apply、openspec apply、执行变更、开始编码、实现变更
+license: MIT
+compatibility: Requires openspec CLI.
+metadata:
+  author: openspec
+  version: "1.0"
+  generatedBy: "1.1.1"
+---
+
+Implement tasks from an OpenSpec change.
+
+**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. **Select the change**
+
+   If a name is provided, use it. Otherwise:
+   - Infer from conversation context if the user mentioned a change
+   - Auto-select if only one active change exists
+   - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
+
+   Always announce: "Using change: <name>" and how to override (e.g., `/opsx:apply <other>`).
+
+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 artifact contains the tasks (typically "tasks" for spec-driven, check status for others)
+
+3. **Get apply instructions**
+
+   ```bash
+   openspec instructions apply --change "<name>" --json
+   ```
+
+   This returns:
+   - Context file paths (varies by schema - could be proposal/specs/design/tasks or spec/tests/implementation/docs)
+   - Progress (total, complete, remaining)
+   - Task list with status
+   - Dynamic instruction based on current state
+
+   **Handle states:**
+   - If `state: "blocked"` (missing artifacts): show message, suggest using openspec-continue-change
+   - If `state: "all_done"`: congratulate, suggest archive
+   - Otherwise: proceed to implementation
+
+4. **Read context files**
+
+   Read the files listed in `contextFiles` from the apply instructions output.
+   The files depend on the schema being used:
+   - **spec-driven**: proposal, specs, design, tasks
+   - Other schemas: follow the contextFiles from CLI output
+
+5. **Show current progress**
+
+   Display:
+   - Schema being used
+   - Progress: "N/M tasks complete"
+   - Remaining tasks overview
+   - Dynamic instruction from CLI
+
+6. **Implement tasks (loop until done or blocked)**
+
+   For each pending task:
+   - Show which task is being worked on
+   - Make the code changes required
+   - Keep changes minimal and focused
+   - Mark task complete in the tasks file: `- [ ]` → `- [x]`
+   - Continue to next task
+
+   **Pause if:**
+   - Task is unclear → ask for clarification
+   - Implementation reveals a design issue → suggest updating artifacts
+   - Error or blocker encountered → report and wait for guidance
+   - User interrupts
+
+7. **On completion or pause, show status**
+
+   Display:
+   - Tasks completed this session
+   - Overall progress: "N/M tasks complete"
+   - If all done: suggest archive
+   - If paused: explain why and wait for guidance
+
+**Output During Implementation**
+
+```
+## Implementing: <change-name> (schema: <schema-name>)
+
+Working on task 3/7: <task description>
+[...implementation happening...]
+✓ Task complete
+
+Working on task 4/7: <task description>
+[...implementation happening...]
+✓ Task complete
+```
+
+**Output On Completion**
+
+```
+## Implementation Complete
+
+**Change:** <change-name>
+**Schema:** <schema-name>
+**Progress:** 7/7 tasks complete ✓
+
+### Completed This Session
+- [x] Task 1
+- [x] Task 2
+...
+
+All tasks complete! Ready to archive this change.
+```
+
+**Output On Pause (Issue Encountered)**
+
+```
+## Implementation Paused
+
+**Change:** <change-name>
+**Schema:** <schema-name>
+**Progress:** 4/7 tasks complete
+
+### Issue Encountered
+<description of the issue>
+
+**Options:**
+1. <option 1>
+2. <option 2>
+3. Other approach
+
+What would you like to do?
+```
+
+**Guardrails**
+- Keep going through tasks until done or blocked
+- Always read context files before starting (from the apply instructions output)
+- If task is ambiguous, pause and ask before implementing
+- If implementation reveals issues, pause and suggest artifact updates
+- Keep code changes minimal and scoped to each task
+- Update task checkbox immediately after completing each task
+- Pause on errors, blockers, or unclear requirements - don't guess
+- Use contextFiles from CLI output, don't assume specific file names
+
+**Fluid Workflow Integration**
+
+This skill supports the "actions on a change" model:
+
+- **Can be invoked anytime**: Before all artifacts are done (if tasks exist), after partial implementation, interleaved with other actions
+- **Allows artifact updates**: If implementation reveals design issues, suggest updating artifacts - not phase-locked, work fluidly