@optima-chat/dev-skills 0.5.4 → 0.6.0

package/.claude/commands/generate-test-token.md

@@ -15,18 +15,22 @@
 使用 `optima-generate-test-token` CLI 工具，它会自动完成所有设置：
 
 ```bash
-# 使用默认配置（随机生成账户信息）
+# Development 环境（默认）
 optima-generate-test-token
 
+# Production 环境
+optima-generate-test-token --env production
+
 # 自定义商户名称
-optima-generate-test-token --business-name "我的测试店铺"
+optima-generate-test-token --business-name "我的测试店铺" --env production
 
 # 完全自定义
 optima-generate-test-token \
   --email "custom@example.com" \
   --password "MyPass123" \
   --business-name "Custom Shop" \
-  --phone "+1234567890"
+  --phone "+1234567890" \
+  --env production
 ```
 
 ## 工作流程
@@ -85,6 +89,7 @@ curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-xxx.txt)" \
 - `--business-name <name>` - 商户名称（默认：自动生成）
 - `--phone <phone>` - 联系电话（可选）
 - `--address <address>` - 地址（可选）
+- `--env <environment>` - 环境：development（默认）或 production
 - `--help, -h` - 显示帮助信息
 
 ## 示例
@@ -136,10 +141,10 @@ commerce product create \
 
 ## ⚠️ 注意事项
 
-1. **仅用于开发环境** - 这些测试账户连接到 development 环境（api.optima.chat）
+1. **支持两个环境** - Development（默认）和 Production，通过 `--env` 参数指定
 2. **Token 有效期** - Token 默认有效期 15 分钟，请及时使用
 3. **临时文件** - Token 保存在系统临时目录，重启后可能被清理
-4. **环境变量** - 使用 commerce CLI 时需要设置 `OPTIMA_ENV=development`
+4. **环境变量** - 使用 commerce CLI 时需要设置对应的 `OPTIMA_ENV`（development 或 production）
 
 ## 🔗 相关资源
 
@@ -154,7 +159,12 @@ commerce product create \
 2. `POST /api/v1/oauth/token` - 获取 access token（password grant）
 3. `POST /api/merchants/me` - 设置 merchant profile
 
-**使用的 Client ID**: `dev-skill-cli-he7fjmsp`
+**环境配置**：
+
+| 环境 | Auth API | Commerce API | Client ID |
+|------|----------|--------------|-----------|
+| Development（默认） | auth.optima.chat | api.optima.chat | dev-skill-cli-he7fjmsp |
+| Production | auth.optima.shop | api.optima.shop | dev-skill-cli-0cyyqxox |
 
 **默认 Merchant 信息**：
 - 发货地址：中国深圳南山区科技园

package/.claude/skills/generate-test-token/SKILL.md

@@ -36,17 +36,21 @@ optima-generate-test-token [options]
 ### 基本使用
 
 ```bash
-# 使用默认配置（最简单）
+# Development 环境（默认）
 optima-generate-test-token
 
+# Production 环境
+optima-generate-test-token --env production
+
 # 自定义商户名称
-optima-generate-test-token --business-name "我的测试店铺"
+optima-generate-test-token --business-name "我的测试店铺" --env production
 
 # 完全自定义
 optima-generate-test-token \
   --email "test@example.com" \
   --password "MyPassword123" \
-  --business-name "测试商店"
+  --business-name "测试商店" \
+  --env production
 ```
 
 ### 使用生成的 Token

package/.claude/skills/use-commerce-cli/SKILL.md

@@ -53,6 +53,12 @@ commerce init
 
 ## 环境说明
 
-`optima-generate-test-token` 生成的 token 连接到：
+`optima-generate-test-token` 支持两个环境：
+
+**Development**（默认）：
 - API: `api.optima.chat`
 - 环境变量：`OPTIMA_ENV=development`
+
+**Production**（使用 `--env production`）：
+- API: `api.optima.shop`
+- 环境变量：`OPTIMA_ENV=production`

package/README.md

@@ -23,13 +23,14 @@ Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个
 - **任务驱动** - 基于具体任务场景（查看日志、调用 API），不是抽象分类
 - **跨环境协作** - 统一的命令在 CI、Stage、Prod 三个环境中使用
 
-## 📋 任务场景（3 个）
+## 📋 任务场景（4 个）
 
 当 Claude Code 识别到以下任务时，会自动加载对应的 Skill：
 
 - **logs** - 查看 CI/Stage/Prod 的服务器日志
 - **query-db** - 查询 CI/Stage/Prod 的数据库
 - **generate-test-token** - 生成测试 Access Token 用于 API 测试
+- **use-commerce-cli** - 使用 Commerce CLI 管理电商店铺
 
 ## 👤 用户故事
 
@@ -103,14 +104,20 @@ Claude:
 optima-dev-skills/
 ├── .claude/
 │   ├── commands/
-│   │   ├── logs.md              # /logs - 查看服务日志
-│   │   └── query-db.md          # /query-db - 查询数据库
+│   │   ├── logs.md                    # /logs - 查看服务日志
+│   │   ├── query-db.md                # /query-db - 查询数据库
+│   │   └── generate-test-token.md     # /generate-test-token - 生成测试 token
 │   │
 │   └── skills/
-│       ├── logs/                # 日志查看 skill
-│       │   └── SKILL.md
-│       └── query-db/            # 数据库查询 skill
-│           └── SKILL.md
+│       ├── logs/                      # 日志查看 skill
+│       ├── query-db/                  # 数据库查询 skill
+│       ├── generate-test-token/       # 测试 token 生成 skill
+│       └── use-commerce-cli/          # Commerce CLI 使用 skill
+│
+├── bin/
+│   └── helpers/
+│       ├── query-db.ts                # CLI: 数据库查询
+│       └── generate-test-token.ts     # CLI: 生成测试 token
 │
 └── docs/
     └── COMMANDS_DESIGN.md
@@ -132,22 +139,35 @@ Claude:
 3. 问题定位：Stage RDS 连接配置问题
 ```
 
-### 示例 2：使用 CLI 工具快速查询
+### 示例 2：生成测试 token 并管理店铺
 
 ```bash
-# 查询 Prod 用户数
-$ optima-query-db user-auth "SELECT COUNT(*) FROM users" prod
+# 1. 生成测试 token
+$ optima-generate-test-token
+
+✅ Test token generated successfully!
+📁 Token File Path: /tmp/optima-test-token-xxx.txt
+
+# 2. 使用 token 创建商品
+$ OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+  OPTIMA_ENV=development \
+  commerce product create --title "测试商品" --price 99.99 --stock 100
+
+{
+  "success": true,
+  "data": {
+    "product_id": "xxx",
+    "name": "测试商品",
+    "price": "99.99"
+  }
+}
+```
 
-🔍 Querying user-auth (PROD)...
-✓ Loaded Infisical config from GitHub Variables
-✓ Obtained Infisical access token
-✓ Retrieved database credentials from Infisical
-✓ SSH tunnel established on port 15433
+### 示例 3：使用 CLI 工具快速查询
 
- count
--------
-    26
-(1 行记录)
+```bash
+# 查询 Prod 用户数
+$ optima-query-db user-auth "SELECT COUNT(*) FROM users" prod
 
 # 查询 Stage 商品列表
 $ optima-query-db commerce-backend "SELECT id, title FROM products LIMIT 5" stage
@@ -202,16 +222,17 @@ $ optima-query-db commerce-backend "SELECT id, title FROM products LIMIT 5" stag
 
 ## 🛠️ 开发状态
 
-**当前版本**: 0.5.0
+**当前版本**: 0.5.4
 
 **已完成**:
-- ✅ 2 个跨环境命令：`/logs`、`/query-db`
-- ✅ 2 个任务场景：`logs` skill、`query-db` skill
+- ✅ 3 个跨环境命令：`/logs`、`/query-db`、`/generate-test-token`
+- ✅ 4 个任务场景：`logs`、`query-db`、`generate-test-token`、`use-commerce-cli`
 - ✅ 支持 CI、Stage、Prod 三个环境
 - ✅ CI 环境通过 SSH + Docker 访问
 - ✅ Stage/Prod 通过 SSH 隧道访问 RDS
-- ✅ TypeScript CLI 工具：`optima-query-db`
+- ✅ TypeScript CLI 工具：`optima-query-db`、`optima-generate-test-token`
 - ✅ 通过 Infisical 动态获取密钥
+- ✅ 自动生成测试 token 并设置 merchant profile
 
 **设计原则**:
 - 命令提供信息（URL、路径、凭证位置），不实现复杂逻辑

package/bin/helpers/generate-test-token.ts

@@ -24,9 +24,29 @@ interface MerchantSetupResponse {
   user_id: string;
 }
 
-const AUTH_BASE_URL = 'https://auth.optima.chat';
-const COMMERCE_API_URL = 'https://api.optima.chat';
-const DEFAULT_CLIENT_ID = 'dev-skill-cli-he7fjmsp';
+type Environment = 'development' | 'production';
+
+interface EnvironmentConfig {
+  authUrl: string;
+  apiUrl: string;
+  clientId: string;
+  envName: string;
+}
+
+const ENV_CONFIG: Record<Environment, EnvironmentConfig> = {
+  development: {
+    authUrl: 'https://auth.optima.chat',
+    apiUrl: 'https://api.optima.chat',
+    clientId: 'dev-skill-cli-he7fjmsp',
+    envName: 'development'
+  },
+  production: {
+    authUrl: 'https://auth.optima.shop',
+    apiUrl: 'https://api.optima.shop',
+    clientId: 'dev-skill-cli-0cyyqxox',
+    envName: 'production'
+  }
+};
 
 async function httpRequest<T>(url: string, options: RequestInit = {}): Promise<T> {
   const response = await fetch(url, {
@@ -49,6 +69,7 @@ async function registerMerchant(
   email: string,
   password: string,
   businessName: string,
+  config: EnvironmentConfig,
   phone?: string,
   address?: string
 ): Promise<RegisterResponse> {
@@ -59,7 +80,7 @@ async function registerMerchant(
   if (address) payload.address = address;
 
   try {
-    const result = await httpRequest<RegisterResponse>(`${AUTH_BASE_URL}/api/v1/auth/register/merchant`, {
+    const result = await httpRequest<RegisterResponse>(`${config.authUrl}/api/v1/auth/register/merchant`, {
       method: 'POST',
       body: JSON.stringify(payload)
     });
@@ -75,16 +96,16 @@ async function registerMerchant(
   }
 }
 
-async function getToken(email: string, password: string, clientId: string = DEFAULT_CLIENT_ID): Promise<string> {
+async function getToken(email: string, password: string, config: EnvironmentConfig): Promise<string> {
   console.log(`\n🔑 Obtaining access token...`);
 
   const formData = new URLSearchParams();
   formData.append('username', email);
   formData.append('password', password);
   formData.append('grant_type', 'password');
-  formData.append('client_id', clientId);
+  formData.append('client_id', config.clientId);
 
-  const result = await httpRequest<TokenResponse>(`${AUTH_BASE_URL}/api/v1/oauth/token`, {
+  const result = await httpRequest<TokenResponse>(`${config.authUrl}/api/v1/oauth/token`, {
     method: 'POST',
     headers: {
       'Content-Type': 'application/x-www-form-urlencoded'
@@ -96,7 +117,7 @@ async function getToken(email: string, password: string, clientId: string = DEFA
   return result.access_token;
 }
 
-async function setupMerchantProfile(token: string, businessName: string): Promise<MerchantSetupResponse> {
+async function setupMerchantProfile(token: string, businessName: string, config: EnvironmentConfig): Promise<MerchantSetupResponse> {
   console.log(`\n🏪 Setting up merchant profile in Commerce API...`);
 
   const payload = {
@@ -111,7 +132,7 @@ async function setupMerchantProfile(token: string, businessName: string): Promis
   };
 
   try {
-    const result = await httpRequest<MerchantSetupResponse>(`${COMMERCE_API_URL}/api/merchants/me`, {
+    const result = await httpRequest<MerchantSetupResponse>(`${config.apiUrl}/api/merchants/me`, {
       method: 'POST',
       headers: {
         Authorization: `Bearer ${token}`
@@ -145,6 +166,7 @@ async function main() {
   let businessName = defaultBusinessName;
   let phone: string | undefined;
   let address: string | undefined;
+  let environment: Environment = 'development';
 
   // 解析命令行参数
   for (let i = 0; i < args.length; i++) {
@@ -160,6 +182,14 @@ async function main() {
       phone = args[++i];
     } else if (arg === '--address' && args[i + 1]) {
       address = args[++i];
+    } else if (arg === '--env' && args[i + 1]) {
+      const envArg = args[++i];
+      if (envArg === 'development' || envArg === 'production') {
+        environment = envArg;
+      } else {
+        console.error(`❌ Invalid environment: ${envArg}. Must be 'development' or 'production'.`);
+        process.exit(1);
+      }
     } else if (arg === '--help' || arg === '-h') {
       console.log(`
 Usage: generate-test-token [options]
@@ -170,32 +200,39 @@ Options:
   --business-name <name>       Merchant business name (default: auto-generated)
   --phone <phone>              Merchant phone number (optional)
   --address <address>          Merchant address (optional)
+  --env <environment>          Environment: development (default) or production
   --help, -h                   Show this help message
 
 Example:
   generate-test-token
+  generate-test-token --env production
   generate-test-token --business-name "My Test Shop" --phone "+1234567890"
-  generate-test-token --email "custom@example.com" --password "MyPass123"
+  generate-test-token --email "custom@example.com" --password "MyPass123" --env production
       `);
       process.exit(0);
     }
   }
 
+  const config = ENV_CONFIG[environment];
+
   try {
     console.log('🚀 Starting test token generation...\n');
+    console.log(`Environment: ${config.envName}`);
+    console.log(`Auth API: ${config.authUrl}`);
+    console.log(`Commerce API: ${config.apiUrl}\n`);
     console.log(`Using credentials:`);
     console.log(`  Email: ${email}`);
     console.log(`  Password: ${password}`);
     console.log(`  Business Name: ${businessName}`);
 
     // 1. 注册 merchant（直接注册为商家）
-    const user = await registerMerchant(email, password, businessName, phone, address);
+    const user = await registerMerchant(email, password, businessName, config, phone, address);
 
     // 2. 获取 token
-    const token = await getToken(email, password);
+    const token = await getToken(email, password, config);
 
     // 3. 设置 merchant profile（Commerce API）
-    const merchantProfile = await setupMerchantProfile(token, businessName);
+    const merchantProfile = await setupMerchantProfile(token, businessName, config);
 
     // 4. 保存 token 到临时文件
     const tmpDir = os.tmpdir();
@@ -209,6 +246,7 @@ Example:
     console.log('\n' + '='.repeat(80));
     console.log('✅ Test token generated successfully!\n');
     console.log('📋 Details:');
+    console.log(`  Environment:   ${config.envName}`);
     console.log(`  Email:         ${email}`);
     console.log(`  Password:      ${password}`);
     console.log(`  User ID:       ${user.user_id || 'N/A'}`);
@@ -221,9 +259,9 @@ Example:
     console.log(`  # Read token from file:`);
     console.log(`  TOKEN=$(cat ${tokenFilePath})\n`);
     console.log(`  # Use with commerce CLI:`);
-    console.log(`  OPTIMA_TOKEN=$(cat ${tokenFilePath}) OPTIMA_ENV=development commerce product list\n`);
+    console.log(`  OPTIMA_TOKEN=$(cat ${tokenFilePath}) OPTIMA_ENV=${config.envName} commerce product list\n`);
     console.log(`  # Use in curl:`);
-    console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" https://api.optima.chat/api/products\n`);
+    console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" ${config.apiUrl}/api/products\n`);
     console.log('='.repeat(80));
 
   } catch (error: any) {

package/dist/bin/helpers/generate-test-token.js

@@ -37,9 +37,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
-const AUTH_BASE_URL = 'https://auth.optima.chat';
-const COMMERCE_API_URL = 'https://api.optima.chat';
-const DEFAULT_CLIENT_ID = 'dev-skill-cli-he7fjmsp';
+const ENV_CONFIG = {
+    development: {
+        authUrl: 'https://auth.optima.chat',
+        apiUrl: 'https://api.optima.chat',
+        clientId: 'dev-skill-cli-he7fjmsp',
+        envName: 'development'
+    },
+    production: {
+        authUrl: 'https://auth.optima.shop',
+        apiUrl: 'https://api.optima.shop',
+        clientId: 'dev-skill-cli-0cyyqxox',
+        envName: 'production'
+    }
+};
 async function httpRequest(url, options = {}) {
     const response = await fetch(url, {
         ...options,
@@ -54,7 +65,7 @@ async function httpRequest(url, options = {}) {
     }
     return response.json();
 }
-async function registerMerchant(email, password, businessName, phone, address) {
+async function registerMerchant(email, password, businessName, config, phone, address) {
     console.log(`\n📝 Registering merchant: ${email}...`);
     const payload = { email, password, business_name: businessName };
     if (phone)
@@ -62,7 +73,7 @@ async function registerMerchant(email, password, businessName, phone, address) {
     if (address)
         payload.address = address;
     try {
-        const result = await httpRequest(`${AUTH_BASE_URL}/api/v1/auth/register/merchant`, {
+        const result = await httpRequest(`${config.authUrl}/api/v1/auth/register/merchant`, {
             method: 'POST',
             body: JSON.stringify(payload)
         });
@@ -77,14 +88,14 @@ async function registerMerchant(email, password, businessName, phone, address) {
         throw error;
     }
 }
-async function getToken(email, password, clientId = DEFAULT_CLIENT_ID) {
+async function getToken(email, password, config) {
     console.log(`\n🔑 Obtaining access token...`);
     const formData = new URLSearchParams();
     formData.append('username', email);
     formData.append('password', password);
     formData.append('grant_type', 'password');
-    formData.append('client_id', clientId);
-    const result = await httpRequest(`${AUTH_BASE_URL}/api/v1/oauth/token`, {
+    formData.append('client_id', config.clientId);
+    const result = await httpRequest(`${config.authUrl}/api/v1/oauth/token`, {
         method: 'POST',
         headers: {
             'Content-Type': 'application/x-www-form-urlencoded'
@@ -94,7 +105,7 @@ async function getToken(email, password, clientId = DEFAULT_CLIENT_ID) {
     console.log(`✓ Access token obtained`);
     return result.access_token;
 }
-async function setupMerchantProfile(token, businessName) {
+async function setupMerchantProfile(token, businessName, config) {
     console.log(`\n🏪 Setting up merchant profile in Commerce API...`);
     const payload = {
         name: businessName,
@@ -107,7 +118,7 @@ async function setupMerchantProfile(token, businessName) {
         contact_email: 'test@example.com'
     };
     try {
-        const result = await httpRequest(`${COMMERCE_API_URL}/api/merchants/me`, {
+        const result = await httpRequest(`${config.apiUrl}/api/merchants/me`, {
             method: 'POST',
             headers: {
                 Authorization: `Bearer ${token}`
@@ -138,6 +149,7 @@ async function main() {
     let businessName = defaultBusinessName;
     let phone;
     let address;
+    let environment = 'development';
     // 解析命令行参数
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -156,6 +168,16 @@ async function main() {
         else if (arg === '--address' && args[i + 1]) {
             address = args[++i];
         }
+        else if (arg === '--env' && args[i + 1]) {
+            const envArg = args[++i];
+            if (envArg === 'development' || envArg === 'production') {
+                environment = envArg;
+            }
+            else {
+                console.error(`❌ Invalid environment: ${envArg}. Must be 'development' or 'production'.`);
+                process.exit(1);
+            }
+        }
         else if (arg === '--help' || arg === '-h') {
             console.log(`
 Usage: generate-test-token [options]
@@ -166,28 +188,34 @@ Options:
   --business-name <name>       Merchant business name (default: auto-generated)
   --phone <phone>              Merchant phone number (optional)
   --address <address>          Merchant address (optional)
+  --env <environment>          Environment: development (default) or production
   --help, -h                   Show this help message
 
 Example:
   generate-test-token
+  generate-test-token --env production
   generate-test-token --business-name "My Test Shop" --phone "+1234567890"
-  generate-test-token --email "custom@example.com" --password "MyPass123"
+  generate-test-token --email "custom@example.com" --password "MyPass123" --env production
       `);
             process.exit(0);
         }
     }
+    const config = ENV_CONFIG[environment];
     try {
         console.log('🚀 Starting test token generation...\n');
+        console.log(`Environment: ${config.envName}`);
+        console.log(`Auth API: ${config.authUrl}`);
+        console.log(`Commerce API: ${config.apiUrl}\n`);
         console.log(`Using credentials:`);
         console.log(`  Email: ${email}`);
         console.log(`  Password: ${password}`);
         console.log(`  Business Name: ${businessName}`);
         // 1. 注册 merchant（直接注册为商家）
-        const user = await registerMerchant(email, password, businessName, phone, address);
+        const user = await registerMerchant(email, password, businessName, config, phone, address);
         // 2. 获取 token
-        const token = await getToken(email, password);
+        const token = await getToken(email, password, config);
         // 3. 设置 merchant profile（Commerce API）
-        const merchantProfile = await setupMerchantProfile(token, businessName);
+        const merchantProfile = await setupMerchantProfile(token, businessName, config);
         // 4. 保存 token 到临时文件
         const tmpDir = os.tmpdir();
         const tokenFileName = `optima-test-token-${Date.now()}.txt`;
@@ -198,6 +226,7 @@ Example:
         console.log('\n' + '='.repeat(80));
         console.log('✅ Test token generated successfully!\n');
         console.log('📋 Details:');
+        console.log(`  Environment:   ${config.envName}`);
         console.log(`  Email:         ${email}`);
         console.log(`  Password:      ${password}`);
         console.log(`  User ID:       ${user.user_id || 'N/A'}`);
@@ -210,9 +239,9 @@ Example:
         console.log(`  # Read token from file:`);
         console.log(`  TOKEN=$(cat ${tokenFilePath})\n`);
         console.log(`  # Use with commerce CLI:`);
-        console.log(`  OPTIMA_TOKEN=$(cat ${tokenFilePath}) OPTIMA_ENV=development commerce product list\n`);
+        console.log(`  OPTIMA_TOKEN=$(cat ${tokenFilePath}) OPTIMA_ENV=${config.envName} commerce product list\n`);
         console.log(`  # Use in curl:`);
-        console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" https://api.optima.chat/api/products\n`);
+        console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" ${config.apiUrl}/api/products\n`);
         console.log('='.repeat(80));
     }
     catch (error) {

package/package.json

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