ai-engineering-init 1.16.2 → 1.16.3

package/.cursor/skills/loki-log-query/SKILL.md

@@ -30,10 +30,10 @@ description: |
 ```
 1. 本地项目：.claude/loki-config.json（新格式）
 2. 本地项目：.claude/skills/loki-log-query/environments.json（旧格式，兼容）
-3. 全局配置：~/.claude/loki-config.json
+3. 全局配置：~/.claude/loki-config.json（或 ~/.cursor/loki-config.json）
 ```
 
-本地配置优先。全局配置推荐用 `npx ai-engineering-init config --type loki --scope global` 创建。
+本地优先。全局配置用 `npx ai-engineering-init config --type loki --scope global` 创建。
 
 ### 配置结构（支持 range 范围匹配）
 
@@ -47,32 +47,32 @@ description: |
       "token": "glsa_xxx",
       "aliases": ["mdev", "dev"],
       "range": "dev1~15",
-      "projects": ["dev01","dev02","dev03","dev04","dev05","dev06","dev07","dev08","dev09","dev10","dev11","dev12","dev13","dev14","dev15"]
+      "projects": ["dev01","dev02","...","dev15"]
     }
   }
 }
 ```
 
-### 环境匹配规则（含 range 范围匹配）
+### 环境列表（默认）
 
-用户说的话 → 匹配逻辑：
+| 环境别名 | 名称 | URL | 快捷词 |
+|----------|------|-----|--------|
+| `test13` | 测试13（主测试环境） | `https://test13.xnzn.net/grafana` | test13, 13 |
+| `monitor-test` | Monitor 测试环境 | `https://monitor-test.xnzn.net/grafana` | mtest |
+| `monitor-dev` | Monitor 开发环境 | `https://monitor-dev.xnzn.net/grafana` | mdev, dev |
+| `monitor02-dev` | Monitor02 开发环境 | `https://monitor02-dev.xnzn.net/grafana` | m02, monitor02 |
+| `monitor-tyy-dev` | Monitor 体验园开发环境 | `https://monitor-tyy-dev.xnzn.net/grafana` | tyy, 体验园 |
+
+### 环境匹配规则（含 range）
 
 | 用户说法 | 匹配方式 | 结果 |
 |---------|---------|------|
-| "查 test13 的日志" | 精确匹配 key 或 aliases | `test13` 环境 |
-| "去 dev10 查" | **range 匹配**：dev10 在 monitor-dev 的 projects 中 | `monitor-dev` 环境，`project="dev10"` |
+| "查 test13 的日志" | 精确匹配 key/aliases | `test13` 环境 |
+| "去 dev10 查" | **range 匹配**：dev10 在 monitor-dev 的 projects 中 | `monitor-dev`，`project="dev10"` |
 | "去 monitor-dev 查" | 精确匹配 key | `monitor-dev` 环境 |
 | "切到体验园" | aliases 匹配 | `monitor-tyy-dev` 环境 |
 | 未指定环境 | 使用 `active` 字段 | 默认活跃环境 |
 
-**range 匹配算法**：
-```
-1. 用户输入 "dev10"
-2. 先精确匹配 key / aliases → 未命中
-3. 遍历所有环境的 projects 列表，检查是否包含 "dev10"
-4. 命中 → 使用该环境，并自动添加 project="dev10" 标签过滤
-```
-
 ### 读取配置（含全局降级 + range 匹配）
 
 ```bash
@@ -82,10 +82,10 @@ find_config() {
   for f in \
     "${PROJECT_DIR}/.claude/loki-config.json" \
     "${PROJECT_DIR}/.claude/skills/loki-log-query/environments.json" \
-    "${HOME}/.claude/loki-config.json"; do
+    "${HOME}/.claude/loki-config.json" \
+    "${HOME}/.cursor/loki-config.json"; do
     [ -f "$f" ] && echo "$f" && return
   done
-  echo ""
 }
 
 ENV_FILE=$(find_config)
@@ -93,46 +93,43 @@ ENV_FILE=$(find_config)
 # 通过别名或 range 查找环境 key + project
 find_env() {
   python3 -c "
-import json, re
+import json
 data = json.load(open('${ENV_FILE}'))
 alias = '${1}'.lower()
-# 1. 精确匹配 key 或 aliases
 for key, env in data['environments'].items():
     if alias == key or alias in env.get('aliases', []):
-        print(f'{key}|')  # key|project（project 为空）
-        exit()
-# 2. range 匹配：在 projects 列表中查找
+        print(f'{key}|'); exit()
 for key, env in data['environments'].items():
     if alias in env.get('projects', []):
-        print(f'{key}|{alias}')
-        exit()
-# 3. 未命中，返回默认
+        print(f'{key}|{alias}'); exit()
 print(f'{data[\"active\"]}|')
 "
 }
-
-# 使用示例：
-# result=$(find_env "dev10")
-# ENV_KEY=$(echo "$result" | cut -d'|' -f1)   # monitor-dev
-# PROJECT=$(echo "$result" | cut -d'|' -f2)    # dev10
-# 查询时：{app="yunshitang",project="${PROJECT}"}
 ```
 
-### 切换活跃环境 / 更新 Token
+### 切换活跃环境
 
 ```bash
+# 切换默认环境为 monitor-dev
 python3 -c "
 import json
 data = json.load(open('${ENV_FILE}'))
 data['active'] = 'monitor-dev'
 json.dump(data, open('${ENV_FILE}', 'w'), indent=2, ensure_ascii=False)
+print('Switched to:', data['active'])
 "
+```
 
+### 更新 Token
+
+```bash
+# 为某个环境设置 Token
 python3 -c "
 import json
 data = json.load(open('${ENV_FILE}'))
-data['environments']['monitor-dev']['token'] = 'glsa_新token'
+data['environments']['monitor-dev']['token'] = 'glsa_新的token值'
 json.dump(data, open('${ENV_FILE}', 'w'), indent=2, ensure_ascii=False)
+print('Token updated for monitor-dev')
 "
 ```
 

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

@@ -42,9 +42,10 @@ description: |
 
 项目目录下的配置文件，优先于全局配置。
 
-### 优先级 3：全局 `~/.claude/mysql-config.json`
+### 优先级 3：全局配置（所有项目共享）
 
-全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建），所有项目共享。
+全局配置文件（通过 `npx ai-engineering-init config --scope global` 创建）。
+查找路径：`~/.claude/mysql-config.json` 或 `~/.cursor/mysql-config.json`（取决于使用的工具）。
 **推荐**：公司统一的数据库连接信息放全局，项目特定的覆盖放本地。
 
 ### 优先级 4：工程配置文件（零配置，本地开发默认）
@@ -112,60 +113,43 @@ brew install mysql-client
 
 ## 多环境支持
 
-### 配置文件查找顺序
+### 配置文件结构
 
-```
-1. 本地项目：.claude/mysql-config.json
-2. 全局配置：~/.claude/mysql-config.json
-```
-
-本地配置优先。如果本地无配置，使用全局。两者都存在时，本地覆盖全局（同名环境取本地值）。
-
-### 配置文件结构（支持 range 范围匹配）
+`.claude/mysql-config.json` 支持多环境配置：
 
 ```json
 {
   "environments": {
-    "local": { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "xxx", "_desc": "本地环境" },
-    "dev":   { "host": "dev-db.example.com", "port": 3306, "user": "dev_user", "password": "xxx", "range": "1~15", "_desc": "覆盖 dev1→dev15" },
-    "test":  { "host": "test-db.example.com", "port": 3306, "user": "test_user", "password": "xxx", "range": "1~30", "_desc": "覆盖 test1→test30" },
+    "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"
 }
 ```
 
-### 环境范围匹配（range）
-
-`range` 字段支持 `起始~结束` 格式，用于一个配置覆盖多个编号环境：
-
-| 用户说法 | 匹配逻辑 | 结果 |
-|---------|---------|------|
-| "去 dev10 查" | 提取前缀 `dev`、编号 `10`，检查 dev 环境 range "1~15"，10 在范围内 | 使用 dev 配置 |
-| "连 test25" | 提取前缀 `test`、编号 `25`，检查 test 环境 range "1~30"，25 在范围内 | 使用 test 配置 |
-| "连 prod" | 精确匹配 prod 环境 | 使用 prod 配置 |
-
-**匹配算法**：
-```
-1. 用户输入的环境名（如 "dev10"）
-2. 先精确匹配环境 key（environments["dev10"]）
-3. 未命中 → 拆分为前缀+编号（"dev" + 10）
-4. 查找有 range 字段的环境，前缀匹配 + 编号在范围内
-5. 命中 → 使用该环境的 host/port/user/password
-```
-
 ### 环境选择规则
 
 | 优先级 | 来源 | 示例 |
 |--------|------|------|
-| 1（最高） | 用户对话中指定 | "连 dev10 环境查一下" |
+| 1（最高） | 用户对话中指定 | "连 dev 环境查一下"、"用生产库看看" |
 | 2 | 配置文件 `default` 字段 | `"default": "local"` |
 
+### 环境关键词映射
+
+用户说的话 → 对应环境名：
+
+| 用户说法 | 环境 |
+|---------|------|
+| "本地"、"local"、"本地环境" | `local` |
+| "开发"、"dev"、"测试环境"、"开发环境" | `dev` |
+| "生产"、"prod"、"线上"、"正式环境" | `prod` |
+
 ### 连接示例
 
 ```bash
-# 用户说"连 dev10 环境查一下 order_info"
-# → range 匹配到 dev 环境的连接信息 + 日志提取的数据库名
+# 用户说"连 dev 环境查一下 order_info"
+# → 读取 environments.dev 的连接信息 + 日志提取的数据库名
 mysql -h dev-db.example.com -P 3306 -u dev_user -p'xxx' 546198574447230976 -e "SELECT ..."
 ```
 

package/CLAUDE.md

@@ -219,6 +219,7 @@ CREATE TABLE [表名] (
 | **轻量** | 单表 CRUD、字段增删、简单查询 | `/dev` 或 `/crud` 直接开发 | 无需需求拆解 |
 | **中等** | 2-3 张表联动、跨 Service 调用、状态流转 | `/dev` 开发（可选 OpenSpec） | 建议先理清逻辑再编码 |
 | **复杂** | 多模块协作、复杂业务流程、需要设计评审 | OpenSpec → `/dev` | 先用 `/opsx:ff` 生成制品，再按 tasks 逐步实现 |
+| **大型项目** | 新项目从零开始、10+ 文件重构、多阶段里程碑 | `/gsd:new-project` 或 `/gsd:plan-phase` | GSD 编排 + Skills 执行 |
 
 ### 开发类型路由
 
@@ -249,3 +250,36 @@ tasks.md       ────→    /progress（跟踪进度）
 | `/check` | 代码规范检查 |
 | `/next` | 下一步建议（含 OpenSpec 变更扫描） |
 | `/progress` | 项目进度（含 OpenSpec 状态） |
+
+## GSD 集成（大型任务编排）
+
+本框架与 [GSD (Get Shit Done)](https://github.com/gsd-build/get-shit-done) 深度集成。GSD 负责项目编排，Skills 负责代码执行。
+
+### GSD + Skills 协作模式
+
+| GSD 阶段 | 自动激活的 Skills/Agents |
+|----------|------------------------|
+| `/gsd:debug` | 优先使用 `loki-runner` 查日志 + `mysql-runner` 查数据库 + `bug-analyzer` 根因分析 |
+| `/gsd:execute-phase` | 读取 `.claude/skills/` 自动应用项目编码规范（CRUD、API、数据库等） |
+| `/gsd:plan-phase` | 参考 Skills 中的架构设计和模块划分规范 |
+| `/gsd:verify-work` | 可调用 `auto-test-generator` 生成接口测试验证 |
+
+### 可用的领域 Agents（GSD 子 agent 可调用）
+
+| Agent | 能力 | 适用场景 |
+|-------|------|---------|
+| `loki-runner` | 查 Grafana Loki 线上日志 | debug 时查错误日志、traceId 链路 |
+| `mysql-runner` | 查 MySQL 数据库验证数据 | debug 时验证数据状态 |
+| `bug-analyzer` | 根因分析（含日志+数据库联动） | 复杂 Bug 的多维度排查 |
+| `code-scanner` | 快速扫描代码库定位文件 | 大型代码库的文件定位 |
+| `auto-test-generator` | 生成 Hurl 接口测试 | verify-work 阶段验证 |
+| `image-reader` | 读取 Axure 原型截图 | 需求分析阶段 |
+| `task-fetcher` | 获取云效任务信息 | 任务管理联动 |
+| `code-reviewer` | 代码审查（含 leniu 规范） | 执行完成后质量检查 |
+
+### 环境配置（GSD agent 共享）
+
+GSD 子 agent 可读取以下配置（全局或本地）：
+- `mysql-config.json` — 数据库连接（支持 range 环境匹配）
+- `loki-config.json` — Grafana Loki Token
+- 初始化：`npx ai-engineering-init config --type all --scope global`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-init",
-  "version": "1.16.2",
+  "version": "1.16.3",
   "description": "AI 工程化配置初始化工具 — 一键为 Claude Code、OpenAI Codex 等 AI 工具初始化 Skills 和项目规范",
   "keywords": [
     "claude-code",

package/src/skills/fix-bug/SKILL.md

@@ -197,6 +197,62 @@ Agent(mysql-runner, "根据日志发现涉及 order_info 表，查询 id=xxx 的
 | Bug 描述 + DB 信息 | bug-analyzer + mysql-runner | — |
 | Bug 描述 + traceId + DB 信息 | 全部 | 日志中有新表/ID → mysql-runner 追加查询 |
 
+## SQL 报表 Bug 专项流程
+
+当 Bug 涉及 **SQL 查询逻辑错误**（SUM/GROUP BY/CASE WHEN/金额计算等），启用以下验证流程：
+
+### 修复前：建立基线
+
+```
+1. 读取当前 Mapper XML，理解现有 SQL 逻辑
+2. 如果有已修复的参考查询（如同模块的明细查询），先读取其 SQL 逻辑作为正确参考
+3. 查库获取当前错误结果作为"修复前基线"（可选，用户提供 DB 时执行）
+```
+
+### 修复后：交叉验证（必须执行）
+
+**两步验证法**（以本项目销售汇总修复为典型案例）：
+
+```
+步骤 1：直接执行修改后的 SQL，验证基本逻辑
+  - 检查各记录类型是否正确处理（称重/按份、正向/逆向、入库/出库）
+  - 检查特殊值：NULL 处理、除零保护、边界条件
+
+步骤 2：交叉对比验证
+  - 方法 A：用已修复的明细查询做 SUM 汇总
+  - 方法 B：执行修改后的汇总查询
+  - 对比 A vs B：总计必须完全一致
+  - 按维度对比（按商品/按门店等）：逐行 MATCH/DIFF
+```
+
+### 验证 SQL 模板
+
+```sql
+-- 交叉验证：明细汇总 vs 汇总查询
+SELECT '明细汇总' as source, SUM(saleNum), SUM(cost), ...
+FROM (/* 明细查询逐行 */) detail
+UNION ALL
+SELECT '汇总查询' as source, ...
+FROM /* 汇总查询 */;
+
+-- 按维度逐行对比
+SELECT COALESCE(d.name, s.name) as name,
+       d.detail_value, s.summary_value,
+       CASE WHEN d.detail_value = s.summary_value THEN 'MATCH' ELSE 'DIFF' END as result
+FROM (/* 明细按维度 GROUP BY */) d
+LEFT JOIN (/* 汇总按维度 GROUP BY */) s ON d.id = s.id;
+```
+
+### SQL 修改注意事项
+
+| 规则 | 说明 |
+|------|------|
+| **保留 WHERE 条件** | 新增/修改查询必须包含与现有查询相同的过滤条件 |
+| **GROUP BY 优先** | 优先添加字段到 GROUP BY，不用 ANY_VALUE() |
+| **JOIN 一致性** | 主查询和合计查询的 JOIN 必须一致（如 drp_unit） |
+| **IFNULL 保护** | 除法运算中的分母必须用 IFNULL 防止除零 |
+| **业务类型分支** | CASE WHEN 必须覆盖所有业务类型（称重/按份、入库/出库等） |
+
 ## 提交规则
 
 修复完成后，**必须调用 `Skill(git-workflow)` 再执行 git 操作**。
@@ -210,3 +266,4 @@ Agent(mysql-runner, "根据日志发现涉及 order_info 表，查询 id=xxx 的
 - 简单 Bug 不要过度编排，直接修就行（但仍需先报告再修复）
 - 如果用户没提供 DB/Loki 信息但 Bug 涉及数据问题，主动询问
 - 与 `bug-detective` 技能的区别：`bug-detective` 是排查指南，`fix-bug` 是全流程编排（包含排查+修复+提交）
+- SQL 报表 Bug 修复后**必须执行交叉验证**，不能只看"能跑"就提交