@optima-chat/dev-skills 0.5.3 → 0.6.0

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

@@ -0,0 +1,172 @@
+# /generate-test-token - 生成测试 Access Token
+
+快速生成一个可用的测试 Access Token，包含完整的账户注册、token 获取和 merchant 设置。
+
+**版本**: v0.5.4
+
+## 使用场景
+
+**API 测试**: 快速获取可用的 access token 进行 API 调用测试
+**开发调试**: 生成测试账户用于功能开发和调试
+**集成测试**: 在 CI/CD 中自动生成测试账户
+
+## 🎯 使用方式：CLI 工具
+
+使用 `optima-generate-test-token` CLI 工具，它会自动完成所有设置：
+
+```bash
+# Development 环境（默认）
+optima-generate-test-token
+
+# Production 环境
+optima-generate-test-token --env production
+
+# 自定义商户名称
+optima-generate-test-token --business-name "我的测试店铺" --env production
+
+# 完全自定义
+optima-generate-test-token \
+  --email "custom@example.com" \
+  --password "MyPass123" \
+  --business-name "Custom Shop" \
+  --phone "+1234567890" \
+  --env production
+```
+
+## 工作流程
+
+该工具会自动完成以下步骤：
+
+1. **注册商家账户** - 在 Auth API 注册 merchant 角色用户
+2. **获取 Access Token** - 通过 OAuth 2.0 password grant 获取 token
+3. **设置 Merchant Profile** - 在 Commerce API 创建 merchant 资料
+4. **保存 Token 到文件** - 将 token 保存到临时文件，避免复制粘贴错误
+
+## 输出内容
+
+工具执行成功后会输出：
+
+- 账户邮箱和密码
+- User ID 和 Merchant ID
+- **Token 文件路径**（token 已保存到该文件）
+- 使用示例（包括 commerce CLI 和 curl）
+
+## 使用生成的 Token
+
+### 方式 1: 使用 commerce CLI（推荐）
+
+```bash
+# 读取 token 并使用
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product list
+
+# 创建商品
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product create \
+  --title "测试商品" \
+  --price 99.99 \
+  --stock 100
+```
+
+### 方式 2: 使用 curl
+
+```bash
+# 查询商品
+curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-xxx.txt)" \
+  https://api.optima.chat/api/products
+
+# 查询用户信息
+curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-xxx.txt)" \
+  https://auth.optima.chat/api/v1/users/me
+```
+
+## 命令参数
+
+- `--email <email>` - 用户邮箱（默认：自动生成）
+- `--password <password>` - 用户密码（默认：TestPassword123!）
+- `--business-name <name>` - 商户名称（默认：自动生成）
+- `--phone <phone>` - 联系电话（可选）
+- `--address <address>` - 地址（可选）
+- `--env <environment>` - 环境：development（默认）或 production
+- `--help, -h` - 显示帮助信息
+
+## 示例
+
+### 示例 1：快速生成
+
+```bash
+optima-generate-test-token
+```
+
+输出：
+```
+✅ Test token generated successfully!
+
+📋 Details:
+  Email:         test_1763996983959_wnjt4y@example.com
+  Password:      TestPassword123!
+  User ID:       14bb1340-0ffc-41c8-aac6-c8b7a6bbb1a0
+  Role:          merchant
+  Business Name: Test Merchant 1763996983959
+  Merchant ID:   14bb1340-0ffc-41c8-aac6-c8b7a6bbb1a0
+
+📁 Token File Path:
+  /tmp/optima-test-token-1763997011780.txt
+```
+
+### 示例 2：自定义商户信息
+
+```bash
+optima-generate-test-token \
+  --business-name "Claude 测试商店" \
+  --phone "+8613800138000"
+```
+
+### 示例 3：使用 token 创建商品
+
+```bash
+# 生成 token
+optima-generate-test-token
+
+# 使用 token（复制上面输出的文件路径）
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product create \
+  --title "陶瓷杯" \
+  --price 89 \
+  --stock 20
+```
+
+## ⚠️ 注意事项
+
+1. **支持两个环境** - Development（默认）和 Production，通过 `--env` 参数指定
+2. **Token 有效期** - Token 默认有效期 15 分钟，请及时使用
+3. **临时文件** - Token 保存在系统临时目录，重启后可能被清理
+4. **环境变量** - 使用 commerce CLI 时需要设置对应的 `OPTIMA_ENV`（development 或 production）
+
+## 🔗 相关资源
+
+- Commerce CLI: https://github.com/Optima-Chat/commerce-cli
+- Auth API Docs: https://auth.optima.chat/docs
+- Commerce API Docs: https://api.optima.chat/docs
+
+## 技术细节
+
+**API 调用流程**：
+1. `POST /api/v1/auth/register/merchant` - 注册商家用户
+2. `POST /api/v1/oauth/token` - 获取 access token（password grant）
+3. `POST /api/merchants/me` - 设置 merchant profile
+
+**环境配置**：
+
+| 环境 | 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 信息**：
+- 发货地址：中国深圳南山区科技园
+- 联系电话：+8613800138000
+- 联系邮箱：test@example.com

package/.claude/settings.local.json

@@ -22,13 +22,14 @@
       "Bash(aws logs get-log-events:*)",
       "Bash(npm install:*)",
       "Bash(optima-dev-skills:*)",
+      "Bash(optima-generate-test-token:*)",
+      "Bash(optima-query-db:*)",
       "Bash(gh variable set:*)",
       "Bash(npm publish:*)",
-      "Bash(curl -s \"https://secrets.optima.onl/api/v3/secrets/raw?workspaceId=f2415dc2-f79d-4e41-90bb-cd3d2631ec71&environment=staging&secretPath=/infrastructure\" -H \"Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudGl0eUlkIjoiMjZiNmYxMmItZjNjYy00OTE2LTliMTItNWFiYzZhMTlmNGI0IiwiY2xpZW50U2VjcmV0SWQiOiIxZjRhM2I0Ni03NTZmLTQwNmItOGQ1OS0yODI0YjUzOGFlMmMiLCJpZGVudGl0eUFjY2Vzc1Rva2VuSWQiOiJlMDQ1Y2MyOC02Nzk5LTRhODYtYWEwNy02YTQ4NmZkYzczODgiLCJhdXRoVG9rZW5UeXBlIjoiaWRlbnRpdHlBY2Nlc3NUb2tlbiIsImlhdCI6MTc2MzkxMzAxNywiZXhwIjoxNzY2NTA1MDE3fQ.xkPyv9MwXKLg3t-h1C_6mHSV5-cFuuvHnrkOoaGtuaQ\")",
       "Bash(python3:*)",
-      "Bash(curl -s \"https://secrets.optima.onl/api/v1/folders?workspaceId=f2415dc2-f79d-4e41-90bb-cd3d2631ec71&environment=prod\" -H \"Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudGl0eUlkIjoiMjZiNmYxMmItZjNjYy00OTE2LTliMTItNWFiYzZhMTlmNGI0IiwiY2xpZW50U2VjcmV0SWQiOiIxZjRhM2I0Ni03NTZmLTQwNmItOGQ1OS0yODI0YjUzOGFlMmMiLCJpZGVudGl0eUFjY2Vzc1Rva2VuSWQiOiJlMDQ1Y2MyOC02Nzk5LTRhODYtYWEwNy02YTQ4NmZkYzczODgiLCJhdXRoVG9rZW5UeXBlIjoiaWRlbnRpdHlBY2Nlc3NUb2tlbiIsImlhdCI6MTc2MzkxMzAxNywiZXhwIjoxNzY2NTA1MDE3fQ.xkPyv9MwXKLg3t-h1C_6mHSV5-cFuuvHnrkOoaGtuaQ\")",
-      "Bash(curl -s \"https://secrets.optima.onl/api/v3/secrets/raw?workspaceId=f2415dc2-f79d-4e41-90bb-cd3d2631ec71&environment=prod&secretPath=/infrastructure\" -H \"Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudGl0eUlkIjoiMjZiNmYxMmItZjNjYy00OTE2LTliMTItNWFiYzZhMTlmNGI0IiwiY2xpZW50U2VjcmV0SWQiOiIxZjRhM2I0Ni03NTZmLTQwNmItOGQ1OS0yODI0YjUzOGFlMmMiLCJpZGVudGl0eUFjY2Vzc1Rva2VuSWQiOiJlMDQ1Y2MyOC02Nzk5LTRhODYtYWEwNy02YTQ4NmZkYzczODgiLCJhdXRoVG9rZW5UeXBlIjoiaWRlbnRpdHlBY2Nlc3NUb2tlbiIsImlhdCI6MTc2MzkxMzAxNywiZXhwIjoxNzY2NTA1MDE3fQ.xkPyv9MwXKLg3t-h1C_6mHSV5-cFuuvHnrkOoaGtuaQ\")",
-      "Bash(gh api:*)"
+      "Bash(gh api:*)",
+      "Bash(curl -s http://auth.optima.chat/openapi.json)",
+      "Bash(curl -s https://auth.optima.chat/openapi.json)"
     ],
     "deny": [],
     "ask": []

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

@@ -0,0 +1,316 @@
+---
+name: "generate-test-token"
+description: "当用户请求生成测试 token、创建测试账户、获取 access token、需要测试 API、API 测试、测试账户时，使用此技能。自动完成账户注册、token 获取和 merchant 设置。"
+allowed-tools: ["Bash", "SlashCommand"]
+---
+
+# 生成测试 Access Token
+
+当你需要为 API 测试生成一个可用的 access token 时，使用这个场景。
+
+## 🎯 执行方式：使用 CLI 工具
+
+**重要**：无论用户使用 `/generate-test-token` 命令还是直接请求生成测试 token，都应该使用 `optima-generate-test-token` CLI 工具：
+
+```bash
+optima-generate-test-token [options]
+```
+
+**为什么使用 CLI 工具**：
+- ✅ 自动注册商家账户（Auth API）
+- ✅ 自动获取 OAuth access token
+- ✅ 自动设置 merchant profile（Commerce API）
+- ✅ Token 保存到文件，避免复制错误
+- ✅ 一条命令完成所有设置
+
+## 🎯 适用情况
+
+- 需要测试 Commerce API 或 Auth API
+- 开发新功能需要测试账户
+- 调试 API 调用问题
+- CI/CD 集成测试
+- 演示功能需要临时账户
+
+## 🚀 快速操作
+
+### 基本使用
+
+```bash
+# Development 环境（默认）
+optima-generate-test-token
+
+# Production 环境
+optima-generate-test-token --env production
+
+# 自定义商户名称
+optima-generate-test-token --business-name "我的测试店铺" --env production
+
+# 完全自定义
+optima-generate-test-token \
+  --email "test@example.com" \
+  --password "MyPassword123" \
+  --business-name "测试商店" \
+  --env production
+```
+
+### 使用生成的 Token
+
+工具执行后会输出 token 文件路径，例如：`/tmp/optima-test-token-1763997011780.txt`
+
+**方式 1: 使用 commerce CLI**
+
+```bash
+# 查询商品列表
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product list
+
+# 创建商品
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product create \
+  --title "测试商品" \
+  --description "这是一个测试商品" \
+  --price 99.99 \
+  --stock 100 \
+  --currency USD \
+  --status active
+```
+
+**方式 2: 使用 curl**
+
+```bash
+# 查询用户信息
+curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-xxx.txt)" \
+  https://auth.optima.chat/api/v1/users/me
+
+# 查询商品
+curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-xxx.txt)" \
+  https://api.optima.chat/api/products
+```
+
+## 📋 常见使用场景
+
+### 场景 1：快速 API 测试
+
+**用户请求**："我需要测试一下商品创建 API"
+
+**步骤**：
+1. 生成 token：`optima-generate-test-token`
+2. 记录输出的 token 文件路径
+3. 使用 token 创建商品：
+   ```bash
+   OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+   OPTIMA_ENV=development \
+   commerce product create --title "测试商品" --price 99.99 --stock 100
+   ```
+
+### 场景 2：调试 API 调用
+
+**用户请求**："帮我生成一个测试账户，我要调试订单 API"
+
+**步骤**：
+1. 生成测试账户和 token：`optima-generate-test-token --business-name "订单测试店铺"`
+2. 保存输出的账户信息（email, password, merchant_id）
+3. 使用 token 查询订单：
+   ```bash
+   OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+   OPTIMA_ENV=development \
+   commerce order list
+   ```
+
+### 场景 3：演示功能
+
+**用户请求**："创建一个演示账户，我要展示商品管理功能"
+
+**步骤**：
+1. 生成演示账户：`optima-generate-test-token --business-name "演示商店"`
+2. 使用 token 创建演示数据：
+   ```bash
+   TOKEN_FILE=/tmp/optima-test-token-xxx.txt
+
+   # 创建多个商品
+   OPTIMA_TOKEN=$(cat $TOKEN_FILE) OPTIMA_ENV=development \
+   commerce product create --title "商品A" --price 49.99 --stock 50
+
+   OPTIMA_TOKEN=$(cat $TOKEN_FILE) OPTIMA_ENV=development \
+   commerce product create --title "商品B" --price 89.99 --stock 30
+   ```
+
+### 场景 4：CI/CD 集成测试
+
+**用户请求**："在 CI 环境中自动生成测试账户"
+
+**步骤**：
+1. 在 CI 脚本中调用：
+   ```bash
+   # 生成 token 并保存路径
+   TOKEN_OUTPUT=$(optima-generate-test-token 2>&1)
+   TOKEN_FILE=$(echo "$TOKEN_OUTPUT" | grep "Token File Path" -A 1 | tail -1 | xargs)
+
+   # 在环境变量中设置
+   export OPTIMA_TOKEN=$(cat $TOKEN_FILE)
+   export OPTIMA_ENV=development
+
+   # 运行测试
+   npm run test:api
+   ```
+
+## 📋 工具输出说明
+
+成功执行后会输出：
+
+```
+✅ Test token generated successfully!
+
+📋 Details:
+  Email:         test_1763996983959_wnjt4y@example.com
+  Password:      TestPassword123!
+  User ID:       14bb1340-0ffc-41c8-aac6-c8b7a6bbb1a0
+  Role:          merchant
+  Business Name: Test Merchant 1763996983959
+  Merchant ID:   14bb1340-0ffc-41c8-aac6-c8b7a6bbb1a0
+
+📁 Token File Path:
+  /tmp/optima-test-token-1763997011780.txt
+
+💡 Usage Examples:
+  # Read token from file:
+  TOKEN=$(cat /tmp/optima-test-token-1763997011780.txt)
+
+  # Use with commerce CLI:
+  OPTIMA_TOKEN=$(cat /tmp/optima-test-token-1763997011780.txt) OPTIMA_ENV=development commerce product list
+
+  # Use in curl:
+  curl -H "Authorization: Bearer $(cat /tmp/optima-test-token-1763997011780.txt)" https://api.optima.chat/api/products
+```
+
+**关键信息**：
+- **Email/Password**: 账户登录凭证，可用于后续登录
+- **Merchant ID**: 商户 ID，部分 API 可能需要
+- **Token File Path**: Token 文件路径，这是最重要的信息！
+
+## ⚠️ 注意事项
+
+### 环境设置
+
+使用 commerce CLI 时**必须**设置环境变量：
+```bash
+OPTIMA_ENV=development  # 必需，指定 development 环境
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt)  # 必需，读取 token
+```
+
+### Token 有效期
+
+- Token 默认有效期为 **15 分钟**
+- 如果 token 过期，重新运行 `optima-generate-test-token` 即可
+- 错误信息："Invalid or expired token"
+
+### 文件管理
+
+- Token 保存在系统临时目录（`/tmp/` 或 `/var/folders/...`）
+- 系统重启后可能被清理
+- 建议在使用完成后手动删除敏感文件
+
+### 只能用于开发环境
+
+- 生成的账户注册到 **development 环境**
+- API 地址：
+  - Auth: `https://auth.optima.chat`
+  - Commerce: `https://api.optima.chat`
+- **不能用于** production 或 stage 环境
+
+## 💡 最佳实践
+
+### 1. Token 文件路径管理
+
+```bash
+# 方法 1：直接从输出复制路径
+optima-generate-test-token
+# 复制输出中的 "Token File Path"
+
+# 方法 2：保存到变量
+TOKEN_FILE=$(optima-generate-test-token 2>&1 | grep "Token File Path" -A 1 | tail -1 | xargs)
+OPTIMA_TOKEN=$(cat "$TOKEN_FILE")
+```
+
+### 2. 重复使用同一个 token
+
+```bash
+# 将 token 路径保存到环境变量
+export TOKEN_FILE=/tmp/optima-test-token-1763997011780.txt
+
+# 后续使用
+OPTIMA_TOKEN=$(cat $TOKEN_FILE) OPTIMA_ENV=development commerce product list
+OPTIMA_TOKEN=$(cat $TOKEN_FILE) OPTIMA_ENV=development commerce order list
+```
+
+### 3. 自定义账户信息（可选）
+
+只有在需要特定账户信息时才自定义：
+
+```bash
+# 自定义商户名称
+optima-generate-test-token --business-name "我的专属测试店铺"
+
+# 完全自定义（适合重复测试）
+optima-generate-test-token \
+  --email "mytest@example.com" \
+  --password "MyStrongPassword123!" \
+  --business-name "固定测试店铺"
+```
+
+### 4. 清理测试数据
+
+```bash
+# 测试完成后删除 token 文件
+rm /tmp/optima-test-token-*.txt
+```
+
+## 🔧 故障排查
+
+### 问题 1：Token 无效
+
+**错误信息**: "Invalid or expired token"
+
+**解决方案**:
+- Token 已过期（15分钟），重新生成
+- 环境变量设置错误，检查 `OPTIMA_ENV=development`
+- Token 文件路径错误，检查文件是否存在
+
+### 问题 2：Merchant profile 未设置
+
+**错误信息**: "Merchant profile setup required"
+
+**解决方案**:
+- 这不应该发生，工具会自动设置
+- 检查工具输出是否显示 "✓ Merchant profile setup complete"
+- 如果没有，可能是网络问题，重新运行
+
+### 问题 3：命令不存在
+
+**错误信息**: "command not found: optima-generate-test-token"
+
+**解决方案**:
+```bash
+# 安装或更新工具
+npm install -g @optima-chat/dev-skills@latest
+
+# 或本地使用
+npx @optima-chat/dev-skills generate-test-token
+```
+
+## 🔗 相关命令
+
+- `optima-generate-test-token` - CLI 生成工具（主要方式）
+- `/generate-test-token` - Slash 命令（备用方式，详细使用方法请查看 `/generate-test-token --help`）
+- `commerce auth login` - Commerce CLI 登录
+- `commerce product create` - 创建商品
+- `commerce order list` - 查询订单
+
+## 📚 更多资源
+
+- **Commerce CLI**: https://github.com/Optima-Chat/commerce-cli
+- **Auth API Docs**: https://auth.optima.chat/docs
+- **Commerce API Docs**: https://api.optima.chat/docs
+- **OAuth 2.0 文档**: https://auth.optima.chat/docs#/OAuth%202.0

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

@@ -0,0 +1,64 @@
+---
+name: "use-commerce-cli"
+description: "当用户需要管理电商店铺（商品、订单、库存、运费、集合、首页、国际化）时，使用此技能。"
+allowed-tools: ["Bash"]
+---
+
+# 使用 Commerce CLI
+
+## 何时使用
+
+用户需要管理电商功能：商品、订单、库存、运费、集合、首页、国际化。
+
+## 前提
+
+用户已有 access token（通过 `optima-generate-test-token` 生成）。
+
+## Token 传递方式
+
+**必须**同时设置 `OPTIMA_TOKEN` 和 `OPTIMA_ENV`：
+
+```bash
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce <command>
+```
+
+## 示例
+
+```bash
+# 创建商品
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product create --title "测试商品" --price 99.99 --stock 100
+
+# 查询商品
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce product list
+
+# 查询订单
+OPTIMA_TOKEN=$(cat /tmp/optima-test-token-xxx.txt) \
+OPTIMA_ENV=development \
+commerce order list
+```
+
+## 安装项目 Skills（可选）
+
+```bash
+commerce init
+```
+
+在 `.claude/skills/` 安装完整 Skills，之后可用自然语言管理店铺。
+
+## 环境说明
+
+`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,12 +23,14 @@ Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个
 - **任务驱动** - 基于具体任务场景（查看日志、调用 API），不是抽象分类
 - **跨环境协作** - 统一的命令在 CI、Stage、Prod 三个环境中使用
 
-## 📋 任务场景（2 个）
+## 📋 任务场景（4 个）
 
 当 Claude Code 识别到以下任务时，会自动加载对应的 Skill：
 
 - **logs** - 查看 CI/Stage/Prod 的服务器日志
 - **query-db** - 查询 CI/Stage/Prod 的数据库
+- **generate-test-token** - 生成测试 Access Token 用于 API 测试
+- **use-commerce-cli** - 使用 Commerce CLI 管理电商店铺
 
 ## 👤 用户故事
 
@@ -72,10 +74,12 @@ Claude:
 |------|------|------|--------|
 | `/logs` | 查看服务日志 | `/logs commerce-backend 100` | ✅ |
 | `/query-db` | 查询数据库 | `/query-db user-auth "SELECT COUNT(*) FROM users"` | ✅ |
+| `/generate-test-token` | 生成测试 token | `/generate-test-token` | 🔧 Development |
 
 **说明**：
 - 命令支持 CI、Stage、Prod 三个环境
 - 默认使用 CI 环境，适合日常开发
+- `/generate-test-token` 生成的账户用于 development 环境（api.optima.chat）
 - Claude Code 会根据上下文自动选择环境和执行方式
 
 ## 🛠️ CLI 工具
@@ -85,12 +89,14 @@ Claude:
 | 工具 | 说明 | 示例 |
 |------|------|------|
 | `optima-query-db` | 数据库查询工具 | `optima-query-db user-auth "SELECT COUNT(*) FROM users" prod` |
+| `optima-generate-test-token` | 生成测试 token | `optima-generate-test-token --business-name "测试店铺"` |
 
 **特点**：
-- ✅ 支持 CI、Stage、Prod 三个环境
+- ✅ 支持 CI、Stage、Prod 三个环境（query-db）
 - ✅ 自动管理 SSH 隧道和密钥
 - ✅ 可在任何终端直接使用
-- ✅ Claude Code 的 `/query-db` 命令内部也使用此工具
+- ✅ 自动注册账户、获取 token、设置 merchant profile（generate-test-token）
+- ✅ Claude Code 的命令内部也使用这些工具
 
 ## 🏗️ 项目结构
 
@@ -98,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
@@ -127,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
@@ -197,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

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+interface RegisterResponse {
+  email: string;
+  user_id: string;
+  role: string;
+  is_active: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+interface TokenResponse {
+  access_token: string;
+  token_type: string;
+}
+
+interface MerchantSetupResponse {
+  merchant_id: string;
+  business_name: string;
+  user_id: string;
+}
+
+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, {
+    ...options,
+    headers: {
+      'Content-Type': 'application/json',
+      ...options.headers
+    }
+  });
+
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`HTTP ${response.status}: ${text}`);
+  }
+
+  return response.json() as Promise<T>;
+}
+
+async function registerMerchant(
+  email: string,
+  password: string,
+  businessName: string,
+  config: EnvironmentConfig,
+  phone?: string,
+  address?: string
+): Promise<RegisterResponse> {
+  console.log(`\n📝 Registering merchant: ${email}...`);
+
+  const payload: any = { email, password, business_name: businessName };
+  if (phone) payload.phone = phone;
+  if (address) payload.address = address;
+
+  try {
+    const result = await httpRequest<RegisterResponse>(`${config.authUrl}/api/v1/auth/register/merchant`, {
+      method: 'POST',
+      body: JSON.stringify(payload)
+    });
+
+    console.log(`✓ Merchant registered successfully (ID: ${result.user_id})`);
+    return result;
+  } catch (error: any) {
+    if (error.message.includes('409') || error.message.includes('already exists')) {
+      console.log(`ℹ Merchant already exists, proceeding to login...`);
+      return { email, user_id: '', role: 'merchant', is_active: true, created_at: '', updated_at: '' };
+    }
+    throw error;
+  }
+}
+
+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', config.clientId);
+
+  const result = await httpRequest<TokenResponse>(`${config.authUrl}/api/v1/oauth/token`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded'
+    },
+    body: formData.toString()
+  });
+
+  console.log(`✓ Access token obtained`);
+  return result.access_token;
+}
+
+async function setupMerchantProfile(token: string, businessName: string, config: EnvironmentConfig): Promise<MerchantSetupResponse> {
+  console.log(`\n🏪 Setting up merchant profile in Commerce API...`);
+
+  const payload = {
+    name: businessName,
+    origin_country_alpha2: 'CN',
+    origin_city: '深圳',
+    origin_state: '广东省',
+    origin_line_1: '南山区科技园',
+    contact_name: '测试用户',
+    contact_phone: '+8613800138000',
+    contact_email: 'test@example.com'
+  };
+
+  try {
+    const result = await httpRequest<MerchantSetupResponse>(`${config.apiUrl}/api/merchants/me`, {
+      method: 'POST',
+      headers: {
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify(payload)
+    });
+
+    console.log(`✓ Merchant profile setup complete (ID: ${result.merchant_id})`);
+    return result;
+  } catch (error: any) {
+    if (error.message.includes('409') || error.message.includes('already exists')) {
+      console.log(`ℹ Merchant profile already exists`);
+      return { merchant_id: '', business_name: businessName, user_id: '' };
+    }
+    throw error;
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  // 生成随机测试账户
+  const timestamp = Date.now();
+  const randomStr = Math.random().toString(36).substring(2, 8);
+  const defaultEmail = `test_${timestamp}_${randomStr}@example.com`;
+  const defaultPassword = 'TestPassword123!';
+  const defaultBusinessName = `Test Merchant ${timestamp}`;
+
+  let email = defaultEmail;
+  let password = defaultPassword;
+  let businessName = defaultBusinessName;
+  let phone: string | undefined;
+  let address: string | undefined;
+  let environment: Environment = 'development';
+
+  // 解析命令行参数
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--email' && args[i + 1]) {
+      email = args[++i];
+    } else if (arg === '--password' && args[i + 1]) {
+      password = args[++i];
+    } else if (arg === '--business-name' && args[i + 1]) {
+      businessName = args[++i];
+    } else if (arg === '--phone' && args[i + 1]) {
+      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]
+
+Options:
+  --email <email>              User email (default: auto-generated)
+  --password <password>        User password (default: TestPassword123!)
+  --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" --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, config, phone, address);
+
+    // 2. 获取 token
+    const token = await getToken(email, password, config);
+
+    // 3. 设置 merchant profile（Commerce API）
+    const merchantProfile = await setupMerchantProfile(token, businessName, config);
+
+    // 4. 保存 token 到临时文件
+    const tmpDir = os.tmpdir();
+    const tokenFileName = `optima-test-token-${Date.now()}.txt`;
+    const tokenFilePath = path.join(tmpDir, tokenFileName);
+
+    fs.writeFileSync(tokenFilePath, token, 'utf-8');
+    console.log(`\n💾 Token saved to temporary file`);
+
+    // 输出结果
+    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'}`);
+    console.log(`  Role:          ${user.role}`);
+    console.log(`  Business Name: ${businessName}`);
+    console.log(`  Merchant ID:   ${merchantProfile.merchant_id || 'N/A'}\n`);
+    console.log('📁 Token File Path:');
+    console.log(`  ${tokenFilePath}\n`);
+    console.log('💡 Usage Examples:');
+    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=${config.envName} commerce product list\n`);
+    console.log(`  # Use in curl:`);
+    console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" ${config.apiUrl}/api/products\n`);
+    console.log('='.repeat(80));
+
+  } catch (error: any) {
+    console.error('\n❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

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

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+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,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`HTTP ${response.status}: ${text}`);
+    }
+    return response.json();
+}
+async function registerMerchant(email, password, businessName, config, phone, address) {
+    console.log(`\n📝 Registering merchant: ${email}...`);
+    const payload = { email, password, business_name: businessName };
+    if (phone)
+        payload.phone = phone;
+    if (address)
+        payload.address = address;
+    try {
+        const result = await httpRequest(`${config.authUrl}/api/v1/auth/register/merchant`, {
+            method: 'POST',
+            body: JSON.stringify(payload)
+        });
+        console.log(`✓ Merchant registered successfully (ID: ${result.user_id})`);
+        return result;
+    }
+    catch (error) {
+        if (error.message.includes('409') || error.message.includes('already exists')) {
+            console.log(`ℹ Merchant already exists, proceeding to login...`);
+            return { email, user_id: '', role: 'merchant', is_active: true, created_at: '', updated_at: '' };
+        }
+        throw error;
+    }
+}
+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', config.clientId);
+    const result = await httpRequest(`${config.authUrl}/api/v1/oauth/token`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded'
+        },
+        body: formData.toString()
+    });
+    console.log(`✓ Access token obtained`);
+    return result.access_token;
+}
+async function setupMerchantProfile(token, businessName, config) {
+    console.log(`\n🏪 Setting up merchant profile in Commerce API...`);
+    const payload = {
+        name: businessName,
+        origin_country_alpha2: 'CN',
+        origin_city: '深圳',
+        origin_state: '广东省',
+        origin_line_1: '南山区科技园',
+        contact_name: '测试用户',
+        contact_phone: '+8613800138000',
+        contact_email: 'test@example.com'
+    };
+    try {
+        const result = await httpRequest(`${config.apiUrl}/api/merchants/me`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`
+            },
+            body: JSON.stringify(payload)
+        });
+        console.log(`✓ Merchant profile setup complete (ID: ${result.merchant_id})`);
+        return result;
+    }
+    catch (error) {
+        if (error.message.includes('409') || error.message.includes('already exists')) {
+            console.log(`ℹ Merchant profile already exists`);
+            return { merchant_id: '', business_name: businessName, user_id: '' };
+        }
+        throw error;
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // 生成随机测试账户
+    const timestamp = Date.now();
+    const randomStr = Math.random().toString(36).substring(2, 8);
+    const defaultEmail = `test_${timestamp}_${randomStr}@example.com`;
+    const defaultPassword = 'TestPassword123!';
+    const defaultBusinessName = `Test Merchant ${timestamp}`;
+    let email = defaultEmail;
+    let password = defaultPassword;
+    let businessName = defaultBusinessName;
+    let phone;
+    let address;
+    let environment = 'development';
+    // 解析命令行参数
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--email' && args[i + 1]) {
+            email = args[++i];
+        }
+        else if (arg === '--password' && args[i + 1]) {
+            password = args[++i];
+        }
+        else if (arg === '--business-name' && args[i + 1]) {
+            businessName = args[++i];
+        }
+        else if (arg === '--phone' && args[i + 1]) {
+            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]
+
+Options:
+  --email <email>              User email (default: auto-generated)
+  --password <password>        User password (default: TestPassword123!)
+  --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" --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, config, phone, address);
+        // 2. 获取 token
+        const token = await getToken(email, password, config);
+        // 3. 设置 merchant profile（Commerce API）
+        const merchantProfile = await setupMerchantProfile(token, businessName, config);
+        // 4. 保存 token 到临时文件
+        const tmpDir = os.tmpdir();
+        const tokenFileName = `optima-test-token-${Date.now()}.txt`;
+        const tokenFilePath = path.join(tmpDir, tokenFileName);
+        fs.writeFileSync(tokenFilePath, token, 'utf-8');
+        console.log(`\n💾 Token saved to temporary file`);
+        // 输出结果
+        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'}`);
+        console.log(`  Role:          ${user.role}`);
+        console.log(`  Business Name: ${businessName}`);
+        console.log(`  Merchant ID:   ${merchantProfile.merchant_id || 'N/A'}\n`);
+        console.log('📁 Token File Path:');
+        console.log(`  ${tokenFilePath}\n`);
+        console.log('💡 Usage Examples:');
+        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=${config.envName} commerce product list\n`);
+        console.log(`  # Use in curl:`);
+        console.log(`  curl -H "Authorization: Bearer $(cat ${tokenFilePath})" ${config.apiUrl}/api/products\n`);
+        console.log('='.repeat(80));
+    }
+    catch (error) {
+        console.error('\n❌ Error:', error.message);
+        process.exit(1);
+    }
+}
+main();

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {
     "optima-dev-skills": "./bin/cli.js",
-    "optima-query-db": "./dist/bin/helpers/query-db.js"
+    "optima-query-db": "./dist/bin/helpers/query-db.js",
+    "optima-generate-test-token": "./dist/bin/helpers/generate-test-token.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",