菜单
Use when checking whether the data + model pipeline is healthy, when returning to the project after time away, or when a workflow looks stuck. Runs the read-only health snapshot and triages any breach.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/metill-is/sports --skill pipeline-doctor命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Use during a World Cup tournament when the published forecast is missing scores martj42 hasn't logged yet — the manual overlay refresh that pulls, ingests, re-fits, re-forecasts and pushes. Also covers how played knockouts condition the forecast and how knockout fixture dates are corrected at ingest.
Use when Lengjan has started listing a league we already model and a discovery proposal needs turning into a config edit. Reads data/discovery/proposals.json, drafts the leagues.yml competition entry + team_names, verifies via a dry decide, and presents the diff for review.
Use when adding a new league to the monorepo. Walks through leagues.yml, Stan model, ingest source, team_names invariant, and verification.
正在显示 SKILL.md
基于 SOC 职业分类
| name | pipeline-doctor |
| description | Use when checking whether the data + model pipeline is healthy, when returning to the project after time away, or when a workflow looks stuck. Runs the read-only health snapshot and triages any breach. |
| argument-hint | [--refresh] |
Strictly read-only on the money path — never places bets, never writes the
ledger. It composes pipeline_health() (fit/odds freshness, persisted Stan
diagnostic drift, orphaned bets, bankroll/drawdown) into a single status table
and helps triage anything that is WARN or FAIL.
cd /Users/brynjolfurjonsson/sports && Rscript scripts/07_healthcheck.R
This prints the per-check table, lists the breaches, and writes
data/health/status.json (overall status OK < WARN < FAIL, plus PAUSED
for an off-season cell). It always exits 0 — it is observability, not a gate.
# Recent data commits — did the crons actually run?
git -C /Users/brynjolfurjonsson/sports log --oneline -8 -- data/
# Recent CI runs and their conclusions (needs gh + a GitHub remote)
gh run list --repo metill-is/sports --limit 12
For every WARN/FAIL row, map the check to its runbook in
docs/runbooks/ and follow the symptom → diagnose → fix → verify steps:
| check | likely cause | runbook |
|---|---|---|
odds_freshness FAIL | Lengjan scrape failing or off-season | docs/runbooks/stale-odds.md |
fit_freshness FAIL/WARN | fit.yml failing, or results not moving | docs/runbooks/failed-fit.md |
divergence_drift / rhat_drift WARN | model degrading under the abort gate | docs/runbooks/failed-fit.md |
orphaned_bets WARN | a bet whose match never settled | docs/runbooks/orphaned-bet.md |
bankroll FAIL | realised PnL ran the pool to/under zero | docs/runbooks/orphaned-bet.md |
check_error | a health sub-check itself errored | inspect the message; usually a missing/corrupt partition |
Confirm-intent before "fixing": a PAUSED cell (basketball/handball off-season)
and the schedule fail-open are intentional — surface them, do not treat
them as faults.
Health is checked on demand (this skill), as a twice-daily cron
(healthcheck.yml), and via a cheap SessionStart banner that reads the
committed status.json. A PostToolUse-after-fit hook was deliberately
rejected: the Stan abort gate already blocks a bad fit synchronously, so such a
hook would add always-on cost for no marginal signal.