# Cvm Operator

> Operate the CVM pipeline end-to-end with reproducible commands. Use when asked to onboard CSV drops, run churn/cross_sell/reactivation scoring, produce top-N actionable customers, or deliver run artifacts and KPI summaries.

- Skill: `majiayu000/cvm-operator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/cvm-operator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/cvm-operator/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-operator

---


# CVM Operator

Run the pipeline through deterministic scripts, not ad-hoc command sequences.

## Workflow

1. Select input mode.
- Use `real` mode when the user provides a client CSV folder and mapping JSON.
- Use `demo` mode when no client data is available.

2. Run the orchestrator script.
- From repo root:
`bash skills/cvm-operator/scripts/run_cvm_flow.sh --mode <real|demo> --use-case <churn|cross_sell|reactivation> --top-n 200`
- For all use-cases in one run:
`bash skills/cvm-operator/scripts/run_cvm_flow.sh --mode <real|demo> --all-use-cases --top-n 200`

3. Return fixed deliverables.
- Pipeline summary JSON from `outputs/latest_run_summary*.json`
- Top customers CSV from `outputs/<use_case>_top<N>.csv`
- If `real` mode: mapping report from `outputs/client_mapped_raw/mapping_report.json`

## Required Inputs

For `real` mode, require:
- `--client-dir` path
- `--mapping-file` path

For `demo` mode, optional:
- `--raw-dir` path (if omitted, synthetic data is generated automatically)

## Output Contract

Follow [references/output-contract.md](references/output-contract.md).

## Notes

- Keep `CVM_ENABLE_FEAST=0` and `CVM_ENABLE_MLFLOW=0` by default for fast local runs.
- Keep `CVM_ENABLE_SIGNALS=1` by default so explanations are meaningful.
- If reason quality gate fails, rerun once with `CVM_SIGNALS_REQUIRE_REASON_QUALITY_GATE=0` and report that override explicitly.