ai-engineering-init 1.11.0 → 1.12.0

package/.claude/{skills/openspec-apply-change/SKILL.md → commands/opsx-apply.md}

@@ -1,22 +1,4 @@
----
-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"
----
+# /opsx-apply - 实现 OpenSpec 变更任务
 
 Implement tasks from an OpenSpec change.
 

package/.claude/{skills/openspec-archive-change/SKILL.md → commands/opsx-archive.md}

@@ -1,21 +1,4 @@
----
-name: openspec-archive-change
-description: |
-  Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
-
-  触发场景：
-  - 变更实现完毕，需要归档保存
-  - 完成的变更需要移入 archive 目录
-  - 项目决策记录需要持久化保存
-
-  触发词：归档变更、归档、opsx:archive、openspec archive、完成变更、存档、归档完成
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-archive - 归档 OpenSpec 变更
 
 Archive a completed change in the experimental workflow.
 

package/.claude/{skills/openspec-bulk-archive-change/SKILL.md → commands/opsx-bulk-archive.md}

@@ -1,21 +1,4 @@
----
-name: openspec-bulk-archive-change
-description: |
-  Archive multiple completed changes at once. Use when archiving several parallel changes.
-
-  触发场景：
-  - 多个变更同时完成，需要批量归档
-  - 清理多个已完成的并行变更
-  - 需要处理多个变更之间的规格冲突后统一归档
-
-  触发词：批量归档、全部归档、opsx:bulk-archive、一起归档、归档所有变更、批量存档
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-bulk-archive - 批量归档 OpenSpec 变更
 
 Archive multiple completed changes in a single operation.
 

package/.claude/{skills/openspec-continue-change/SKILL.md → commands/opsx-continue.md}

@@ -1,21 +1,4 @@
----
-name: openspec-continue-change
-description: |
-  Continue working on an OpenSpec change by creating the next artifact. Use when the user wants to progress their change, create the next artifact, or continue their workflow.
-
-  触发场景：
-  - 需要继续推进已有变更的下一个制品
-  - 上次中断后恢复变更工作
-  - 逐步创建变更的 proposal/specs/design/tasks
-
-  触发词：继续变更、继续、opsx:continue、openspec continue、下一步、推进变更、继续工作
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-continue - 继续 OpenSpec 变更
 
 Continue working on a change by creating the next artifact.
 

package/.claude/{skills/openspec-explore/SKILL.md → commands/opsx-explore.md}

@@ -1,22 +1,4 @@
----
-name: openspec-explore
-description: |
-  Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
-
-  触发场景：
-  - 需要在实现前先探索和思考问题
-  - 比较多种技术方案的优劣
-  - 调查代码库中的现有架构和模式
-  - 在变更实现过程中遇到困惑需要深入分析
-
-  触发词：探索、opsx:explore、openspec explore、想一想、分析问题、调研方案、头脑风暴
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-explore - OpenSpec 探索模式
 
 Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
 

package/.claude/{skills/openspec-ff-change/SKILL.md → commands/opsx-ff.md}

@@ -1,21 +1,4 @@
----
-name: openspec-ff-change
-description: |
-  Fast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually.
-
-  触发场景：
-  - 需要快速一次性生成所有变更制品
-  - 跳过逐步创建，直接生成 proposal/specs/design/tasks
-  - 想快速启动一个变更并立即进入实现阶段
-
-  触发词：快速创建、快进、opsx:ff、openspec ff、一键生成、快速开始、fast forward
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-ff - 快速推进 OpenSpec 变更
 
 Fast-forward through artifact creation - generate everything needed to start implementation in one go.
 

package/.claude/{skills/openspec-new-change/SKILL.md → commands/opsx-new.md}

@@ -1,21 +1,4 @@
----
-name: openspec-new-change
-description: |
-  Start a new OpenSpec change using the experimental artifact workflow. Use when the user wants to create a new feature, fix, or modification with a structured step-by-step approach.
-
-  触发场景：
-  - 需要创建一个新的 OpenSpec 变更
-  - 开始一个新功能或修复的结构化工作流
-  - 初始化变更目录并查看第一个制品模板
-
-  触发词：新建变更、新变更、opsx:new、openspec new、创建变更、开始新功能、新增变更
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-new - 新建 OpenSpec 变更
 
 Start a new change using the experimental artifact-driven approach.
 

package/.claude/{skills/openspec-onboard/SKILL.md → commands/opsx-onboard.md}

@@ -1,21 +1,4 @@
----
-name: openspec-onboard
-description: |
-  Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
-
-  触发场景：
-  - 首次使用 OpenSpec，需要引导式教学
-  - 想通过实际操作学习 OpenSpec 完整工作流
-  - 需要了解 OpenSpec 的所有命令和流程
-
-  触发词：入门、onboard、opsx:onboard、openspec 教程、学习 openspec、新手引导、openspec 入门
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-onboard - OpenSpec 新手引导
 
 Guide the user through their first complete OpenSpec workflow cycle. This is a teaching experience—you'll do real work in their codebase while explaining each step.
 

package/.claude/{skills/openspec-sync-specs/SKILL.md → commands/opsx-sync.md}

@@ -1,21 +1,4 @@
----
-name: openspec-sync-specs
-description: |
-  Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
-
-  触发场景：
-  - 需要将变更中的增量规格同步到主规格
-  - 变更的 delta spec 需要合并到 openspec/specs 目录
-  - 在归档前手动同步规格变更
-
-  触发词：同步规格、同步specs、opsx:sync、openspec sync、合并规格、同步变更规格
-license: MIT
-compatibility: Requires openspec CLI.
-metadata:
-  author: openspec
-  version: "1.0"
-  generatedBy: "1.1.1"
----
+# /opsx-sync - 同步 OpenSpec 规格
 
 Sync delta specs from a change to main specs.
 

package/.claude/{skills/openspec-verify-change/SKILL.md → commands/opsx-verify.md}

@@ -1,21 +1,4 @@
----
-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"
----
+# /opsx-verify - 验证 OpenSpec 变更
 
 Verify that an implementation matches the change artifacts (specs, tasks, design).
 

package/.claude/hooks/skill-forced-eval.js

@@ -96,16 +96,6 @@ const instructions = `## 强制技能激活流程（必须执行）
 - sms-mail: 短信/邮件/SMS/验证码/通知
 - social-login: 第三方登录/OAuth/OAuth2/社交登录/授权登录
 - tenant-management: 多租户/租户隔离/SaaS/数据隔离
-- openspec-new-change: 新建变更/开始新功能/opsx:new/openspec new
-- openspec-ff-change: 快速推进/opsx:ff/openspec ff/fast-forward
-- openspec-apply-change: 实现任务/opsx:apply/openspec apply
-- openspec-continue-change: 继续变更/opsx:continue/openspec continue
-- openspec-archive-change: 归档变更/opsx:archive/openspec archive
-- openspec-bulk-archive-change: 批量归档/opsx:bulk-archive
-- openspec-explore: 探索模式/opsx:explore/openspec explore
-- openspec-onboard: 新手引导/opsx:onboard/openspec onboard
-- openspec-sync-specs: 同步规格/opsx:sync/openspec sync
-- openspec-verify-change: 验证变更/opsx:verify/openspec verify
 - ui-pc: 前端组件/Element UI/页面开发
 - store-pc: Vuex/状态管理/store模块
 - mysql-debug: MySQL调试/查数据库/执行SQL/数据库排查

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

@@ -1,7 +1,7 @@
 ---
 name: fix-bug
 description: |
-  Bug 修复全流程编排。强制使用并行 Agent 模式进行排查，修复后走 git-workflow 提交。
+  Bug 修复全流程编排。两阶段 Agent 排查 + 报告确认 + git-workflow 提交。
 
   触发场景：
   - 修复 Bug（含日志/traceId/数据库信息）
@@ -16,20 +16,20 @@ description: |
 
 ## 核心原则
 
-**先判断复杂度，简单 Bug 直接修，复杂 Bug 走并行 Agent。修复后必须走 git-workflow 提交。**
+**先判断复杂度，简单 Bug 直接修，复杂 Bug 走两阶段 Agent 排查。搞清原因后先出报告，用户确认后再修复代码。**
 
 ## 步骤 0：复杂度判断（必须先做）
 
 ```
 用户提供 Bug 线索
   │
-  ├─ 简单 Bug？ ──→ 快速路径（直接读代码修复）
+  ├─ 简单 Bug？ ──→ 快速路径
   │   - 明显的代码错误（NPE、空判断遗漏、拼写错误）
   │   - 用户已明确指出问题和修改方案
   │   - 单文件改动，逻辑清晰
   │   - 不需要查数据库/日志验证
   │
-  └─ 复杂 Bug？ ──→ Agent 路径（并行排查）
+  └─ 复杂 Bug？ ──→ Agent 路径（两阶段排查）
       - 需要查日志确认线上行为（提供了 traceId）
       - 需要查数据库验证数据正确性（提供了 DB 信息）
       - 问题根因不明确，需要多维度分析
@@ -39,10 +39,10 @@ description: |
 ## 快速路径（简单 Bug）
 
 ```
-读代码 → 定位问题 → 修复 → 走 git-workflow 提交
+读代码 → 定位问题 → 输出排查报告 → 用户确认 → 修复 → git-workflow 提交
 ```
 
-不启动 Agent，直接在主对话中完成。
+不启动 Agent，直接在主对话中完成。即使是简单 Bug，也先说明问题原因和修复方案，等用户确认再动手。
 
 ## Agent 路径（复杂 Bug）
 
@@ -53,31 +53,111 @@ description: |
   - Loki 日志环境
   - Bug 描述 / 期望行为
 
-步骤 2：并行启动 Agent（必须同时启动，不串行）
-  ├── bug-analyzer Agent: 读代码分析根因，给出修复方案
-  ├── mysql-runner Agent: 查数据库验证数据（如提供了DB信息）
-  └── loki-runner Agent: 查 Loki 日志验证线上行为（如提供了traceId）
+步骤 2（阶段一）：并行启动 Agent
+  ├── bug-analyzer: 读代码分析根因
+  ├── loki-runner: 查 Loki 日志（有 traceId 时）
+  └── mysql-runner: 查数据库验证数据（有 DB 信息时）
 
-步骤 3：汇总 Agent 结果 → 确认修复方案
+步骤 3（阶段二）：日志驱动二次查询
+  从 loki-runner 结果中提取：
+  ├── 表名（INSERT/UPDATE/DELETE/FROM/JOIN 后面的表名）
+  ├── 数据 ID（id=xxx、orderId=xxx 等）
+  ├── 租户 ID（tenantId、MERCHANT-ID 请求头）
+  └── SQL 语句片段
+  如果提取到有效的表名+ID → 自动启动 mysql-runner 二次查询
 
-步骤 4：修复代码
+步骤 4：汇总所有结果 → 输出排查报告（见下方模板）
 
-步骤 5：走 git-workflow 提交
+步骤 5：⏸️ 等待用户确认修复方案
+
+步骤 6：用户确认后 → 修复代码
+
+步骤 7：走 git-workflow 提交
 ```
 
+## 排查报告模板（必须输出）
+
+无论简单还是复杂 Bug，修复代码前**必须先输出报告**：
+
+```markdown
+## 🔍 Bug 排查报告
+
+### 问题描述
+{用户报告的现象}
+
+### 根因分析
+{代码层面的根本原因，指出具体文件和行号}
+
+### 数据验证（如有）
+{从日志/数据库中发现的关键数据，证实根因}
+
+### 修复方案
+- 修改文件：`xxx.java` 第 N 行
+- 修改内容：{具体改动描述}
+- 影响范围：{改动是否影响其他功能}
+
+### 风险评估
+- 低/中/高
+- {风险说明}
+
+---
+确认修复请回复"修"，需要调整方案请说明。
+```
+
+**⚠️ 禁止跳过报告直接修改代码。必须等用户明确确认后才能开始修复。**
+
+## 阶段二：日志驱动二次查询
+
+当阶段一的 loki-runner 返回日志后，主会话检查日志内容：
+
+```
+loki-runner 返回日志
+  │
+  ├─ 日志中包含 SQL/表名/数据ID？
+  │   │
+  │   ├─ 阶段一已启动 mysql-runner？
+  │   │   → 检查是否需要追加查询（不同的表或ID）
+  │   │   → 需要则启动新的 mysql-runner 查询
+  │   │
+  │   └─ 阶段一未启动 mysql-runner？
+  │       → 从日志提取表名+ID+租户ID
+  │       → 自动启动 mysql-runner 二次查询
+  │
+  └─ 日志中无数据库相关信息？
+      → 跳过，直接汇总现有结果
+```
+
+### 日志中常见的可提取信息
+
+| 日志模式 | 提取内容 | 查询方式 |
+|---------|---------|---------|
+| `INSERT INTO order_info` | 表名 order_info | `SELECT * FROM order_info WHERE id = ?` |
+| `UPDATE account SET balance=` | 表名 account | `SELECT * FROM account WHERE id = ?` |
+| `orderId=123456` | 数据 ID | 按 ID 查对应表 |
+| `MERCHANT-ID: 100` | 租户 ID | 切换到对应租户库查询 |
+| `Duplicate entry 'xxx'` | 唯一键冲突 | 查重复数据 |
+| `Data truncation` | 字段溢出 | 查表结构 `DESC table_name` |
+
 ## Agent 启动规则
 
-### 必须并行（单条消息多个 Agent tool call）
+### 阶段一：必须并行（单条消息多个 Agent tool call）
 
 ```
-# 正确：一条消息同时启动 3 个 Agent
+# 正确：一条消息同时启动
 Agent(bug-analyzer, "分析 xxx 代码的 bug...")
-Agent(mysql-runner, "查询 xxx 数据库验证...")
 Agent(loki-runner, "查询 traceId xxx 的日志...")
+Agent(mysql-runner, "查询 xxx 数据库验证...")
 
 # 错误：串行启动（等一个完再启动下一个）
 ```
 
+### 阶段二：按需启动（阶段一结果返回后）
+
+```
+# 从 loki-runner 结果中发现了表名和数据ID
+Agent(mysql-runner, "根据日志发现涉及 order_info 表，查询 id=xxx 的数据...")
+```
+
 ### 各 Agent 职责
 
 | Agent | subagent_type | 职责 | 输入 |
@@ -106,50 +186,16 @@ Agent(loki-runner, "查询 traceId xxx 的日志...")
   └─ 配置文件不存在？ → 创建模板文件（占位符） → 提示用户填写 → 等确认后继续
 ```
 
-**创建 MySQL 模板**：
-```json
-{
-  "environments": {
-    "test21": {
-      "name": "test21 测试环境",
-      "host": "YOUR_HOST",
-      "port": 3306,
-      "user": "YOUR_USER",
-      "password": "YOUR_PASSWORD",
-      "db_prefix": "testcore_",
-      "aliases": ["test21", "21"]
-    }
-  },
-  "default": "test21",
-  "mysql_path": "/opt/homebrew/opt/mysql-client/bin/mysql"
-}
-```
-
-**创建 Loki 模板**：
-```json
-{
-  "active": "test13",
-  "environments": {
-    "test13": {
-      "name": "测试13（主测试环境）",
-      "url": "https://test13.xnzn.net/grafana",
-      "token": "YOUR_TOKEN",
-      "aliases": ["test13", "13"]
-    }
-  }
-}
-```
-
 **敏感信息由用户手动填写，禁止 AI 将对话中的密码/token 写入配置文件。**
 
 ### 按信息量决定启动哪些 Agent
 
-| 用户提供的信息 | 启动的 Agent |
-|---------------|-------------|
-| 只有 Bug 描述 | bug-analyzer |
-| Bug 描述 + traceId | bug-analyzer + loki-runner |
-| Bug 描述 + DB 信息 | bug-analyzer + mysql-runner |
-| Bug 描述 + traceId + DB 信息 | bug-analyzer + mysql-runner + loki-runner（全部） |
+| 用户提供的信息 | 阶段一启动 | 阶段二（日志驱动） |
+|---------------|-----------|-----------------|
+| 只有 Bug 描述 | bug-analyzer | — |
+| Bug 描述 + traceId | bug-analyzer + loki-runner | 日志中有表名/ID → mysql-runner |
+| Bug 描述 + DB 信息 | bug-analyzer + mysql-runner | — |
+| Bug 描述 + traceId + DB 信息 | 全部 | 日志中有新表/ID → mysql-runner 追加查询 |
 
 ## 提交规则
 
@@ -161,6 +207,6 @@ Agent(loki-runner, "查询 traceId xxx 的日志...")
 
 ## 注意
 
-- 简单 Bug 不要过度编排，直接修就行
+- 简单 Bug 不要过度编排，直接修就行（但仍需先报告再修复）
 - 如果用户没提供 DB/Loki 信息但 Bug 涉及数据问题，主动询问
 - 与 `bug-detective` 技能的区别：`bug-detective` 是排查指南，`fix-bug` 是全流程编排（包含排查+修复+提交）

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

@@ -140,7 +140,7 @@ print('Token updated for monitor-dev')
 ```bash
 TRACE_ID="a53dd0b0cc62bf4a79a63e77444f6f3f"
 END=$(date +%s)000000000
-START=$(( $(date +%s) - 86400 ))000000000
+START=$(( $(date +%s) - 21600 ))000000000  # 最近6小时
 
 curl -s "${API}/query_range" \
   -H "Authorization: Bearer ${TOKEN}" \
@@ -172,7 +172,7 @@ else:
 ```bash
 API_PATH="/security/summary/order/mealtime/classify/page"
 END=$(date +%s)000000000
-START=$(( $(date +%s) - 3600 ))000000000  # 最近1小时
+START=$(( $(date +%s) - 21600 ))000000000  # 最近6小时
 
 curl -s "${API}/query_range" \
   -H "Authorization: Bearer ${TOKEN}" \
@@ -221,7 +221,7 @@ if len(all_lines) > 30:
 ```bash
 KEYWORD="LeException"
 END=$(date +%s)000000000
-START=$(( $(date +%s) - 3600 ))000000000
+START=$(( $(date +%s) - 21600 ))000000000  # 最近6小时
 
 curl -s "${API}/query_range" \
   -H "Authorization: Bearer ${TOKEN}" \
@@ -269,7 +269,7 @@ curl -s "${API}/query_range" \
 # Step 1: 找 traceId
 API_PATH="/api/v2/web/order/list"
 END=$(date +%s)000000000
-START=$(( $(date +%s) - 3600 ))000000000
+START=$(( $(date +%s) - 21600 ))000000000  # 最近6小时
 
 TRACE_IDS=$(curl -s "${API}/query_range" \
   -H "Authorization: Bearer ${TOKEN}" \