diagnose-with-subagents

What problem does it solve?

This Skill eliminates the risk of accidental system mutations and inefficient manual investigation during incident diagnosis for CI systems, Kubernetes clusters, and TiDB/TiKV/PD database environments, enabling fast, safe root cause analysis.

Core Features & Use Cases

• Orchestrated Subagent Workflow: Parent agent coordinates fresh isolated read-only subagents to investigate independent diagnostic lanes, then synthesizes all evidence into a single unified diagnosis.
• Strict Read-Only Guardrails: Built-in safeguards explicitly forbid mutation commands, database writes, file edits, and unbounded data scraping to prevent accidental state changes during troubleshooting.
• Use Case: When a TiDB import job is stuck reporting region miss errors, this skill coordinates parallel subagents to investigate TiDB operation status, PD region metadata, TiKV store health, and job provenance without modifying any cluster or database state.

Quick Start

Use the diagnose-with-subagents skill to investigate why the tc1-tidb-0 import checksum is stuck and reporting region miss errors, using the KUBECONFIG file at kubeconfig.yml and ensuring no system state is modified during the investigation.