doris-debug

Apache Doris production diagnostics router. Use when Apache Doris queries are slow, imports are failing or timing out, compaction is raising -235 errors, nodes are OOM or crashing, materialized views are not rewriting, or tablet/replica health is degraded. Routes to the appropriate doris-debug-* skill. Covers shared-nothing and cloud (storage-compute separation) deployments.

Aller à l'installation Vérifier les fichiers

Dépôt: apache/doris-skills
Dernière activité de la source: 24 juillet 2026 à 23:41
Langue détectée de SKILL.md: anglais
Étoiles: 50
Forks: 15

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install only the Agent Skill at https://github.com/apache/doris-skills/tree/main/skills/doris-debug.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/apache/doris-skills --skill doris-debug

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

34 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

name: doris-debug
description: Apache Doris production diagnostics router. Use when Apache Doris queries are slow, imports are failing or timing out, compaction is raising -235 errors, nodes are OOM or crashing, materialized views are not rewriting, or tablet/replica health is degraded. Routes to the appropriate doris-debug-* skill. Covers shared-nothing and cloud (storage-compute separation) deployments.
version: 0.3.0

# Doris Debug Router ## How to use 1. Identify the symptom domain from the table below. 2. Read `shared/references/01-common-commands.md` for diagnostic SQL and API commands. 3. Read `shared/references/02-source-map.md` to map symptoms to Apache Doris source code locations. 4. Open the target skill (`<domain>/SKILL.md`) and follow its cause table and decision tree. 5. Check `shared/references/03-case-index.md` for matching production case patterns. ## Skill routing | Symptom | Skill | |---------|-------| | Slow / timeout / hanging query, Profile analysis, Exchange WaitForData | `query/SKILL.md` | | Stream Load / Broker Load / Routine Load failure, Group Commit WAL pile-up | `import/SKILL.md` | | -235 / too many versions, compaction score high, compaction lag | `compaction/SKILL.md` | | BE/FE OOM, crash, false Alive, memory leak | `node/SKILL.md` | | Sync MV miss, async MTMV refresh/rewrite issues | `materialized-view/SKILL.md` | | Tablet replica missing, clone backlog, disk skew, tablet repair | `tablet/SKILL.md` | | FE/BE startup failure, port conflict, priority_networks misconfig | `deployment/SKILL.md` | | Hive/Iceberg/Paimon/Glue catalog query failure, metadata refresh, S3/HDFS connectivity | `data-lake/SKILL.md` | | Workload Group queue starvation, CPU/memory isolation leaks, spill issues | `resource-isolation/SKILL.md` | | Storage-compute separation, meta-service latency, file cache, warmup | `cloud/SKILL.md` | ## Shared references | Document | Content | |----------|---------| | `shared/references/01-common-commands.md` | Diagnostic SQL, HTTP API, and CLI commands | | `shared/references/02-source-map.md` | Symptom → Doris source code mapping (with version annotations) | | `shared/references/03-case-index.md` | 45 production case summaries across 8 domains | | `shared/references/04-metrics-guide.md` | Per-domain key metrics with thresholds | | `shared/references/05-config-quick-ref.md` | Per-domain key configuration parameters with tuning guidance | | `shared/guides/` | Cross-module cascade troubleshooting | ## Companion skills - `doris-profile-reader`: Deep Profile analysis for query bottlenecks (referenced by `query/SKILL.md` Cause C — BE compute bottleneck). - `doris-best-practices`: Preventive table design and configuration guidance. - `doris-architecture-advisor`: Workload-aware architecture decisions. ## Methodology 1. Client → FE → BE → Disk/Network top-down investigation 2. Logs / Metrics / Profile / `SHOW PROC` evidence first 3. Stop the bleeding (throttle, kill, `reset_rpc_channel`) before root cause 4. Verify hypotheses against Doris source code (`02-source-map.md`) 5. Match known case patterns (`03-case-index.md`) to avoid rediscovery

Voir sur GitHub

Retour à la recherche Retour à l’installation

develop-with-evidence

Improve completeness, correctness, and trustworthiness throughout coding and before a pull request. Use for feature/API implementation, bug fixes, refactoring, performance optimization, frontend work, test/CI changes, dependency/configuration updates, migrations, or checking an existing patch. Select proportional verification, test the tests when warranted, and connect final claims to the actual code. Leaves an English handoff file (a PR description draft plus the facts and evidence behind it, which the PR step takes as given). Trustworthy development and a pre-PR self-review: the main agent makes every judgment, code change, and conclusion, and may hand evidence gathering to subagents; work after the PR is published is out of scope.

2026-11-04

doris-pr-description

Write, rewrite, or check the title and description of an Apache Doris pull request against the Doris PR standard. Takes the facts from the handoff file that development left when there is one, and collects them from the diff, commits, linked issue, and existing tests otherwise; classifies the PR type, fills that type's required fields, drafts the issue a Feature needs, validates the draft with a bundled checker, and creates or updates the PR on GitHub only after the user confirms. Use whenever the user wants to open, create, submit, or update a Doris PR; write, fix, or improve a PR title or description; prepare a branch for review; rewrite an existing PR's description for comparison; or check whether a description meets the standard. Also use for short requests in any language, such as "open a PR", "write the PR description", or "is this PR description good enough?", even when the standard is not mentioned.

2026-11-04

doris-repo-review

Review an Apache Doris PR from a local clone with the same multi-agent, shared-ledger convergence workflow as the CI Code Review Runner. Use when the user supplies a PR to `/doris-repo-review`, asks to review a Doris PR locally, or asks for the CI-style review flow. Safely align only the current worktree to the exact PR head, refuse to disturb tracked local changes, write equivalent English and Chinese review documents with verified path-line anchors, and never build, test, or edit source. Treat a review as pipeline-equivalent only when an explicitly selected qualified reviewer uses a supported effort (xhigh or max, plus ultra for Codex), preferring GPT-6 Astra on Codex and Fable 5.1 on Claude Code. After a converged APPROVE result, automatically post one machine-readable PASS comment bound to the reviewed commit.

2026-09-30

Tout voir dans ce dépôt

doris-debug

Informations de source

Options d'installation

Installer avec un assistant IA

Vérifiez les fichiers source

Plus depuis ce dépôt

Installer avec un assistant IA

Plus depuis ce dépôt