@optima-chat/dev-skills 0.7.27 → 0.7.29

package/.claude/commands/logs.md

@@ -29,13 +29,22 @@
   - `ai-shell-web-ui` - Shell Web UI
   - `optima-scout` - 产品研究工具
   - `optima-store` - 商城前端（仅 Stage）
+  - `ads-backend` - Google Ads API 代理服务
+  - `ads-worker` - Ads 对账后台任务
+  - `amazon-backend` - Amazon SP-API 集成服务
+  - `shopify-backend` - Shopify 店铺管理服务
   - `commerce-rq-worker` - RQ 后台任务
   - `commerce-rq-scheduler` - RQ 定时调度
+  - `gateway-core` - Gateway 核心服务
+  - `gw-admin` - Gateway 管理后台
+  - `optima-channels` - Channels 服务
   - `optima-logistics` - 物流服务（仅 Stage/Prod）
   - `billing` - 计费服务（仅 Stage/Prod）
   - `browser-backend` - 浏览器自动化服务（仅 Stage/Prod）
   - `optima-generation` - 内容生成服务（仅 Stage/Prod）
   - `optima-generation-worker` - 内容生成 Worker（仅 Stage/Prod）
+  - `optima-sentinel` - Sentinel API（仅 Stage/Prod）
+  - `optima-sentinel-worker` - Sentinel 后台任务（仅 Stage/Prod）
 - `lines` (可选): 显示行数，默认 50
 - `environment` (可选): 环境，默认 ci
   - `ci` - CI 持续集成环境（开发环境，默认）
@@ -129,13 +138,22 @@ aws logs get-log-events --log-group-name /ecs/commerce-backend-stage --log-strea
 - `ai-shell-web-ui` → `/ecs/ai-shell-web-ui-stage`
 - `optima-scout` → `/ecs/optima-scout-stage`
 - `optima-store` → `/ecs/optima-store-stage`
+- `ads-backend` → `/ecs/ads-backend-stage`
+- `ads-worker` → `/ecs/ads-worker-stage`
+- `amazon-backend` → `/ecs/amazon-backend-stage`
+- `shopify-backend` → `/ecs/shopify-backend-stage`
 - `commerce-rq-worker` → `/ecs/commerce-rq-worker-stage`
 - `commerce-rq-scheduler` → `/ecs/commerce-rq-scheduler-stage`
+- `gateway-core` → `/ecs/gateway-core-stage`
+- `gw-admin` → `/ecs/gw-admin-stage`
+- `optima-channels` → `/ecs/optima-channels-stage`
 - `optima-logistics` → `/ecs/optima-logistics-stage`
 - `billing` → `/ecs/billing-stage`
 - `browser-backend` → `/ecs/browser-backend-stage`
 - `optima-generation` → `/ecs/optima-generation-stage`
 - `optima-generation-worker` → `/ecs/optima-generation-worker-stage`
+- `optima-sentinel` → `/ecs/optima-sentinel-stage`
+- `optima-sentinel-worker` → `/ecs/optima-sentinel-worker-stage`
 
 ### 2. Prod 环境（environment = "prod"）
 
@@ -172,13 +190,22 @@ aws logs get-log-events --log-group-name /ecs/commerce-backend-prod --log-stream
 - `session-gateway` → `/ecs/session-gateway-prod`
 - `ai-shell-web-ui` → `/ecs/ai-shell-web-ui-prod`
 - `optima-scout` → `/ecs/optima-scout-prod`
+- `ads-backend` → `/ecs/ads-backend-prod`
+- `ads-worker` → `/ecs/ads-worker-prod`
+- `amazon-backend` → `/ecs/amazon-backend-prod`
+- `shopify-backend` → `/ecs/shopify-backend-prod`
 - `commerce-rq-worker` → `/ecs/commerce-rq-worker-prod`
 - `commerce-rq-scheduler` → `/ecs/commerce-rq-scheduler-prod`
+- `gateway-core` → `/ecs/gateway-core-prod`
+- `gw-admin` → `/ecs/gw-admin-prod`
+- `optima-channels` → `/ecs/optima-channels-prod`
 - `optima-logistics` → `/ecs/optima-logistics-prod`
 - `billing` → `/ecs/billing-prod`
 - `browser-backend` → `/ecs/browser-backend-prod`
 - `optima-generation` → `/ecs/optima-generation-prod`
 - `optima-generation-worker` → `/ecs/optima-generation-worker-prod`
+- `optima-sentinel` → `/ecs/optima-sentinel-prod`
+- `optima-sentinel-worker` → `/ecs/optima-sentinel-worker-prod`
 
 **注意**: `optima-store` 仅在 Stage 环境部署
 

package/.claude/commands/query-db.md

@@ -49,8 +49,12 @@ optima-query-db commerce-backend "SELECT * FROM products LIMIT 5" prod
   - `session-gateway` - AI Shell 网关数据库
   - `optima-logistics` - 物流服务数据库
   - `billing` - 计费服务数据库
+  - `ads-backend` - Google Ads API 代理服务数据库
+  - `amazon-backend` - Amazon SP-API 集成服务数据库
   - `browser-backend` - 浏览器自动化服务数据库
+  - `shopify-backend` - Shopify 店铺管理服务数据库
   - `optima-generation` - 内容生成服务数据库
+  - `optima-sentinel` - Sentinel 自动化监控数据库
 - `sql` (必需): SQL 查询语句（用引号包裹）
 - `environment` (可选): 环境，默认 ci
   - `ci` - CI 持续集成环境（开发环境，默认）
@@ -253,18 +257,30 @@ pkill -f "ssh.*15432:${DATABASE_HOST}:5432"
   - 数据库: `optima_billing_stage`
   - 凭证: Infisical `/services/billing` → `DATABASE_URL`
 
+- `ads-backend`:
+  - 凭证: Infisical `/services/optima-ads` → `DATABASE_URL`
+
+- `amazon-backend`:
+  - 凭证: Infisical `/services/optima-amazon` → `DATABASE_URL`
+
 - `browser-backend`:
   - 数据库: `optima_stage_browser`
   - 凭证: Infisical `/services/browser-backend` → `DATABASE_URL`
 
+- `shopify-backend`:
+  - 凭证: Infisical `/services/shopify-backend` → `DATABASE_URL`
+
 - `optima-generation`:
   - 数据库: `optima_generation_stage`
   - 凭证: Infisical `/services/optima-generation` → `DATABASE_URL`
 
+- `optima-sentinel`:
+  - 凭证: Infisical `/services/optima-sentinel` → `DATABASE_URL`
+
 **说明**:
 - Infisical 配置从 GitHub Variables 获取
 - 数据库密钥从 Infisical 动态获取（项目: optima-secrets-v2, 环境: staging, 路径: /shared-secrets/database-users）
-- billing、browser-backend、optima-generation 的凭证存在各自服务路径的 DATABASE_URL 中
+- billing、ads-backend、amazon-backend、browser-backend、shopify-backend、optima-generation、optima-sentinel 的凭证存在各自服务路径的 `DATABASE_URL` 中
 - Stage RDS: `optima-stage-postgres.ctg866o0ehac.ap-southeast-1.rds.amazonaws.com`
 - Shared EC2 IP: `3.0.210.113`
 - SSH 隧道: 本地端口 `15432` → Shared EC2 → Stage RDS `5432`

package/.claude/skills/query-db/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "query-db"
-description: "当用户请求查询数据库、执行SQL、查看数据、统计数据、检查数据库、查询表、数据库查询时，使用此技能。支持 CI、Stage、Prod 三个环境的 commerce-backend、user-auth、agentic-chat、bi-backend、session-gateway 服务的数据库查询。优先使用 optima-query-db CLI 工具。"
+description: "当用户请求查询数据库、执行SQL、查看数据、统计数据、检查数据库、查询表、数据库查询时，使用此技能。支持 CI、Stage、Prod 三个环境的 commerce-backend、user-auth、agentic-chat、bi-backend、session-gateway、ads-backend、amazon-backend、shopify-backend、optima-sentinel 等服务的数据库查询。优先使用 optima-query-db CLI 工具。"
 allowed-tools: ["Bash", "SlashCommand"]
 ---
 
@@ -77,6 +77,10 @@ optima-query-db commerce-backend "SELECT status, COUNT(*) FROM orders GROUP BY s
 - `bi-backend` - BI 后端数据库
 - `session-gateway` - AI Shell 网关数据库
 - `optima-logistics` - 物流服务数据库
+- `ads-backend` - Ads 数据库
+- `amazon-backend` - Amazon 数据库
+- `shopify-backend` - Shopify 数据库
+- `optima-sentinel` - Sentinel 数据库
 
 ### 常用查询示例
 
@@ -198,6 +202,17 @@ optima-query-db commerce-backend "SELECT status, COUNT(*) FROM orders GROUP BY s
 | session-gateway | `AI_SHELL_DB_USER` | `AI_SHELL_DB_PASSWORD` |
 | optima-logistics | `LOGISTICS_DB_USER` | `LOGISTICS_DB_PASSWORD` |
 
+**服务路径 `DATABASE_URL` 映射**：
+| 服务 | Infisical 路径 |
+|------|----------------|
+| billing | `/services/billing` |
+| ads-backend | `/services/optima-ads` |
+| amazon-backend | `/services/optima-amazon` |
+| browser-backend | `/services/browser-backend` |
+| shopify-backend | `/services/shopify-backend` |
+| optima-generation | `/services/optima-generation` |
+| optima-sentinel | `/services/optima-sentinel` |
+
 ### RDS 连接
 
 | 环境 | RDS Host | 本地端口 |

package/.claude/skills/restart-ecs/SKILL.md

@@ -51,6 +51,38 @@ allowed-tools: ["Bash"]
 
 ## 环境信息
 
+## 支持的服务简称
+
+- `ads-backend`
+- `amazon-backend`
+- `agentic-chat`
+- `ai-shell-web-ui`
+- `bi-backend`
+- `bi-dashboard`
+- `billing`
+- `browser-backend`
+- `commerce-backend`
+- `commerce-rq-scheduler`
+- `commerce-rq-worker`
+- `gateway-core`
+- `gw-admin`
+- `optima-channels`
+- `optima-generation`
+- `optima-generation-worker`
+- `optima-logistics`
+- `optima-scout`
+- `optima-sentinel`
+- `optima-sentinel-worker`
+- `pgbouncer`
+- `session-gateway`
+- `shopify-backend`
+- `user-auth`
+- `user-auth-admin`
+
+仅 Stage 可用：
+
+- `optima-store`
+
 ### Stage 环境
 
 **集群名**: `optima-stage-cluster`
@@ -70,8 +102,20 @@ allowed-tools: ["Bash"]
 | optima-scout | optima-scout-stage | 产品研究工具 |
 | ai-shell-web-ui | ai-shell-web-ui-stage | Shell Web UI |
 | optima-store | optima-store-stage | 商城前端 |
-| pgbouncer | pgbouncer-stage | 数据库连接池 |
+| ads-backend | ads-backend-stage | Google Ads API 代理服务 |
+| amazon-backend | amazon-backend-stage | Amazon SP-API 集成服务 |
+| billing | billing-stage | 计费服务 |
+| browser-backend | browser-backend-stage | 浏览器自动化服务 |
+| gateway-core | gateway-core-stage | Gateway 核心服务 |
+| gw-admin | gw-admin-stage | Gateway 管理后台 |
+| optima-channels | optima-channels-stage | Channels 服务 |
+| optima-generation | optima-generation-stage | 内容生成服务 |
+| optima-generation-worker | optima-generation-worker-stage | 内容生成 Worker |
 | optima-logistics | optima-logistics-stage | 物流服务 |
+| optima-sentinel | optima-sentinel-stage | Sentinel API |
+| optima-sentinel-worker | optima-sentinel-worker-stage | Sentinel 后台任务 |
+| pgbouncer | pgbouncer-stage | 数据库连接池 |
+| shopify-backend | shopify-backend-stage | Shopify 店铺管理服务 |
 
 ### Prod 环境
 
@@ -91,7 +135,19 @@ allowed-tools: ["Bash"]
 | bi-dashboard | bi-dashboard-prod | BI 仪表板 |
 | optima-scout | optima-scout-prod | 产品研究工具 |
 | ai-shell-web-ui | ai-shell-web-ui-prod | Shell Web UI |
+| ads-backend | ads-backend-prod | Google Ads API 代理服务 |
+| amazon-backend | amazon-backend-prod | Amazon SP-API 集成服务 |
+| billing | billing-prod | 计费服务 |
+| browser-backend | browser-backend-prod | 浏览器自动化服务 |
+| gateway-core | gateway-core-prod | Gateway 核心服务 |
+| gw-admin | gw-admin-prod | Gateway 管理后台 |
+| optima-channels | optima-channels-prod | Channels 服务 |
+| optima-generation | optima-generation-prod | 内容生成服务 |
+| optima-generation-worker | optima-generation-worker-prod | 内容生成 Worker |
 | optima-logistics | optima-logistics-prod | 物流服务 |
+| optima-sentinel | optima-sentinel-prod | Sentinel API |
+| optima-sentinel-worker | optima-sentinel-worker-prod | Sentinel 后台任务 |
+| shopify-backend | shopify-backend-prod | Shopify 店铺管理服务 |
 
 **注意**: `optima-store` 和 `pgbouncer` 仅在 Stage 环境部署
 
@@ -135,6 +191,16 @@ ECS `--force-new-deployment` 的工作流程：
 /restart-ecs agentic-chat stage
 ```
 
+### 场景 4：重启内容生成与新平台服务
+
+```
+/restart-ecs optima-generation stage
+/restart-ecs optima-generation-worker prod
+/restart-ecs ads-backend prod
+/restart-ecs gateway-core stage
+/restart-ecs optima-sentinel prod
+```
+
 ## 查看重启进度
 
 重启触发后，可以查看部署状态：

package/.claude/skills/show-env/SKILL.md

@@ -50,15 +50,31 @@ optima-show-env agentic-chat stage
 ```
 
 **支持的服务**：
+- `ads-backend` - Google Ads API 代理服务
+- `ads-worker` - Ads 对账后台任务
+- `ai-shell-web-ui` - Shell Web UI
+- `amazon-backend` - Amazon SP-API 集成服务
+- `bi-backend` - BI 后端
+- `bi-dashboard` - BI 仪表板
+- `billing` - 计费服务
+- `browser-backend` - 浏览器自动化服务
 - `commerce-backend` - 电商后端 API
+- `commerce-rq-scheduler` - Commerce 定时任务
+- `commerce-rq-worker` - Commerce 后台任务
+- `gateway-core` - Gateway 核心服务
+- `gw-admin` - Gateway 管理后台
 - `user-auth` - 用户认证服务
+- `user-auth-admin` - 用户认证管理后台
 - `agentic-chat` - AI 聊天服务
-- `bi` - BI 后端
 - `session-gateway` - AI Shell 网关
+- `optima-channels` - Channels 服务
+- `optima-generation` - 内容生成服务
+- `optima-logistics` - 物流服务
 - `optima-store` - 商城前端
 - `optima-scout` - 产品研究工具
-- `mcp-host` - MCP 主机
-- `optima-logistics` - 物流服务
+- `optima-sentinel` - Sentinel API
+- `optima-sentinel-worker` - Sentinel 后台任务
+- `shopify-backend` - Shopify 店铺管理服务
 
 **支持的环境**：
 - `stage` - Stage 预发布环境
@@ -130,6 +146,17 @@ optima-show-env commerce-backend stage --filter STRIPE
 optima-show-env commerce-backend prod --filter STRIPE
 ```
 
+### 场景 5：查看新 ECS 服务配置
+
+**用户请求**："帮我看一下 ads-backend / gateway-core / optima-sentinel 的配置"
+
+**步骤**：
+```bash
+optima-show-env ads-backend stage --keys-only
+optima-show-env gateway-core prod --filter REDIS
+optima-show-env optima-sentinel prod --filter DATABASE
+```
+
 ## 环境变量分类
 
 ### 常见环境变量类型

package/bin/helpers/query-db.ts

@@ -53,15 +53,35 @@ const SERVICE_DB_MAP = {
     stage: { databaseUrlPath: '/services/billing', databaseUrlKey: 'DATABASE_URL' },
     prod: { databaseUrlPath: '/services/billing', databaseUrlKey: 'DATABASE_URL' }
   },
+  'ads-backend': {
+    ci: null,
+    stage: { databaseUrlPath: '/services/optima-ads', databaseUrlKey: 'DATABASE_URL' },
+    prod: { databaseUrlPath: '/services/optima-ads', databaseUrlKey: 'DATABASE_URL' }
+  },
+  'amazon-backend': {
+    ci: null,
+    stage: { databaseUrlPath: '/services/optima-amazon', databaseUrlKey: 'DATABASE_URL' },
+    prod: { databaseUrlPath: '/services/optima-amazon', databaseUrlKey: 'DATABASE_URL' }
+  },
   'browser-backend': {
     ci: null,
     stage: { databaseUrlPath: '/services/browser-backend', databaseUrlKey: 'DATABASE_URL' },
     prod: { databaseUrlPath: '/services/browser-backend', databaseUrlKey: 'DATABASE_URL' }
   },
+  'shopify-backend': {
+    ci: null,
+    stage: { databaseUrlPath: '/services/shopify-backend', databaseUrlKey: 'DATABASE_URL' },
+    prod: { databaseUrlPath: '/services/shopify-backend', databaseUrlKey: 'DATABASE_URL' }
+  },
   'optima-generation': {
     ci: null,
     stage: { databaseUrlPath: '/services/optima-generation', databaseUrlKey: 'DATABASE_URL' },
     prod: { databaseUrlPath: '/services/optima-generation', databaseUrlKey: 'DATABASE_URL' }
+  },
+  'optima-sentinel': {
+    ci: null,
+    stage: { databaseUrlPath: '/services/optima-sentinel', databaseUrlKey: 'DATABASE_URL' },
+    prod: { databaseUrlPath: '/services/optima-sentinel', databaseUrlKey: 'DATABASE_URL' }
   }
 };
 
@@ -209,7 +229,7 @@ async function main() {
   if (args.length < 2) {
     console.error('Usage: query-db.ts <service> <sql> [environment]');
     console.error('');
-    console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, browser-backend, optima-generation');
+    console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
     console.error('Environments: ci (default), stage, prod');
     console.error('');
     console.error('Example: query-db.ts user-auth "SELECT COUNT(*) FROM users" prod');

package/bin/helpers/show-env.ts

@@ -11,19 +11,31 @@ interface InfisicalConfig {
 
 // 支持的服务列表（Infisical 路径为 /services/<service-name>）
 const SUPPORTED_SERVICES = [
+  'ads-backend',
+  'ads-worker',
+  'ai-shell-web-ui',
+  'amazon-backend',
+  'bi-backend',
+  'bi-dashboard',
+  'billing',
+  'browser-backend',
   'commerce-backend',
+  'commerce-rq-scheduler',
+  'commerce-rq-worker',
+  'gateway-core',
+  'gw-admin',
   'user-auth',
+  'user-auth-admin',
   'agentic-chat',
-  'bi',
   'session-gateway',
+  'optima-channels',
+  'optima-generation',
+  'optima-logistics',
   'optima-store',
   'optima-scout',
-  'mcp-host',
+  'optima-sentinel',
+  'optima-sentinel-worker',
   'shopify-backend',
-  'optima-logistics',
-  'billing',
-  'browser-backend',
-  'optima-generation'
 ];
 
 // 环境到 Infisical environment 的映射

package/dist/bin/helpers/query-db.js

@@ -72,15 +72,35 @@ const SERVICE_DB_MAP = {
         stage: { databaseUrlPath: '/services/billing', databaseUrlKey: 'DATABASE_URL' },
         prod: { databaseUrlPath: '/services/billing', databaseUrlKey: 'DATABASE_URL' }
     },
+    'ads-backend': {
+        ci: null,
+        stage: { databaseUrlPath: '/services/optima-ads', databaseUrlKey: 'DATABASE_URL' },
+        prod: { databaseUrlPath: '/services/optima-ads', databaseUrlKey: 'DATABASE_URL' }
+    },
+    'amazon-backend': {
+        ci: null,
+        stage: { databaseUrlPath: '/services/optima-amazon', databaseUrlKey: 'DATABASE_URL' },
+        prod: { databaseUrlPath: '/services/optima-amazon', databaseUrlKey: 'DATABASE_URL' }
+    },
     'browser-backend': {
         ci: null,
         stage: { databaseUrlPath: '/services/browser-backend', databaseUrlKey: 'DATABASE_URL' },
         prod: { databaseUrlPath: '/services/browser-backend', databaseUrlKey: 'DATABASE_URL' }
     },
+    'shopify-backend': {
+        ci: null,
+        stage: { databaseUrlPath: '/services/shopify-backend', databaseUrlKey: 'DATABASE_URL' },
+        prod: { databaseUrlPath: '/services/shopify-backend', databaseUrlKey: 'DATABASE_URL' }
+    },
     'optima-generation': {
         ci: null,
         stage: { databaseUrlPath: '/services/optima-generation', databaseUrlKey: 'DATABASE_URL' },
         prod: { databaseUrlPath: '/services/optima-generation', databaseUrlKey: 'DATABASE_URL' }
+    },
+    'optima-sentinel': {
+        ci: null,
+        stage: { databaseUrlPath: '/services/optima-sentinel', databaseUrlKey: 'DATABASE_URL' },
+        prod: { databaseUrlPath: '/services/optima-sentinel', databaseUrlKey: 'DATABASE_URL' }
     }
 };
 // Stage 和 Prod 独立的 RDS 实例
@@ -199,7 +219,7 @@ async function main() {
     if (args.length < 2) {
         console.error('Usage: query-db.ts <service> <sql> [environment]');
         console.error('');
-        console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, browser-backend, optima-generation');
+        console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
         console.error('Environments: ci (default), stage, prod');
         console.error('');
         console.error('Example: query-db.ts user-auth "SELECT COUNT(*) FROM users" prod');

package/dist/bin/helpers/show-env.js

@@ -4,19 +4,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
 // 支持的服务列表（Infisical 路径为 /services/<service-name>）
 const SUPPORTED_SERVICES = [
+    'ads-backend',
+    'ads-worker',
+    'ai-shell-web-ui',
+    'amazon-backend',
+    'bi-backend',
+    'bi-dashboard',
+    'billing',
+    'browser-backend',
     'commerce-backend',
+    'commerce-rq-scheduler',
+    'commerce-rq-worker',
+    'gateway-core',
+    'gw-admin',
     'user-auth',
+    'user-auth-admin',
     'agentic-chat',
-    'bi',
     'session-gateway',
+    'optima-channels',
+    'optima-generation',
+    'optima-logistics',
     'optima-store',
     'optima-scout',
-    'mcp-host',
+    'optima-sentinel',
+    'optima-sentinel-worker',
     'shopify-backend',
-    'optima-logistics',
-    'billing',
-    'browser-backend',
-    'optima-generation'
 ];
 // 环境到 Infisical environment 的映射
 const ENV_MAP = {

package/package.json

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