@optima-chat/dev-skills 0.6.0 → 0.7.0

package/.claude/commands/read-code.md

@@ -0,0 +1,128 @@
+# /read-code - 阅读 Optima 代码库
+
+通过 GitHub CLI 查看 Optima-Chat 组织下任意仓库的代码。
+
+**版本**: v0.1.0
+
+## 使用场景
+
+**开发者**: 查看其他服务的实现细节，了解 API 调用方式
+**新成员**: 快速了解项目结构和代码组织
+**跨团队协作**: 查找特定功能的代码位置
+
+## 用法
+
+```
+/read-code <repo> [path]
+```
+
+## 参数
+
+- `repo` (必需): 仓库名称（不需要 Optima-Chat/ 前缀）
+  - `commerce-backend` - 电商后端
+  - `user-auth` - 用户认证
+  - `mcp-host` - MCP 协调器
+  - `agentic-chat` - AI 聊天
+  - `commerce-cli` - 电商 CLI
+  - `optima-store` - 店铺前端
+  - 等等...
+- `path` (可选): 文件或目录路径，默认为根目录
+
+## 示例
+
+```bash
+/read-code commerce-backend                    # 查看根目录结构
+/read-code commerce-backend app                # 查看 app 目录
+/read-code commerce-backend app/main.py        # 查看具体文件
+/read-code user-auth CLAUDE.md                 # 查看项目文档
+```
+
+## Claude Code 执行步骤
+
+### 1. 查看目录结构
+
+```bash
+# 查看根目录
+gh api repos/Optima-Chat/{repo}/contents | jq -r '.[] | "\(.type)\t\(.name)"'
+
+# 查看子目录
+gh api repos/Optima-Chat/{repo}/contents/{path} | jq -r '.[] | "\(.type)\t\(.name)"'
+```
+
+### 2. 查看文件内容
+
+```bash
+# 查看文件（自动解码 base64）
+gh api repos/Optima-Chat/{repo}/contents/{path} | jq -r '.content' | base64 -d
+```
+
+### 3. 搜索代码
+
+```bash
+# 在仓库中搜索
+gh search code "{keyword}" --repo Optima-Chat/{repo}
+
+# 跨仓库搜索
+gh search code "{keyword}" --owner Optima-Chat
+```
+
+### 4. 查看完整目录树
+
+```bash
+gh api repos/Optima-Chat/{repo}/git/trees/main?recursive=1 | jq -r '.tree[] | select(.type=="blob") | .path' | head -50
+```
+
+## 可用仓库列表
+
+### 核心服务
+- `commerce-backend` - 电商后端 API
+- `user-auth` - 用户认证服务
+- `mcp-host` - MCP 协调器
+- `agentic-chat` - AI 聊天应用
+
+### MCP 服务
+- `commerce-mcp` - 电商管理 MCP
+- `shopify-mcp` - Shopify API MCP
+- `google-ads-mcp` - Google Ads MCP
+- `comfy-mcp` - ComfyUI MCP
+- `perplexity-mcp` - Perplexity MCP
+- `fetch-mcp` - 网页抓取 MCP
+
+### 前端 & CLI
+- `optima-store` - 电商店铺前端
+- `commerce-cli` - 电商管理 CLI
+- `optima-ops-cli` - 运维 CLI
+
+### 其他
+- `optima-terraform` - AWS Terraform 配置
+- `optima-workspace` - 多仓库工作区管理
+- `optima-eval` - AI Agent 评测系统
+- `optima-bi` - 商业智能模块
+
+## 实用技巧
+
+### 查看大文件
+
+```bash
+# 获取 raw 内容（避免 base64 截断）
+curl -s "$(gh api repos/Optima-Chat/{repo}/contents/{path} | jq -r '.download_url')"
+```
+
+### 查看最近修改
+
+```bash
+# 最近 commit 修改的文件
+gh api repos/Optima-Chat/{repo}/commits/main | jq -r '.files[].filename'
+```
+
+### 查看特定分支
+
+```bash
+gh api repos/Optima-Chat/{repo}/contents/{path}?ref=develop | jq -r '.content' | base64 -d
+```
+
+## 注意事项
+
+1. 需要 GitHub CLI 已登录且有仓库访问权限
+2. 大部分仓库是私有的
+3. 超过 1MB 的文件需要使用 raw URL

package/.claude/settings.local.json

@@ -29,7 +29,9 @@
       "Bash(python3:*)",
       "Bash(gh api:*)",
       "Bash(curl -s http://auth.optima.chat/openapi.json)",
-      "Bash(curl -s https://auth.optima.chat/openapi.json)"
+      "Bash(curl -s https://auth.optima.chat/openapi.json)",
+      "Bash(cat:*)",
+      "Bash(node /Users/verypro/optima-dev-skills/scripts/install.js:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/read-code/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: "read-code"
+description: "当用户请求阅读代码、查看源码、看看代码、代码在哪、找代码、查看实现、看看怎么实现的、代码结构、项目结构时，使用此技能。支持查看 Optima-Chat 组织下所有仓库的代码。"
+allowed-tools: ["Bash"]
+---
+
+# 阅读 Optima 代码库
+
+当你需要查看 Optima-Chat 组织下任何仓库的代码时，使用这个技能。
+
+## 🎯 适用情况
+
+- 查看某个服务的实现细节
+- 了解项目结构
+- 查找特定功能的代码
+- 学习代码实现方式
+- 跨仓库代码对比
+
+## 🏢 可用仓库
+
+### 核心服务
+
+| 仓库 | 说明 |
+|------|------|
+| `commerce-backend` | 电商后端 API |
+| `user-auth` | 用户认证服务 |
+| `mcp-host` | MCP 协调器服务 |
+| `agentic-chat` | AI 聊天应用 |
+
+### MCP 服务
+
+| 仓库 | 说明 |
+|------|------|
+| `commerce-mcp` | 电商管理 MCP |
+| `shopify-mcp` | Shopify API MCP |
+| `google-ads-mcp` | Google Ads MCP |
+| `comfy-mcp` | ComfyUI MCP |
+| `perplexity-mcp` | Perplexity MCP |
+| `fetch-mcp` | 网页抓取 MCP |
+
+### 前端 & CLI
+
+| 仓库 | 说明 |
+|------|------|
+| `optima-store` | 电商店铺前端 |
+| `commerce-cli` | 电商管理 CLI |
+| `optima-ops-cli` | 运维 CLI |
+
+### 其他
+
+| 仓库 | 说明 |
+|------|------|
+| `optima-terraform` | AWS Terraform 配置 |
+| `optima-workspace` | 多仓库工作区管理 |
+| `optima-eval` | AI Agent 评测系统 |
+| `optima-bi` | 商业智能模块 |
+| `optima-scout` | 智能选品助手 |
+
+## 🚀 快速操作
+
+### 1. 查看仓库结构
+
+```bash
+# 查看仓库文件列表
+gh repo view Optima-Chat/commerce-backend --json name,description
+
+# 查看根目录结构
+gh api repos/Optima-Chat/commerce-backend/contents | jq -r '.[].name'
+
+# 查看特定目录
+gh api repos/Optima-Chat/commerce-backend/contents/app | jq -r '.[].name'
+```
+
+### 2. 查看文件内容
+
+```bash
+# 查看单个文件（自动解码 base64）
+gh api repos/Optima-Chat/commerce-backend/contents/README.md | jq -r '.content' | base64 -d
+
+# 查看 Python 文件
+gh api repos/Optima-Chat/commerce-backend/contents/app/main.py | jq -r '.content' | base64 -d
+
+# 查看 CLAUDE.md（如果存在）
+gh api repos/Optima-Chat/commerce-backend/contents/CLAUDE.md | jq -r '.content' | base64 -d
+```
+
+### 3. 搜索代码
+
+```bash
+# 在仓库中搜索代码
+gh search code "def create_product" --repo Optima-Chat/commerce-backend
+
+# 搜索特定文件类型
+gh search code "class Product" --repo Optima-Chat/commerce-backend --filename "*.py"
+
+# 跨仓库搜索
+gh search code "MerchantProfile" --owner Optima-Chat
+```
+
+### 4. 查看特定分支或 commit
+
+```bash
+# 查看特定分支的文件
+gh api repos/Optima-Chat/commerce-backend/contents/app/main.py?ref=develop | jq -r '.content' | base64 -d
+
+# 查看最近的 commits
+gh api repos/Optima-Chat/commerce-backend/commits --jq '.[0:5] | .[] | "\(.sha[0:7]) \(.commit.message | split("\n")[0])"'
+```
+
+## 📋 常见使用场景
+
+### 场景 1：了解服务架构
+
+**用户请求**："帮我看看 commerce-backend 的项目结构"
+
+**步骤**：
+```bash
+# 1. 查看根目录
+gh api repos/Optima-Chat/commerce-backend/contents | jq -r '.[] | "\(.type)\t\(.name)"'
+
+# 2. 查看 app 目录结构
+gh api repos/Optima-Chat/commerce-backend/contents/app | jq -r '.[] | "\(.type)\t\(.name)"'
+
+# 3. 查看 CLAUDE.md 了解架构
+gh api repos/Optima-Chat/commerce-backend/contents/CLAUDE.md | jq -r '.content' | base64 -d
+```
+
+### 场景 2：查找功能实现
+
+**用户请求**："商品创建的代码在哪？"
+
+**步骤**：
+```bash
+# 1. 搜索相关代码
+gh search code "create_product" --repo Optima-Chat/commerce-backend
+
+# 2. 查看搜索到的文件
+gh api repos/Optima-Chat/commerce-backend/contents/app/services/product_service.py | jq -r '.content' | base64 -d
+```
+
+### 场景 3：跨仓库对比
+
+**用户请求**："commerce-mcp 和 commerce-cli 有什么区别？"
+
+**步骤**：
+```bash
+# 1. 查看两个仓库的 README
+gh api repos/Optima-Chat/commerce-mcp/contents/README.md | jq -r '.content' | base64 -d
+gh api repos/Optima-Chat/commerce-cli/contents/README.md | jq -r '.content' | base64 -d
+
+# 2. 对比项目结构
+gh api repos/Optima-Chat/commerce-mcp/contents | jq -r '.[].name'
+gh api repos/Optima-Chat/commerce-cli/contents | jq -r '.[].name'
+```
+
+### 场景 4：查看 API 定义
+
+**用户请求**："user-auth 有哪些 API？"
+
+**步骤**：
+```bash
+# 1. 查看路由文件
+gh api repos/Optima-Chat/user-auth/contents/app/api | jq -r '.[].name'
+
+# 2. 查看具体路由
+gh api repos/Optima-Chat/user-auth/contents/app/api/routes/auth.py | jq -r '.content' | base64 -d
+```
+
+## 💡 实用技巧
+
+### 查看大文件
+
+对于大文件，GitHub API 可能返回 truncated 内容，使用 raw URL：
+
+```bash
+# 获取 raw 内容 URL
+gh api repos/Optima-Chat/commerce-backend/contents/app/main.py | jq -r '.download_url'
+
+# 直接获取 raw 内容
+curl -s "$(gh api repos/Optima-Chat/commerce-backend/contents/app/main.py | jq -r '.download_url')"
+```
+
+### 递归查看目录
+
+```bash
+# 获取整个目录树
+gh api repos/Optima-Chat/commerce-backend/git/trees/main?recursive=1 | jq -r '.tree[] | select(.type=="blob") | .path' | head -50
+```
+
+### 查看最近修改的文件
+
+```bash
+# 查看最近的 commit 修改了哪些文件
+gh api repos/Optima-Chat/commerce-backend/commits/main | jq -r '.files[].filename'
+```
+
+## ⚠️ 注意事项
+
+1. **权限**：需要 GitHub CLI 已登录且有仓库访问权限
+2. **私有仓库**：大部分 Optima-Chat 仓库是私有的，确保有访问权限
+3. **API 限制**：GitHub API 有速率限制，避免频繁请求
+4. **大文件**：超过 1MB 的文件需要使用 raw URL 获取
+
+## 🔗 相关资源
+
+- GitHub CLI 文档：https://cli.github.com/manual/
+- GitHub REST API：https://docs.github.com/en/rest

package/README.md

@@ -23,7 +23,7 @@ Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个
 - **任务驱动** - 基于具体任务场景（查看日志、调用 API），不是抽象分类
 - **跨环境协作** - 统一的命令在 CI、Stage、Prod 三个环境中使用
 
-## 📋 任务场景（4 个）
+## 📋 任务场景（5 个）
 
 当 Claude Code 识别到以下任务时，会自动加载对应的 Skill：
 
@@ -31,6 +31,7 @@ Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个
 - **query-db** - 查询 CI/Stage/Prod 的数据库
 - **generate-test-token** - 生成测试 Access Token 用于 API 测试
 - **use-commerce-cli** - 使用 Commerce CLI 管理电商店铺
+- **read-code** - 阅读 Optima-Chat 组织下任意仓库的代码
 
 ## 👤 用户故事
 
@@ -75,6 +76,7 @@ Claude:
 | `/logs` | 查看服务日志 | `/logs commerce-backend 100` | ✅ |
 | `/query-db` | 查询数据库 | `/query-db user-auth "SELECT COUNT(*) FROM users"` | ✅ |
 | `/generate-test-token` | 生成测试 token | `/generate-test-token` | 🔧 Development |
+| `/read-code` | 阅读代码 | `/read-code commerce-backend app/main.py` | - |
 
 **说明**：
 - 命令支持 CI、Stage、Prod 三个环境
@@ -106,13 +108,15 @@ optima-dev-skills/
 │   ├── commands/
 │   │   ├── logs.md                    # /logs - 查看服务日志
 │   │   ├── query-db.md                # /query-db - 查询数据库
-│   │   └── generate-test-token.md     # /generate-test-token - 生成测试 token
+│   │   ├── generate-test-token.md     # /generate-test-token - 生成测试 token
+│   │   └── read-code.md               # /read-code - 阅读代码
 │   │
 │   └── skills/
 │       ├── logs/                      # 日志查看 skill
 │       ├── query-db/                  # 数据库查询 skill
 │       ├── generate-test-token/       # 测试 token 生成 skill
-│       └── use-commerce-cli/          # Commerce CLI 使用 skill
+│       ├── use-commerce-cli/          # Commerce CLI 使用 skill
+│       └── read-code/                 # 代码阅读 skill
 │
 ├── bin/
 │   └── helpers/
@@ -142,15 +146,17 @@ Claude:
 ### 示例 2：生成测试 token 并管理店铺
 
 ```bash
-# 1. 生成测试 token
-$ optima-generate-test-token
+# 1. 生成 production 环境测试 token
+$ optima-generate-test-token --env production
 
+Environment: production
+Auth API: https://auth.optima.shop
 ✅ 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 \
+  OPTIMA_ENV=production \
   commerce product create --title "测试商品" --price 99.99 --stock 100
 
 {
@@ -222,17 +228,18 @@ $ optima-query-db commerce-backend "SELECT id, title FROM products LIMIT 5" stag
 
 ## 🛠️ 开发状态
 
-**当前版本**: 0.5.4
+**当前版本**: 0.7.0
 
 **已完成**:
-- ✅ 3 个跨环境命令：`/logs`、`/query-db`、`/generate-test-token`
-- ✅ 4 个任务场景：`logs`、`query-db`、`generate-test-token`、`use-commerce-cli`
+- ✅ 4 个命令：`/logs`、`/query-db`、`/generate-test-token`、`/read-code`
+- ✅ 5 个任务场景：`logs`、`query-db`、`generate-test-token`、`use-commerce-cli`、`read-code`
 - ✅ 支持 CI、Stage、Prod 三个环境
 - ✅ CI 环境通过 SSH + Docker 访问
 - ✅ Stage/Prod 通过 SSH 隧道访问 RDS
 - ✅ TypeScript CLI 工具：`optima-query-db`、`optima-generate-test-token`
 - ✅ 通过 Infisical 动态获取密钥
 - ✅ 自动生成测试 token 并设置 merchant profile
+- ✅ `generate-test-token` 支持 development 和 production 环境
 
 **设计原则**:
 - 命令提供信息（URL、路径、凭证位置），不实现复杂逻辑

package/package.json

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

package/scripts/install.js

@@ -9,6 +9,9 @@ const SKILLS_SOURCE = path.join(__dirname, '..', '.claude');
 const COMMANDS_DEST = path.join(CLAUDE_DIR, 'commands');
 const LOGS_SKILL_DEST = path.join(CLAUDE_DIR, 'skills', 'logs');
 const QUERY_DB_SKILL_DEST = path.join(CLAUDE_DIR, 'skills', 'query-db');
+const GENERATE_TOKEN_SKILL_DEST = path.join(CLAUDE_DIR, 'skills', 'generate-test-token');
+const USE_COMMERCE_CLI_SKILL_DEST = path.join(CLAUDE_DIR, 'skills', 'use-commerce-cli');
+const READ_CODE_SKILL_DEST = path.join(CLAUDE_DIR, 'skills', 'read-code');
 
 // 颜色输出
 const colors = {
@@ -71,6 +74,22 @@ function install() {
     log(`✓ Installed /query-db command`, 'green');
   }
 
+  // 安装 /generate-test-token 命令
+  const generateTokenCommandSource = path.join(SKILLS_SOURCE, 'commands', 'generate-test-token.md');
+  const generateTokenCommandDest = path.join(COMMANDS_DEST, 'generate-test-token.md');
+  if (fs.existsSync(generateTokenCommandSource)) {
+    fs.copyFileSync(generateTokenCommandSource, generateTokenCommandDest);
+    log(`✓ Installed /generate-test-token command`, 'green');
+  }
+
+  // 安装 /read-code 命令
+  const readCodeCommandSource = path.join(SKILLS_SOURCE, 'commands', 'read-code.md');
+  const readCodeCommandDest = path.join(COMMANDS_DEST, 'read-code.md');
+  if (fs.existsSync(readCodeCommandSource)) {
+    fs.copyFileSync(readCodeCommandSource, readCodeCommandDest);
+    log(`✓ Installed /read-code command`, 'green');
+  }
+
   // 安装 logs skill
   const logsSkillSource = path.join(SKILLS_SOURCE, 'skills', 'logs');
   if (fs.existsSync(logsSkillSource)) {
@@ -85,13 +104,37 @@ function install() {
     log(`✓ Installed query-db skill`, 'green');
   }
 
+  // 安装 generate-test-token skill
+  const generateTokenSkillSource = path.join(SKILLS_SOURCE, 'skills', 'generate-test-token');
+  if (fs.existsSync(generateTokenSkillSource)) {
+    copyRecursive(generateTokenSkillSource, GENERATE_TOKEN_SKILL_DEST);
+    log(`✓ Installed generate-test-token skill`, 'green');
+  }
+
+  // 安装 use-commerce-cli skill
+  const useCommerceCliSkillSource = path.join(SKILLS_SOURCE, 'skills', 'use-commerce-cli');
+  if (fs.existsSync(useCommerceCliSkillSource)) {
+    copyRecursive(useCommerceCliSkillSource, USE_COMMERCE_CLI_SKILL_DEST);
+    log(`✓ Installed use-commerce-cli skill`, 'green');
+  }
+
+  // 安装 read-code skill
+  const readCodeSkillSource = path.join(SKILLS_SOURCE, 'skills', 'read-code');
+  if (fs.existsSync(readCodeSkillSource)) {
+    copyRecursive(readCodeSkillSource, READ_CODE_SKILL_DEST);
+    log(`✓ Installed read-code skill`, 'green');
+  }
+
   log('\n✨ Installation complete!\n', 'green');
   log('Available commands:', 'blue');
   log('  /logs <service> [lines] [environment]', 'yellow');
   log('  /query-db <service> <sql> [environment]', 'yellow');
+  log('  /generate-test-token [options]', 'yellow');
+  log('  /read-code <repo> [path]', 'yellow');
   log('\nExamples:', 'blue');
   log('  /logs commerce-backend                                    # CI logs', 'yellow');
   log('  /query-db commerce-backend "SELECT COUNT(*) FROM orders"  # CI query', 'yellow');
+  log('  /read-code commerce-backend app/main.py                   # Read code', 'yellow');
   log('\nDocumentation: https://github.com/Optima-Chat/optima-dev-skills\n', 'blue');
 }