# Cvm Troubleshooter

> Diagnose and unblock CVM pipeline failures quickly. Use when ingest, dbt, train, score, e2e, or drift commands fail; when outputs are missing; or when reason quality/feature availability issues appear.

- Skill: `majiayu000/cvm-troubleshooter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/cvm-troubleshooter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/cvm-troubleshooter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/cvm-troubleshooter

---


# CVM Troubleshooter

Collect diagnostics first, then propose the smallest rerun.

## Workflow

1. Collect diagnostics using the bundled script.
- `bash skills/cvm-troubleshooter/scripts/collect_diagnostics.sh`

2. Classify failure by stage.
- Ingestion failures: raw data path, missing `raw_*.csv`, mapping errors.
- Prepare-data failures: dbt binary/path, dbt test failures, mart contracts.
- Train failures: missing target columns, empty training marts, model backend deps.
- Score failures: missing decision queue, missing signal tables, reason quality gate.

3. Propose exact fix + rerun command.
- Do not propose broad changes. Give one minimal change and rerun only affected stage.

4. Return a concise incident report.
- include root cause, fix, and verification output path.

## Playbook

Use [references/failure-playbook.md](references/failure-playbook.md).