ai-engineering-init 1.4.1 → 1.4.3

package/.claude/skills/bug-detective/SKILL.md

@@ -10,6 +10,8 @@ description: |
   - 日志文件分析（./logs/sys-console.log）
   - 前端页面不显示、API 调用异常
 
+  联动技能：数据问题自动联动 mysql-debug 查库验证
+
   触发词：Bug、报错、异常、不工作、500错误、NullPointerException、SQLException、数据查不到、日志分析、排查、调试、debug、错误排查、精度丢失
 ---
 
@@ -204,31 +206,28 @@ XxxVO vo = BeanUtil.copyProperties(entity, XxxVO.class); // 源对象为 null
 
 ---
 
-## 数据库排查
+## 数据库排查（委托 mysql-debug）
 
-### 主动排查流程
+当诊断结果指向数据问题时，**必须联动 `mysql-debug` 技能**进行数据库查询验证：
 
 ```
-1. 读取数据库配置（bootstrap.yml / application-dev.yml）
-2. 连接数据库执行诊断 SQL
-3. 分析结果给出方案
+诊断决策树判定"数据相关问题"
+  ↓
+自动激活 mysql-debug 技能
+  ↓
+mysql-debug 执行：配置检查 → 日志提取数据库名 → 执行只读 SQL → 返回结果
+  ↓
+bug-detective 结合查询结果给出修复方案
 ```
 
-### 常用诊断 SQL
-
-```sql
--- 数据存在性（注意 del_flag=2 是正常）
-SELECT * FROM 表名 WHERE id = ? AND del_flag = 2;
-
--- 最近数据
-SELECT * FROM 表名 ORDER BY crtime DESC LIMIT 10;
+**触发 mysql-debug 的信号**：
+- 查询返回空/数据不存在
+- 数据数量、金额、状态不对
+- SQL 异常（DataIntegrityViolation、DuplicateKey）
+- 关联数据不一致
+- 特定租户才出现的问题
 
--- 表结构
-DESC 表名;
-
--- 执行计划
-EXPLAIN SELECT ...;
-```
+> 如果 mysql-debug 配置未就绪（密码未设置/mysql CLI 未安装），仍可继续纯代码分析路径。
 
 ---
 
@@ -250,6 +249,7 @@ EXPLAIN SELECT ...;
 
 | 排查发现 | 推荐 Skill |
 |---------|-----------|
+| 数据问题（查不到/不一致/状态异常） | `mysql-debug`（自动联动） |
 | SQL 性能慢 | `performance-doctor` |
 | 权限配置问题 | `security-guard` |
 | BO/VO 映射错误 | `leniu-crud-development` |