@optima-chat/dev-skills 0.5.1 → 0.5.3

package/.claude/commands/query-db.md

@@ -68,9 +68,37 @@ optima-query-db commerce-backend "SELECT * FROM products LIMIT 5" prod
 
 ## Claude Code 执行步骤
 
-**首选方法**：使用 `optima-query-db` CLI 工具（见上方）
+**统一实现**：直接调用 `optima-query-db` CLI 工具
 
-**备用方法**：如果 CLI 工具不可用，根据用户指定的 `environment` 参数选择执行方式：
+```bash
+optima-query-db <service> "<sql>" [environment]
+```
+
+**示例**：
+```bash
+# 用户输入: /query-db user-auth "SELECT COUNT(*) FROM users"
+# 执行:
+optima-query-db user-auth "SELECT COUNT(*) FROM users"
+
+# 用户输入: /query-db commerce-backend "SELECT * FROM products LIMIT 5" stage
+# 执行:
+optima-query-db commerce-backend "SELECT * FROM products LIMIT 5" stage
+
+# 用户输入: /query-db user-auth "SELECT COUNT(*) FROM users" prod
+# 执行:
+optima-query-db user-auth "SELECT COUNT(*) FROM users" prod
+```
+
+**说明**：
+- CLI 工具会自动处理所有环境差异（CI/Stage/Prod）
+- 自动获取 Infisical 密钥
+- 自动管理 SSH 隧道
+
+---
+
+## 备用方法（仅当 CLI 工具不可用时）
+
+如果 `optima-query-db` 命令不存在，根据用户指定的 `environment` 参数选择执行方式：
 - `ci` 或未指定 → 通过 SSH 连接 Docker Postgres（第 0 节，默认）
 - `stage` → 通过 SSH 隧道访问 RDS（第 1 节）
 - `prod` → 通过 SSH 隧道访问 RDS（第 2 节）

package/.claude/skills/query-db/SKILL.md

@@ -8,29 +8,33 @@ allowed-tools: ["Bash", "SlashCommand"]
 
 当你需要执行 SQL 查询检查数据时，使用这个场景。
 
-## 🎯 推荐方式：使用 CLI 工具
+## 🎯 执行方式：统一使用 CLI 工具
 
-**最简单的方式**是直接使用 `optima-query-db` CLI 工具：
+**重要**：无论用户使用 `/query-db` 命令还是直接请求查询数据库，都应该使用 `optima-query-db` CLI 工具：
 
 ```bash
 optima-query-db <service> "<sql>" [environment]
 ```
 
-这个工具会自动处理：
-- ✅ 获取 Infisical 配置
-- ✅ 获取数据库密钥
-- ✅ 建立 SSH 隧道（Stage/Prod）
-- ✅ 执行查询
+**为什么使用 CLI 工具**：
+- ✅ 统一实现，避免重复代码
+- ✅ 自动处理所有环境差异
+- ✅ 自动获取 Infisical 配置和密钥
+- ✅ 自动管理 SSH 隧道（Stage/Prod）
+- ✅ 更简洁，一条命令搞定
 
 **示例**：
 ```bash
-# CI 环境（默认）
+# 用户说："查一下 CI 环境的 user-auth 数据库有多少用户"
+# 执行:
 optima-query-db user-auth "SELECT COUNT(*) FROM users"
 
-# Stage 环境
+# 用户说："查询 Stage 环境的商品数量"
+# 执行:
 optima-query-db commerce-backend "SELECT COUNT(*) FROM products" stage
 
-# Prod 环境
+# 用户输入: /query-db user-auth "SELECT COUNT(*) FROM users" prod
+# 执行:
 optima-query-db user-auth "SELECT COUNT(*) FROM users" prod
 ```
 

package/README.md

@@ -66,19 +66,32 @@ Claude:
 - **Stage** - 预发布环境，用于上线前的最终验证
 - **Prod** - 生产环境，服务真实用户
 
-## 🚀 可用命令
+## 🚀 Claude Code 命令
 
 | 命令 | 说明 | 示例 | 跨环境 |
 |------|------|------|--------|
 | `/logs` | 查看服务日志 | `/logs commerce-backend 100` | ✅ |
 | `/query-db` | 查询数据库 | `/query-db user-auth "SELECT COUNT(*) FROM users"` | ✅ |
-| `optima-query-db` | 数据库查询工具（CLI） | `optima-query-db user-auth "SELECT COUNT(*) FROM users" prod` | ✅ |
 
 **说明**：
 - 命令支持 CI、Stage、Prod 三个环境
 - 默认使用 CI 环境，适合日常开发
 - Claude Code 会根据上下文自动选择环境和执行方式
 
+## 🛠️ CLI 工具
+
+安装此包后，会全局安装以下 CLI 工具：
+
+| 工具 | 说明 | 示例 |
+|------|------|------|
+| `optima-query-db` | 数据库查询工具 | `optima-query-db user-auth "SELECT COUNT(*) FROM users" prod` |
+
+**特点**：
+- ✅ 支持 CI、Stage、Prod 三个环境
+- ✅ 自动管理 SSH 隧道和密钥
+- ✅ 可在任何终端直接使用
+- ✅ Claude Code 的 `/query-db` 命令内部也使用此工具
+
 ## 🏗️ 项目结构
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {