@optima-chat/dev-skills 0.1.8 → 0.1.9

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

@@ -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/package.json

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