@optima-chat/dev-skills 0.1.5 → 0.1.7

package/.claude/commands/logs.md

@@ -2,7 +2,7 @@
 
 快速查看服务日志，支持 Stage/Prod 两个环境。
 
-**版本**: v0.1.5
+**版本**: v0.1.7
 
 ## 使用场景
 
@@ -48,20 +48,13 @@
 
 **步骤**:
 ```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 +72,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 +91,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/skills/{viewing-logs → logs}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: "Viewing Server Logs"
-description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志时，使用此技能。支持 Stage、Prod 环境的 commerce-backend、user-auth、mcp-host、agentic-chat 服务。"
+name: "logs"
+description: "当用户请求查看日志、查看服务日志、排查问题、看看日志、检查日志、商品服务日志、后端日志、API日志、正式环境日志、生产环境日志时，使用此技能。支持 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

@@ -22,14 +22,14 @@ optima-dev-skills --version
 optima-dev-skills --help
 
 # 检查文件
-ls ~/.claude/commands/logs/
-ls ~/.claude/skills/scenarios/viewing-logs/
+ls ~/.claude/commands/
+ls ~/.claude/skills/logs/
 ```
 
 ### 已安装的能力
 
 - ✅ `/logs` 命令 - 查看 Stage/Prod 环境日志
-- ✅ `viewing-logs` 场景 - 完整的日志查看指导
+- ✅ `logs` skill - 自动识别日志查看需求
 
 ### 更新
 
@@ -50,7 +50,7 @@ Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个
 
 当 Claude Code 识别到以下任务时，会自动加载对应的 Skill：
 
-- **viewing-logs** - 查看 CI/Stage/Prod 的服务器日志
+- **logs** - 查看 CI/Stage/Prod 的服务器日志
 
 ## 👤 用户故事
 
@@ -108,7 +108,7 @@ optima-dev-skills/
 │   │   └── logs.md              # /logs - 查看服务日志
 │   │
 │   └── skills/
-│       └── viewing-logs/        # 查看日志场景
+│       └── logs/                # 日志查看 skill
 │           └── SKILL.md
 │
 └── docs/
@@ -184,7 +184,7 @@ Claude:
 
 **已完成**:
 - ✅ 1 个跨环境命令：`/logs`
-- ✅ 1 个任务场景：`viewing-logs`
+- ✅ 1 个任务场景：`logs` skill
 - ✅ 支持 CI、Stage、Prod 三个环境
 
 **设计原则**:

package/package.json

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

package/scripts/install.js

@@ -7,7 +7,7 @@ const os = require('os');
 const CLAUDE_DIR = path.join(os.homedir(), '.claude');
 const SKILLS_SOURCE = path.join(__dirname, '..', '.claude');
 const COMMANDS_DEST = path.join(CLAUDE_DIR, 'commands');
-const SKILLS_DEST = path.join(CLAUDE_DIR, 'skills', 'viewing-logs');
+const SKILLS_DEST = path.join(CLAUDE_DIR, 'skills', 'logs');
 
 // 颜色输出
 const colors = {
@@ -63,10 +63,10 @@ function install() {
   }
 
   // 安装 skills
-  const skillsSource = path.join(SKILLS_SOURCE, 'skills', 'viewing-logs');
+  const skillsSource = path.join(SKILLS_SOURCE, 'skills', 'logs');
   if (fs.existsSync(skillsSource)) {
     copyRecursive(skillsSource, SKILLS_DEST);
-    log(`✓ Installed viewing-logs skill to ${SKILLS_DEST}`, 'green');
+    log(`✓ Installed logs skill to ${SKILLS_DEST}`, 'green');
   } else {
     log(`✗ Skills not found at ${skillsSource}`, 'red');
   }