---

类型：README 描述：星岩集群诊断与故障排除技能

星岩调试技能

星岩集群诊断和故障排除技能系统。

概述

该技能系统化了故障排查经验，帮助为集群问题提供结构化的调查指导，涵盖常见生产问题，并从症状到根本原因的完整调查路径。

目录结构

每个技能目录包含：

• SKILL.md — 结构化故障排除指令（主要入口）
• 参考文献/ — 按技能分类的参考文档和案例研究
• 脚本/ — 技能专用辅助脚本（仅限查询/、节点/、cpu-saturation/）

技能类别

---

type: readme description: StarRocks cluster diagnostics and troubleshooting skill

starrocks-debug-skills

StarRocks cluster diagnostics and troubleshooting skill system.

Overview

This skill systematizes troubleshooting experience to help provide structured investigation guidance for cluster issues, covering common production problems with complete investigation paths from symptom to root cause.

Directory Structure

starrocks-debug-skills/
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── guides/                     # Cross-skill cascade guides
│   ├── cascade-cluster-degradation.md
│   └── cascade-import-rpc-failed.md
├── references/                 # Shared commands used across all skills
│   └── 01-common-commands.md
├── scripts/                    # Utility scripts
│   ├── install.sh              # Install skills to IDEs
│   ├── skill_converter.py      # Verify structure, convert to IDE formats
│   └── analyze_logs.py         # Audit log analysis script
├── query/                      # Query troubleshooting
│   ├── SKILL.md
│   ├── references/
│   │   ├── 02-profile-and-sql-toolkit.md
│   │   ├── 03-statistics-index.md
│   │   └── case-014-scan-skew.md
│   └── scripts/
│       └── analyze_logs.py
├── import/                     # Import troubleshooting
├── node/                       # BE/FE node issues
├── materialized-view/          # MV troubleshooting
├── data-lake/                  # External catalog issues
├── shared-data/                # Shared-data (lake-mode) architecture
├── tablet/                     # Tablet health issues
├── deployment/                 # FE/BE startup and configuration
├── high-concurrency/           # High QPS optimization
├── resource-isolation/         # Resource groups and query queues
├── balance/                    # Tablet scheduler and cluster balance
├── compaction/                 # Compaction issues
├── cpu-saturation/             # CPU triage and attribution
├── .claude/
├── .cursor/
└── .idea/

Each skill directory contains:

• SKILL.md — Structured troubleshooting instructions (main entry point)
• references/ — Per-skill focused reference docs and case studies
• scripts/ — Skill-specific helper scripts (query/, node/, cpu-saturation/ only)

Skills Categories