@optima-chat/dev-skills 0.1.0

package/.claude/commands/logs/logs.md

@@ -0,0 +1,164 @@
+# /logs - 查看服务日志
+
+快速查看服务日志，支持 Stage/Prod 两个环境。
+
+## 使用场景
+
+**前端开发者**: 当 API 调用返回 500 错误时，查看后端日志排查问题
+**后端开发者**: 实时监控服务运行状态，调试代码逻辑
+**DevOps**: 排查生产环境问题，查看错误堆栈
+
+## 用法
+
+```
+/logs <service> [lines] [environment]
+```
+
+## 参数
+
+- `service` (必需): 服务名称
+  - `commerce-backend` - 电商后端
+  - `user-auth` - 用户认证
+  - `mcp-host` - MCP 协调器
+  - `agentic-chat` - AI 聊天服务
+- `lines` (可选): 显示行数，默认 50
+- `environment` (可选): 环境，默认 stage
+  - `stage` - Stage 预发布环境
+  - `prod` - 生产环境
+
+## 示例
+
+```bash
+/logs commerce-backend           # 查看 Stage 环境最近 50 行
+/logs user-auth 100              # 查看 Stage 环境最近 100 行
+/logs mcp-host 200 prod          # 查看 Prod 环境最近 200 行
+```
+
+## Claude Code 执行步骤
+
+### 1. Stage 环境
+
+**日志路径格式**: `/ecs/{service}-stage`
+
+**步骤**:
+```bash
+# 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')
+
+# 2. 获取日志内容（纯文本）
+aws logs get-log-events \
+  --log-group-name /ecs/commerce-backend-stage \
+  --log-stream-name "$STREAM" \
+  --limit 50 \
+  | jq -r '.events[] | .message'
+```
+
+**服务映射**:
+- `commerce-backend` → `/ecs/commerce-backend-stage`
+- `user-auth` → `/ecs/user-auth-stage`
+- `mcp-host` → `/ecs/mcp-host-stage`
+- `agentic-chat` → `/ecs/agentic-chat-stage`
+
+### 2. Prod 环境
+
+**日志路径格式**: `/optima/prod/{service}`
+
+**步骤**:
+```bash
+# 获取日志内容（纯文本）
+# 注意：Prod 环境的 log stream 通常是固定的 "backend"
+aws logs get-log-events \
+  --log-group-name /optima/prod/commerce-backend \
+  --log-stream-name backend \
+  --limit 50 \
+  --start-from-head false \
+  | jq -r '.events[] | .message'
+```
+
+**服务映射**:
+- `commerce-backend` → `/optima/prod/commerce-backend`
+- `user-auth` → `/optima/prod/user-auth`
+- `mcp-host` → `/optima/prod/mcp-host`
+- `agentic-chat` → `/optima/prod/agentic-chat`
+
+**Log Stream 名称**:
+- `backend` - 主服务日志
+- `rq-worker` - 后台任务日志
+- `rq-scheduler` - 调度器日志
+
+## 完整示例脚本
+
+### Stage 环境
+```bash
+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'
+```
+
+### Prod 环境
+```bash
+SERVICE="commerce-backend"
+LINES=50
+
+# 显示主服务日志
+aws logs get-log-events \
+  --log-group-name /optima/prod/${SERVICE} \
+  --log-stream-name backend \
+  --limit $LINES \
+  --start-from-head false \
+  | jq -r '.events[] | .message'
+```
+
+## 常见错误处理
+
+### 错误：ResourceNotFoundException
+
+**原因**: 日志组不存在
+
+**解决**:
+```bash
+# 列出所有可用的日志组
+aws logs describe-log-groups --log-group-name-prefix /ecs
+aws logs describe-log-groups --log-group-name-prefix /optima/prod
+```
+
+### 错误：No log streams found
+
+**原因**: 服务可能未运行或刚启动
+
+**解决**:
+```bash
+# 检查日志组是否有 streams
+aws logs describe-log-streams \
+  --log-group-name /ecs/commerce-backend-stage \
+  --max-items 5
+```
+
+## 注意事项
+
+1. **Stage 环境**: log stream 名称是动态的（ECS Task ID），需要先查询最新的 stream
+2. **Prod 环境**: log stream 通常是固定的 `backend`、`rq-worker` 等
+3. **日志延迟**: CloudWatch Logs 可能有 1-2 秒延迟
+4. **权限要求**: 需要 AWS CLI 配置了正确的凭证和权限
+
+## 相关资源
+
+- CloudWatch Logs 文档: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/
+- AWS CLI logs 命令: https://docs.aws.amazon.com/cli/latest/reference/logs/

package/.claude/settings.local.json

@@ -0,0 +1,27 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch(domain:code.claude.com)",
+      "WebFetch(domain:platform.claude.com)",
+      "WebFetch(domain:github.com)",
+      "Bash(gh repo view:*)",
+      "Bash(gh repo clone:*)",
+      "Bash(gh repo list:*)",
+      "Read(//private/tmp/optima-docs/**)",
+      "Read(//tmp/optima-docs/**)",
+      "Bash(git init:*)",
+      "Bash(gh repo create:*)",
+      "Read(//private/tmp/optima-workspace/**)",
+      "Read(//tmp/optima-workspace/**)",
+      "Read(//tmp/optima-workspace/.claude/commands/**)",
+      "Bash(git add:*)",
+      "Bash(git push:*)",
+      "Bash(find:*)",
+      "Bash(git commit:*)",
+      "Bash(aws logs get-log-events:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/skills/scenarios/viewing-logs/SKILL.md

@@ -0,0 +1,272 @@
+---
+name: "Viewing Server Logs"
+description: "查看服务器日志 - Stage、Prod 环境的日志查看，快速定位问题"
+allowed-tools: ["Bash", "SlashCommand"]
+---
+
+# 查看服务器日志
+
+当你需要查看服务日志排查问题时，使用这个场景。
+
+## 🎯 适用情况
+
+- API 返回错误，需要查看详细错误信息
+- 服务行为异常，需要查看运行日志
+- 监控服务状态，查看日志输出
+- 排查数据库连接、配置问题
+
+## 🚀 快速操作
+
+### 1. 查看 Stage 环境日志（默认）
+
+```
+/logs commerce-backend
+```
+
+**说明**：
+- 自动查看 Stage-ECS 环境
+- 默认显示最近 50 行
+- 使用 AWS CloudWatch Logs
+
+**常用服务**：
+- `commerce-backend` - 电商 API
+- `user-auth` - 用户认证
+- `mcp-host` - MCP 协调器
+- `agentic-chat` - AI 聊天服务
+
+### 2. 查看更多日志行数
+
+```
+/logs commerce-backend 200
+```
+
+查看最近 200 行日志，用于排查历史问题。
+
+### 3. 查看 Prod 环境日志
+
+```
+/logs commerce-backend 100 prod
+```
+
+查看生产环境日志（通过 AWS CloudWatch）。
+
+## 📋 常见问题排查
+
+### 问题 1：API 返回 500 错误
+
+**步骤**：
+1. 查看日志：`/logs commerce-backend 100`
+2. 搜索 ERROR 关键字
+3. 查看完整错误堆栈
+4. 定位问题代码或数据
+
+**示例日志**：
+```
+ERROR - 2025-01-23 10:30:45 - Exception in /products endpoint
+Traceback:
+  File "app/routes/products.py", line 45
+    merchant = db.query(Merchant).filter(id == product.merchant_id).first()
+  MerchantNotFound: Merchant with id 'xxx' not found
+```
+
+### 问题 2：服务启动失败
+
+**步骤**：
+1. 查看启动日志：`/logs commerce-backend 200`
+2. 查找启动错误信息
+3. 检查环境变量、数据库连接
+
+**常见错误**：
+- 数据库连接失败
+- Redis 连接失败
+- 环境变量缺失
+
+**示例日志**：
+```
+redis.exceptions.ConnectionError: Error connecting to localhost:8285.
+Multiple exceptions: [Errno 111] Connection refused
+ERROR:    Application startup failed. Exiting.
+```
+
+### 问题 3：性能问题（响应慢）
+
+**步骤**：
+1. 查看日志：`/logs commerce-backend`
+2. 查找 "response_time" 或包含毫秒数的日志
+3. 识别慢查询或慢接口
+
+**示例**：
+```
+INFO - GET /products - response_time: 3500ms (SLOW)
+INFO - Database query took 3200ms: SELECT * FROM products WHERE...
+```
+
+## 🔍 日志分析技巧
+
+### 过滤关键信息
+
+查看日志后，可以使用 grep 过滤：
+
+```bash
+# 只看错误
+/logs commerce-backend 200 | grep -i error
+
+# 只看特定 API
+/logs commerce-backend 200 | grep "GET /products"
+
+# 查看 Redis 相关日志
+/logs commerce-backend 200 | grep -i redis
+```
+
+### 日志级别
+
+日志级别说明：
+- **ERROR** - 错误，需要立即处理
+- **WARNING** - 警告，可能有问题
+- **INFO** - 信息，正常运行日志
+- **DEBUG** - 调试信息，详细输出
+
+## 🌐 环境对比
+
+### Stage-ECS 环境
+
+```
+/logs commerce-backend 100 stage
+```
+
+**特点**：
+- ECS 容器运行
+- CloudWatch Logs 自动收集
+- log stream 名称动态变化（ECS Task ID）
+- 日志路径：`/ecs/{service}-stage`
+
+**实现方式**：
+```bash
+# 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')
+
+# 2. 获取日志
+aws logs get-log-events \
+  --log-group-name /ecs/commerce-backend-stage \
+  --log-stream-name "$STREAM" \
+  --limit 100 \
+  | jq -r '.events[] | .message'
+```
+
+### Prod 环境
+
+```
+/logs commerce-backend 100 prod
+```
+
+**特点**：
+- Docker Compose 运行在 EC2
+- CloudWatch Logs Agent 收集
+- log stream 固定名称（backend, rq-worker, rq-scheduler）
+- 日志路径：`/optima/prod/{service}`
+
+**实现方式**：
+```bash
+# 获取主服务日志
+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'
+```
+
+**可用的 log streams**：
+- `backend` - 主服务日志（推荐）
+- `rq-worker` - 后台任务日志
+- `rq-scheduler` - 调度器日志
+
+## 💡 最佳实践
+
+1. **先查日志，再动手修** - 不要猜测，看日志确认问题
+2. **查足够多的行数** - 有时错误原因在更早的日志里
+3. **关注启动日志** - 服务启动时的错误最关键
+4. **保留错误日志** - 复制错误信息，方便分享讨论
+5. **对比环境差异** - Stage 出错、Prod 正常？对比日志差异
+
+## 🔗 相关命令
+
+- `/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
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Optima AI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# Optima Dev Skills
+
+**命令驱动的 Claude Skills - 为 Optima AI 开发团队提供跨环境协作的开发工具**
+
+## 📦 快速安装
+
+```bash
+npm install -g @optima-chat/dev-skills@latest
+```
+
+安装后，Claude Code 会自动获得以下能力：
+- `/logs` 命令 - 查看 Stage/Prod 环境日志
+- `viewing-logs` 场景 - 完整的日志查看指导
+
+## 🎯 核心理念
+
+Optima Dev Skills 让 Claude Code 能够直接在 **CI、Stage、Prod** 三个环境中执行开发任务。
+
+**核心价值**:
+- **即时执行** - Claude 直接执行操作，开发者零手动操作
+- **任务驱动** - 基于具体任务场景（查看日志、调用 API），不是抽象分类
+- **跨环境协作** - 统一的命令在 CI、Stage、Prod 三个环境中使用
+
+## 📋 任务场景（1 个）
+
+当 Claude Code 识别到以下任务时，会自动加载对应的 Skill：
+
+- **viewing-logs** - 查看 CI/Stage/Prod 的服务器日志
+
+## 👤 用户故事
+
+**场景：排查 Stage 环境问题**
+
+```
+开发者: "Stage 的商品 API 返回 500，帮我看看日志"
+
+Claude:
+  → 执行 /logs commerce-backend 100 stage
+  → 分析日志，发现数据库查询错误
+  → 定位问题：某个商品的 merchant_id 不存在
+
+开发者: "明白了，我去修复数据"
+```
+
+**传统方式需要**：
+1. 登录 AWS Console
+2. 找到 CloudWatch Logs
+3. 筛选服务和时间
+4. 手动查看日志
+
+**使用 dev-skills**：一句话，Claude 自动完成。
+
+## 🌐 支持的环境
+
+| 环境 | 部署方式 | 服务器 | 访问地址示例 |
+|------|---------|--------|------------|
+| **CI** | Docker Compose | dev.optima.chat | api.optima.chat<br>auth.optima.chat<br>mcp.optima.chat |
+| **Stage** | AWS ECS | AWS ECS | api.stage.optima.onl<br>auth.stage.optima.onl<br>mcp.stage.optima.onl |
+| **Prod** | EC2 + Docker | AWS EC2 | api.optima.shop<br>auth.optima.shop<br>mcp.optima.shop |
+
+**说明**：
+- **CI** - 团队共享的持续集成测试环境，部署在 dev.optima.chat 服务器
+- **Stage** - 预发布环境，用于上线前的最终验证
+- **Prod** - 生产环境，服务真实用户
+
+## 🚀 可用命令
+
+| 命令 | 说明 | 示例 | 跨环境 |
+|------|------|------|--------|
+| `/logs` | 查看服务日志 | `/logs commerce-backend 100 stage` | ✅ |
+
+**说明**：
+- 命令支持 CI、Stage、Prod 三个环境
+- Claude Code 会根据上下文自动选择环境
+- 命令提供信息和入口，具体操作由 Claude Code 智能完成
+
+## 🏗️ 项目结构
+
+```
+optima-dev-skills/
+├── .claude/
+│   ├── commands/
+│   │   └── logs/
+│   │       └── logs.md           # /logs - 查看服务日志
+│   │
+│   └── skills/
+│       └── scenarios/
+│           └── viewing-logs/     # 查看日志场景
+│               └── SKILL.md
+│
+└── docs/
+    └── COMMANDS_DESIGN.md
+```
+
+## 💡 使用示例
+
+### 示例：排查 Stage 环境问题
+
+```
+开发者: "Stage 的 /products API 返回 500"
+
+Claude:
+1. /logs commerce-backend 100 stage
+   → 查看 CloudWatch 日志
+
+2. 发现错误：Database connection timeout
+
+3. 问题定位：Stage RDS 连接配置问题
+```
+
+## 🎯 设计原则
+
+### dev-skills 提供什么？
+
+- ✅ **跨环境命令** - 在 CI/Stage/Prod 统一执行
+- ✅ **任务场景指导** - 完整的操作流程（不是零散命令）
+- ✅ **团队协作工具** - 跨仓库、跨环境的共享知识
+
+### dev-skills 不提供什么？
+
+- ❌ **单个服务的开发文档** → 看各服务的 `CLAUDE.md`
+- ❌ **服务内部架构** → 看各服务的 `CLAUDE.md`
+- ❌ **API 详细文档** → 用 `/swagger` 命令查看
+
+### 为什么要这样设计？
+
+1. **避免重复** - 服务级文档已经在各服务的 CLAUDE.md 中
+2. **聚焦协作** - dev-skills 专注于跨服务、跨环境的协作场景
+3. **易于维护** - 命令和场景独立维护，不与服务代码耦合
+
+## 📊 效率提升
+
+| 操作 | 传统方式 | 使用命令 | 节省时间 |
+|------|---------|---------|---------|
+| 查看 Stage 日志 | 登录 AWS Console → CloudWatch → 筛选 | `/logs service 100 stage` | **90%** |
+| 获取 API Token | 找密码 → Postman → 复制粘贴 | `/get-token user@optima.ai` | **85%** |
+| 创建测试数据 | 手动调用 API 10 次 | `/create-test-product 10` | **95%** |
+| 连接 Stage 数据库 | 找密码 → 复制连接串 → psql | `/query-db commerce stage` | **90%** |
+
+**平均节省时间**: **90%+**
+
+## 🔐 安全说明
+
+本仓库**不包含**任何敏感信息：
+
+✅ **包含**：
+- 服务地址和端口（公开信息）
+- 文档链接
+- 获取密钥的方式（Infisical 路径，不是密钥本身）
+
+❌ **不包含**：
+- API Key、密码
+- 数据库密码
+- AWS 凭证
+
+所有密钥通过 Infisical 管理，命令只描述如何获取，不存储实际值。
+
+## 🛠️ 开发状态
+
+**当前版本**: 0.1.0 (MVP)
+
+**已完成**:
+- ✅ 1 个跨环境命令：`/logs`
+- ✅ 1 个任务场景：`viewing-logs`
+- ✅ 支持 CI、Stage、Prod 三个环境
+
+**设计原则**:
+- 命令提供信息（URL、路径、凭证位置），不实现复杂逻辑
+- Claude Code 利用自身工具（WebFetch、Bash）完成实际操作
+- 聚焦跨环境协作，避免与服务文档重复
+
+## 📚 相关文档
+
+- [命令设计方案](docs/COMMANDS_DESIGN.md) - 完整的命令驱动设计思路
+
+## 📝 维护
+
+由 Optima AI 开发团队维护。
+
+如发现问题：
+1. 提交 Issue 到 GitHub
+2. 或直接提交 PR 修复
+
+## 📄 License
+
+MIT
+
+---
+
+**🤖 Powered by [Claude Code](https://claude.com/claude-code)**

package/bin/cli.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+const command = process.argv[2];
+
+switch (command) {
+  case 'version':
+  case '-v':
+  case '--version':
+    const pkg = require('../package.json');
+    log(`v${pkg.version}`, 'green');
+    break;
+
+  case 'help':
+  case '-h':
+  case '--help':
+  default:
+    log('\n📦 Optima Dev Skills', 'blue');
+    log('\nClaude Code skills for Optima development team\n', 'cyan');
+
+    log('Installed Commands:', 'yellow');
+    log('  /logs <service> [lines] [environment]    View service logs', 'cyan');
+    log('\nExamples:', 'yellow');
+    log('  /logs commerce-backend                   Stage, 50 lines', 'cyan');
+    log('  /logs user-auth 100                      Stage, 100 lines', 'cyan');
+    log('  /logs mcp-host 200 prod                  Prod, 200 lines', 'cyan');
+
+    log('\nSupported Services:', 'yellow');
+    log('  commerce-backend  user-auth  mcp-host  agentic-chat', 'cyan');
+
+    log('\nEnvironments:', 'yellow');
+    log('  stage (default)   prod', 'cyan');
+
+    log('\nCLI Commands:', 'yellow');
+    log('  optima-dev-skills --version              Show version', 'cyan');
+    log('  optima-dev-skills --help                 Show this help', 'cyan');
+
+    log('\nDocumentation:', 'yellow');
+    log('  https://github.com/Optima-Chat/optima-dev-skills\n', 'cyan');
+    break;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@optima-chat/dev-skills",
+  "version": "0.1.0",
+  "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
+  "main": "index.js",
+  "bin": {
+    "optima-dev-skills": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "keywords": [
+    "claude-code",
+    "skills",
+    "optima",
+    "devops",
+    "logs",
+    "aws",
+    "cloudwatch"
+  ],
+  "author": "Optima AI Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Optima-Chat/optima-dev-skills.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Optima-Chat/optima-dev-skills/issues"
+  },
+  "homepage": "https://github.com/Optima-Chat/optima-dev-skills#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    ".claude",
+    "bin",
+    "scripts",
+    "README.md"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+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', 'logs');
+const SKILLS_DEST = path.join(CLAUDE_DIR, 'skills', 'scenarios', 'viewing-logs');
+
+// 颜色输出
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) {
+    return;
+  }
+
+  if (fs.statSync(src).isDirectory()) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    const files = fs.readdirSync(src);
+    files.forEach(file => {
+      copyRecursive(path.join(src, file), path.join(dest, file));
+    });
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function install() {
+  log('\n🚀 Installing Optima Dev Skills...\n', 'blue');
+
+  // 确保 .claude 目录存在
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+    log(`✓ Created ${CLAUDE_DIR}`, 'green');
+  }
+
+  // 安装命令
+  const commandsSource = path.join(SKILLS_SOURCE, 'commands', 'logs');
+  if (fs.existsSync(commandsSource)) {
+    copyRecursive(commandsSource, COMMANDS_DEST);
+    log(`✓ Installed /logs command to ${COMMANDS_DEST}`, 'green');
+  } else {
+    log(`✗ Commands not found at ${commandsSource}`, 'red');
+  }
+
+  // 安装 skills
+  const skillsSource = path.join(SKILLS_SOURCE, 'skills', 'scenarios', 'viewing-logs');
+  if (fs.existsSync(skillsSource)) {
+    copyRecursive(skillsSource, SKILLS_DEST);
+    log(`✓ Installed viewing-logs skill to ${SKILLS_DEST}`, 'green');
+  } else {
+    log(`✗ Skills not found at ${skillsSource}`, 'red');
+  }
+
+  log('\n✨ Installation complete!\n', 'green');
+  log('Available commands:', 'blue');
+  log('  /logs <service> [lines] [environment]', 'yellow');
+  log('\nExamples:', 'blue');
+  log('  /logs commerce-backend              # Stage, 50 lines', 'yellow');
+  log('  /logs user-auth 100                 # Stage, 100 lines', 'yellow');
+  log('  /logs mcp-host 200 prod             # Prod, 200 lines', 'yellow');
+  log('\nDocumentation: https://github.com/Optima-Chat/optima-dev-skills\n', 'blue');
+}
+
+try {
+  install();
+} catch (error) {
+  log(`\n✗ Installation failed: ${error.message}\n`, 'red');
+  process.exit(1);
+}