@optima-chat/dev-skills 0.1.7 → 0.1.9

package/.claude/commands/logs.md

@@ -1,8 +1,8 @@
 # /logs - 查看服务日志
 
-快速查看服务日志，支持 Stage/Prod 两个环境。
+快速查看服务日志，支持 CI/Stage/Prod 三个环境。
 
-**版本**: v0.1.7
+**版本**: 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,6 +44,49 @@
 
 ## 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`

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"]
 ---
 
@@ -17,7 +17,19 @@ allowed-tools: ["Bash", "SlashCommand"]
 
 ## 🚀 快速操作
 
-### 1. 查看 Stage 环境日志（默认）
+### 1. 查看 CI 环境日志
+
+```
+/logs commerce-backend 50 ci
+/logs user-auth 100 ci
+```
+
+**说明**：
+- 查看 CI 开发环境（dev.optima.chat）
+- 通过 SSH + Docker Compose 访问
+- 从 GitHub Variables 获取认证信息
+
+### 2. 查看 Stage 环境日志（默认）
 
 ```
 /logs commerce-backend
@@ -34,7 +46,7 @@ allowed-tools: ["Bash", "SlashCommand"]
 - `mcp-host` - MCP 协调器
 - `agentic-chat` - AI 聊天服务
 
-### 2. 查看更多日志行数
+### 3. 查看更多日志行数
 
 ```
 /logs commerce-backend 200
@@ -42,7 +54,7 @@ allowed-tools: ["Bash", "SlashCommand"]
 
 查看最近 200 行日志，用于排查历史问题。
 
-### 3. 查看 Prod 环境日志
+### 4. 查看 Prod 环境日志
 
 ```
 /logs commerce-backend 100 prod
@@ -128,28 +140,27 @@ INFO - Database query took 3200ms: SELECT * FROM products WHERE...
 
 ## 🌐 环境对比
 
-### Stage-ECS 环境
+### CI 环境
 
 ```
-/logs commerce-backend 100 stage
+/logs user-auth 100 ci
 ```
 
 **特点**：
-- ECS 容器运行
-- CloudWatch Logs 自动收集
-- log stream 名称动态变化（ECS Task ID）
-- 日志路径：`/ecs/{service}-stage`
-
-**实现方式**：
-```bash
-# IMPORTANT: 使用单行命令，避免反斜杠换行导致的参数解析错误
+- CI 开发环境，适合开发调试
+- 实时性最好
+- 查看 Docker Compose 日志
 
-# 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')
+### Stage 环境
 
-# 2. 获取日志
-aws logs get-log-events --log-group-name /ecs/commerce-backend-stage --log-stream-name "$STREAM" --limit 100 | jq -r '.events[] | .message'
 ```
+/logs commerce-backend 100 stage
+```
+
+**特点**：
+- 预发布环境
+- AWS ECS 运行
+- 通过 CloudWatch Logs 查看
 
 ### Prod 环境
 
@@ -158,22 +169,9 @@ aws logs get-log-events --log-group-name /ecs/commerce-backend-stage --log-strea
 ```
 
 **特点**：
-- Docker Compose 运行在 EC2
-- CloudWatch Logs Agent 收集
-- log stream 固定名称（backend, rq-worker, rq-scheduler）
-- 日志路径：`/optima/prod/{service}`
-
-**实现方式**：
-```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 --no-start-from-head | jq -r '.events[] | .message'
-```
-
-**可用的 log streams**：
-- `backend` - 主服务日志（推荐）
-- `rq-worker` - 后台任务日志
-- `rq-scheduler` - 调度器日志
+- 生产环境
+- EC2 + Docker Compose
+- 通过 CloudWatch Logs 查看
 
 ## 💡 最佳实践
 
@@ -185,79 +183,4 @@ aws logs get-log-events --log-group-name /optima/prod/commerce-backend --log-str
 
 ## 🔗 相关命令
 
-- `/logs` - 查看服务日志
-
-## 📚 技术细节
-
-### CloudWatch Logs 结构
-
-**Stage-ECS**:
-```
-Log Group: /ecs/commerce-backend-stage
-└── Log Stream: ecs/commerce-backend/d8e079f0b4fb47e398c61ee5d610ed9c (动态)
-    └── Events: 日志条目
-```
-
-**Prod**:
-```
-Log Group: /optima/prod/commerce-backend
-├── Log Stream: backend (固定)
-├── Log Stream: rq-worker (固定)
-└── Log Stream: rq-scheduler (固定)
-    └── Events: 日志条目
-```
-
-### 日志格式
-
-所有日志通过 CloudWatch Logs 返回 JSON 格式：
-
-```json
-{
-  "events": [
-    {
-      "timestamp": 1763904521976,
-      "message": "INFO: 10.0.2.199:64952 - \"GET /health HTTP/1.1\" 200 OK",
-      "ingestionTime": 1763904526810
-    }
-  ]
-}
-```
-
-使用 `jq -r '.events[] | .message'` 提取纯文本：
-
-```
-INFO: 10.0.2.199:64952 - "GET /health HTTP/1.1" 200 OK
-```
-
-## ⚠️ 注意事项
-
-### 权限要求
-
-需要 AWS CLI 配置了以下权限：
-- `logs:DescribeLogStreams`
-- `logs:GetLogEvents`
-
-### 日志延迟
-
-CloudWatch Logs 可能有 1-2 秒延迟，实时调试时需注意。
-
-### 日志保留
-
-- **Stage**: 7 天
-- **Prod**: 30 天（建议配置）
-
-### 常见错误
-
-**ResourceNotFoundException**:
-```
-An error occurred (ResourceNotFoundException) when calling the GetLogEvents operation
-```
-
-**解决**：检查服务名称和环境是否正确：
-```bash
-# 列出所有 Stage 日志组
-aws logs describe-log-groups --log-group-name-prefix /ecs
-
-# 列出所有 Prod 日志组
-aws logs describe-log-groups --log-group-name-prefix /optima/prod
-```
+- `/logs` - 查看服务日志（详细使用方法和技术细节请查看 `/logs --help`）

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.7",
+  "version": "0.1.9",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {