@optima-chat/dev-skills 0.1.6 → 0.1.8

package/.claude/commands/logs.md

@@ -1,8 +1,8 @@
 # /logs - 查看服务日志
 
-快速查看服务日志，支持 Stage/Prod 两个环境。
+快速查看服务日志，支持 CI/Stage/Prod 三个环境。
 
-**版本**: v0.1.6
+**版本**: v0.1.8
 
 ## 使用场景
 
@@ -25,6 +25,7 @@
   - `agentic-chat` - AI 聊天服务
 - `lines` (可选): 显示行数，默认 50
 - `environment` (可选): 环境，默认 stage
+  - `ci` - CI 持续集成环境
   - `stage` - Stage 预发布环境
   - `prod` - 生产环境
 
@@ -34,6 +35,7 @@
 /logs commerce-backend           # 查看 Stage 环境最近 50 行
 /logs user-auth 100              # 查看 Stage 环境最近 100 行
 /logs mcp-host 200 prod          # 查看 Prod 环境最近 200 行
+/logs commerce-backend 100 ci    # 查看 CI 环境最近 100 行
 ```
 
 ## 特殊参数处理
@@ -42,26 +44,62 @@
 
 ## Claude Code 执行步骤
 
+### 0. CI 环境
+
+**访问方式**: SSH + Docker Compose
+
+**步骤**:
+```bash
+# IMPORTANT: 使用单行命令，使用 sshpass 进行密码认证
+
+# 获取 CI 服务器配置（从 GitHub Variables）
+CI_USER=$(gh variable get CI_SSH_USER -R Optima-Chat/optima-dev-skills)
+CI_HOST=$(gh variable get CI_SSH_HOST -R Optima-Chat/optima-dev-skills)
+CI_PASSWORD=$(gh variable get CI_SSH_PASSWORD -R Optima-Chat/optima-dev-skills)
+
+# 查看日志（根据服务选择不同的 docker-compose.yml 路径）
+sshpass -p "$CI_PASSWORD" ssh -o StrictHostKeyChecking=no ${CI_USER}@${CI_HOST} "cd /data/xuhao/commerce-backend && docker compose logs --tail 50 commerce-backend"
+```
+
+**服务映射**（路径 + 服务名）:
+- `commerce-backend` → `/data/xuhao/commerce-backend` → `commerce-backend`
+- `user-auth` → `/data/xuhao/user-auth` → `user-auth`
+- `mcp-host` → `/data/xuhao/mcp-host` → `app`
+- `agentic-chat` → `/data/xuhao/agentic-chat` → `optima-ai-chat`
+
+**完整命令示例**（先获取配置）:
+```bash
+# 获取配置
+CI_USER=$(gh variable get CI_SSH_USER -R Optima-Chat/optima-dev-skills)
+CI_HOST=$(gh variable get CI_SSH_HOST -R Optima-Chat/optima-dev-skills)
+CI_PASSWORD=$(gh variable get CI_SSH_PASSWORD -R Optima-Chat/optima-dev-skills)
+
+# commerce-backend
+sshpass -p "$CI_PASSWORD" ssh -o StrictHostKeyChecking=no ${CI_USER}@${CI_HOST} "cd /data/xuhao/commerce-backend && docker compose logs --tail 50 commerce-backend"
+
+# user-auth
+sshpass -p "$CI_PASSWORD" ssh -o StrictHostKeyChecking=no ${CI_USER}@${CI_HOST} "cd /data/xuhao/user-auth && docker compose logs --tail 50 user-auth"
+
+# mcp-host
+sshpass -p "$CI_PASSWORD" ssh -o StrictHostKeyChecking=no ${CI_USER}@${CI_HOST} "cd /data/xuhao/mcp-host && docker compose logs --tail 50 app"
+
+# agentic-chat
+sshpass -p "$CI_PASSWORD" ssh -o StrictHostKeyChecking=no ${CI_USER}@${CI_HOST} "cd /data/xuhao/agentic-chat && docker compose logs --tail 50 optima-ai-chat"
+```
+
 ### 1. Stage 环境
 
 **日志路径格式**: `/ecs/{service}-stage`
 
 **步骤**:
 ```bash
+# IMPORTANT: 必须使用单行命令，不要使用反斜杠换行
+
 # 1. 获取最新的 log stream
-STREAM=$(aws logs describe-log-streams \
-  --log-group-name /ecs/commerce-backend-stage \
-  --order-by LastEventTime \
-  --descending \
-  --max-items 1 \
-  | jq -r '.logStreams[0].logStreamName')
+STREAM=$(aws logs describe-log-streams --log-group-name /ecs/commerce-backend-stage --order-by LastEventTime --descending --max-items 1 | jq -r '.logStreams[0].logStreamName')
 
 # 2. 获取日志内容（纯文本）
-aws logs get-log-events \
-  --log-group-name /ecs/commerce-backend-stage \
-  --log-stream-name "$STREAM" \
-  --limit 50 \
-  | jq -r '.events[] | .message'
+aws logs get-log-events --log-group-name /ecs/commerce-backend-stage --log-stream-name "$STREAM" --limit 50 | jq -r '.events[] | .message'
 ```
 
 **服务映射**:
@@ -79,12 +117,8 @@ aws logs get-log-events \
 # 获取日志内容（纯文本）
 # 注意：Prod 环境的 log stream 通常是固定的 "backend"
 # 使用 --no-start-from-head 从最新日志开始读取
-aws logs get-log-events \
-  --log-group-name /optima/prod/commerce-backend \
-  --log-stream-name backend \
-  --limit 50 \
-  --no-start-from-head \
-  | jq -r '.events[] | .message'
+# IMPORTANT: 必须使用单行命令，不要使用反斜杠换行
+aws logs get-log-events --log-group-name /optima/prod/commerce-backend --log-stream-name backend --limit 50 --no-start-from-head | jq -r '.events[] | .message'
 ```
 
 **服务映射**:
@@ -102,35 +136,23 @@ aws logs get-log-events \
 
 ### Stage 环境
 ```bash
+# IMPORTANT: 使用单行命令
 SERVICE="commerce-backend"
 LINES=50
 
-# 获取最新 stream
-STREAM=$(aws logs describe-log-streams \
-  --log-group-name /ecs/${SERVICE}-stage \
-  --order-by LastEventTime --descending --max-items 1 \
-  | jq -r '.logStreams[0].logStreamName')
-
-# 显示日志
-aws logs get-log-events \
-  --log-group-name /ecs/${SERVICE}-stage \
-  --log-stream-name "$STREAM" \
-  --limit $LINES \
-  | jq -r '.events[] | .message'
+# 获取最新 stream 并显示日志
+STREAM=$(aws logs describe-log-streams --log-group-name /ecs/${SERVICE}-stage --order-by LastEventTime --descending --max-items 1 | jq -r '.logStreams[0].logStreamName')
+aws logs get-log-events --log-group-name /ecs/${SERVICE}-stage --log-stream-name "$STREAM" --limit $LINES | jq -r '.events[] | .message'
 ```
 
 ### Prod 环境
 ```bash
+# IMPORTANT: 使用单行命令
 SERVICE="commerce-backend"
 LINES=50
 
 # 显示主服务日志（从最新开始）
-aws logs get-log-events \
-  --log-group-name /optima/prod/${SERVICE} \
-  --log-stream-name backend \
-  --limit $LINES \
-  --no-start-from-head \
-  | jq -r '.events[] | .message'
+aws logs get-log-events --log-group-name /optima/prod/${SERVICE} --log-stream-name backend --limit $LINES --no-start-from-head | jq -r '.events[] | .message'
 ```
 
 ## 常见错误处理

package/.claude/settings.local.json

@@ -21,7 +21,8 @@
       "Bash(git commit:*)",
       "Bash(aws logs get-log-events:*)",
       "Bash(npm install:*)",
-      "Bash(optima-dev-skills:*)"
+      "Bash(optima-dev-skills:*)",
+      "Bash(gh variable set:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/logs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "logs"
-description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志、正式环境日志、生产环境日志时，使用此技能。支持 Stage、Prod 环境的 commerce-backend、user-auth、mcp-host、agentic-chat 服务。"
+description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志、正式环境日志、生产环境日志、CI环境日志、开发环境日志时，使用此技能。支持 CI、Stage、Prod 三个环境的 commerce-backend、user-auth、mcp-host、agentic-chat 服务。"
 allowed-tools: ["Bash", "SlashCommand"]
 ---
 
@@ -142,18 +142,13 @@ INFO - Database query took 3200ms: SELECT * FROM products WHERE...
 
 **实现方式**：
 ```bash
+# IMPORTANT: 使用单行命令，避免反斜杠换行导致的参数解析错误
+
 # 1. 获取最新 log stream
-STREAM=$(aws logs describe-log-streams \
-  --log-group-name /ecs/commerce-backend-stage \
-  --order-by LastEventTime --descending --max-items 1 \
-  | jq -r '.logStreams[0].logStreamName')
+STREAM=$(aws logs describe-log-streams --log-group-name /ecs/commerce-backend-stage --order-by LastEventTime --descending --max-items 1 | jq -r '.logStreams[0].logStreamName')
 
 # 2. 获取日志
-aws logs get-log-events \
-  --log-group-name /ecs/commerce-backend-stage \
-  --log-stream-name "$STREAM" \
-  --limit 100 \
-  | jq -r '.events[] | .message'
+aws logs get-log-events --log-group-name /ecs/commerce-backend-stage --log-stream-name "$STREAM" --limit 100 | jq -r '.events[] | .message'
 ```
 
 ### Prod 环境
@@ -170,13 +165,9 @@ aws logs get-log-events \
 
 **实现方式**：
 ```bash
+# IMPORTANT: 使用单行命令，使用 --no-start-from-head 而不是 --start-from-head false
 # 获取主服务日志
-aws logs get-log-events \
-  --log-group-name /optima/prod/commerce-backend \
-  --log-stream-name backend \
-  --limit 100 \
-  --start-from-head false \
-  | jq -r '.events[] | .message'
+aws logs get-log-events --log-group-name /optima/prod/commerce-backend --log-stream-name backend --limit 100 --no-start-from-head | jq -r '.events[] | .message'
 ```
 
 **可用的 log streams**：

package/README.md

@@ -180,12 +180,14 @@ Claude:
 
 ## 🛠️ 开发状态
 
-**当前版本**: 0.1.0 (MVP)
+**当前版本**: 0.1.8
 
 **已完成**:
 - ✅ 1 个跨环境命令：`/logs`
 - ✅ 1 个任务场景：`logs` skill
 - ✅ 支持 CI、Stage、Prod 三个环境
+- ✅ CI 环境通过 SSH + Docker Compose 访问
+- ✅ Stage/Prod 通过 AWS CloudWatch Logs 访问
 
 **设计原则**:
 - 命令提供信息（URL、路径、凭证位置），不实现复杂逻辑

package/package.json

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