メニュー
Run Volatio CI locally before pushing (ci-local.sh), mirrors GitHub Actions exactly, catches failures fast. Use when preparing to push, debugging CI failures, or verifying changes will pass.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | ci-local-parity |
| description | Run Volatio CI locally before pushing (ci-local.sh), mirrors GitHub Actions exactly, catches failures fast. Use when preparing to push, debugging CI failures, or verifying changes will pass. |
You MUST run ./scripts/ci-local.sh and wait for completion before ANY git push.
Do NOT:
# Run full CI pipeline locally
./scripts/ci-local.sh
# Wait for: "✓ CI WOULD PASS - SAFE TO PUSH"
git push
# Full CI (mirrors GitHub Actions exactly)
./scripts/ci-local.sh
# Quick mode (skip E2E tests - for fast iteration)
./scripts/ci-local.sh --quick
# E2E tests only (when you know lint/types pass)
./scripts/ci-local.sh --e2e-only
# Skip Python checks (if no Python changes)
./scripts/ci-local.sh --no-python
# Makefile shortcuts
make ci # Full CI
make ci-quick # Skip E2E
make ci-e2e # E2E only
postgres:16 (NOT TimescaleDB) - schema issues show up here# Run Biome check locally
pnpm lint
# Auto-fix
pnpm lint:fix
# Run typecheck
pnpm typecheck
# Run unit tests with --run (not watch mode!)
pnpm test -- --run
# Ruff check
cd research && ruff check .
# Pytest
cd research && pytest
# Run specific failing test - ALWAYS use --reporter=list to prevent hang!
./scripts/e2e.sh e2e/failing-test.spec.ts --timeout=60000 --reporter=list
Tests can hang silently without proper flags:
# ❌ HANGS FOREVER - watch mode with no output
pnpm test
./scripts/e2e.sh # (no --reporter=list)
# ✅ EXITS CLEANLY
pnpm test -- --run
./scripts/e2e.sh --reporter=list
./scripts/ci-local.sh # (handles this internally)
If a command produces no output for 30+ seconds, it's probably hung. Kill it and use correct flags.
If ALL auth tests fail (auth.spec.ts, server-health.spec.ts, auth.setup.ts), check:
admin@volatio.io must existThe ci-local.sh script handles all these, but manual test runs might miss them.
docker compose pspnpm --filter @volatio/db push./scripts/e2e.sh handles thismake kill-serversrm -rf apps/dashboard/.nextMarket data integrity rules — gap filling, look-forward bias prevention, and stock split handling. Use when writing or reviewing code that loads prices, fills missing data, computes returns, backtests strategies, or makes trading decisions. Applies across Python, TypeScript, SQL, and TimescaleDB.
Analyze Volatio debug logs from /tmp/volatio-debug/. Use when the user asks to check debug logs, analyze problems, or diagnose simulation issues.
Apply bottom-up systematic testing to a multi-layer system. Use when asked to test, debug, or verify a pipeline that spans multiple layers (e.g., Python worker → bridge → processor → API → UI).
Drizzle Kit workflow for Volatio using idempotent migrations (generate + edit + migrate), never use push. Idempotent patterns prevent partial failure issues, enable safe re-runs, and work cleanly in CI. Use when schema changes, migration errors, or database sync issues occur.
Template for creating Volatio research experiments with Optuna optimization and portfolio backtesting. Includes proper train/test splits, lookahead bias prevention, results saving, and validated patterns from Exp 051-053.
Financial research look-ahead bias verification for Volatio ML pipelines, mandatory baseline comparisons, timezone handling, feature leakage detection. Use when model accuracy seems too good or validating prediction experiments.