# Cvm AI Doctor

CVM 实例健康诊断,采用智能快速/深度检查模式。涵盖性能和使用问题专业检查、诊断、和修复。支持服务器、PC、虚拟机、容器场景，支持 Linux/macOS/Windows。

- Repository: https://github.com/TencentCloud/Octop (11420 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TencentCloud/Octop --skill cvm-ai-doctor -g -a claude-code -y`
Codex: `npx skills add TencentCloud/Octop --skill cvm-ai-doctor -g -a codex -y`
Cursor: `npx skills add TencentCloud/Octop --skill cvm-ai-doctor -g -a cursor -y`
Gemini CLI: `npx skills add TencentCloud/Octop --skill cvm-ai-doctor -g -a gemini-cli -y`

## Description

CVM 实例健康诊断,采用智能快速/深度检查模式。涵盖性能和使用问题专业检查、诊断、和修复。支持服务器、PC、虚拟机、容器场景，支持 Linux/macOS/Windows。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# CVM AI Doctor 技能

**用途**: 智能诊断系统各类性能问题和使用问题,采用快速检查(10秒分诊)→ 深度分析(20-60秒)工作流。

**支持系统**: 本地服务器、个人计算机(Mac/Windows/Linux)、虚拟机、容器。

---

## 🎯 何时使用此技能

**核心能力**:
- 系统性能诊断(CPU、内存、磁盘、网络)
- 健康检查(快速扫描、综合分析)
- 系统故障排查(崩溃、错误、慢、卡)
- 性能优化建议
- **集群管理**：多节点健康巡检、评分、关联分析、风险门控修复（需配合 `tencentcloud-infra` 技能）

**触发关键词**: 详见"Tier 1 核心场景"中的完整关键词列表

**注意**: 如果用户提到"LightClaw 自检"或"平台体检"或"安全检查",请使用 `health-check` 技能。

**注意**: 如果用户提到"集群"、"所有节点"、"所有CVM"，使用集群管理场景，需同时加载 `tencentcloud-infra` 技能。

### 🌐 远程服务器

- 用户提到 **IP 地址**或**远程主机** → 结合 `remote-connect` 技能使用(详见"远程诊断"章节)

---

## 🚀 快速/深度诊断工作流

两阶段诊断方法:

```yaml
快速模式 (3-10秒):
  - 快速扫描所有组件
  - 执行策略:
      优先: 执行快速扫描脚本 (如果存在) → ~3秒
        - Windows: pwsh scripts/quick_scan.ps1
        - Linux/macOS: bash scripts/quick_scan.sh
      回退: 读取 resource-saturation-quick.md → 运行单独命令 → ~10秒
  - 返回: 每个组件的 OK / WARNING / CRITICAL 状态
  
深度模式 (20-60秒, 按需触发):
  - 单组件: 只分析标记组件
  - 多组件: 使用组合关联分析
  - 根本原因分析 + 建议

决策规则:
  - 通用问题 ("慢", "卡") → 先快速扫描,再对标记组件深度分析
  - 特定组件 ("CPU高") → 跳过快速,直接深度分析
  - 多个异常 (2+ 个标记) → 使用深度组合分析
  - 健康检查 → 仅快速扫描,全部 OK 则停止
```

---

## 🔍 场景匹配

### Tier 1: 核心场景 (80% 覆盖率)

优先匹配以下场景:

```yaml
系统慢/卡 (System Slow):
  keywords: [慢, 卡, slow, lag, 响应慢, sluggish, 性能问题, performance issue, 性能故障, performance problem]
  workflow: 快速扫描 → 对标记组件深度分析
  fixes: [commands/debugging/diagnose-slowdown.md, commands/system-health/review-startup-services.md]

CPU 高 (High CPU):
  keywords: [CPU, cpu高, cpu 100%, CPU满]
  workflow: 直接使用 resource-saturation-deep-cpu.md
  fixes: [commands/hardware/hardware-profilers/by-component/profile-cpu.md]

内存不足 (Low Memory):
  keywords: [内存, memory, OOM, swap, 内存不足]
  workflow: 直接使用 resource-saturation-deep-memory.md
  fixes: [commands/hardware/hardware-profilers/by-component/profile-ram.md]

The rest: https://github.com/TencentCloud/Octop/blob/HEAD/src/octop/infra/agents/experts/library/cvm-ai-doctor/skills/cvm-ai-doctor/SKILL.md