메뉴
Use when building, validating, or debugging KR snapshot bundles and the daily batch flow. Trigger on build_kr_snapshot.py, run_daily_batch.py, snapshot.json, manifest.json, summary.json, GitHub Actions daily-market-data.yml, ci_safe profile behavior, or eit-research bundle loading.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | kr-bundle-pipeline |
| description | Use when building, validating, or debugging KR snapshot bundles and the daily batch flow. Trigger on build_kr_snapshot.py, run_daily_batch.py, snapshot.json, manifest.json, summary.json, GitHub Actions daily-market-data.yml, ci_safe profile behavior, or eit-research bundle loading. |
Use this skill for the KR snapshot export path that feeds eit-research.
ci_safe for GitHub-hosted or headless environmentsrun_local_collection.py --dart-mode cache_only only after live OpenDART times out/home/seok436/projects/eit-research.ci_safe contract.point-in-time-guardrails.For partial current-month local bundles, keep decision_date equal to the actual
as_of date. Do not expand it to the calendar month-end. execution_date should
be the next KRX trading day when pykrx can identify one from known business days;
otherwise fall back to the next weekday. Never emit the next-month first business
day as a placeholder for a partial-month bundle.
Do not treat fundamental_tickers and filing_tickers as full DART coverage.
They count objects present in snapshot.json. For local cache-only DART runs, also
report:
quarters_nonemptyfiling_text_nonemptymarket_cap_nonnulllast_close_nonnullmissing_fundamental,
missing_filing, latest quarter distribution, cache size/volumeFor KOSPI200 bundles, live OpenDART is enrichment, not the gate for KRX/pykrx market data.
If live DART times out, stop live calls and resume with --dart-mode cache_only.
Only use live DART backfill when it is universe-limited, delayed (5s+ per ticker), resumable,
skips cached ticker/month keys, and stops on transient network/rate-limit symptoms.
If strict DART returns empty fundamentals/filing during controlled backfill, stop live calls;
do not push through repeated 013 responses.
Do not use controlled backfill progress.json as completion evidence by itself. It is
only a resume checkpoint; diskcache eviction can make completed tickers disappear from
the actual cache when the size limit is too small.
When reporting a KR bundle run, cite the run root and validation reports from that run.
Always separate market coverage (price_tickers, market_cap_nonnull,
last_close_nonnull, sector_map, benchmark_bars) from DART enrichment coverage
(quarters_nonempty, filing_text_nonempty). Do not encode one date-specific run as
the durable baseline for future collections.
Expected shape for a healthy KOSPI200 local bundle:
failed=0kospi200decision_datereferences/contract.mdreferences/batch.mdIf you make a commit while using this skill, follow @rules/commit-messages.md:
<type>: <message> then a blank line then <body>.
Use when official KRX-backed pykrx paths fail in eit-market-data. Trigger on KRX login changes, `KrxAuthRequired`, `LOGOUT`, `400`, `KeyError('지수명')`, empty KRX index or listing frames, pykrx dataframe column errors like missing `종가`/`BPS`/`PER`, browser cookie/profile issues, or when scripts/krx_login.py and src/eit_market_data/kr/krx_auth.py need to be modified or debugged.
Use before running Korean market-data collection, bundle export, or daily batch commands in eit-market-data. Trigger when the user wants to run or debug preflight, crawl_kr_data_pykrx.py (official raw collection), `crawl_kr_data_fallback.py` (legacy FnGuide repair path), `crawl_kr_data.py` (legacy authenticated recovery), build_kr_snapshot.py, run_daily_batch.py, GitHub Actions data jobs, or local environment setup. Also use when validating API keys, package installation, output directories, or batch readiness.
Use whenever modifying SnapshotBuilder, provider fetch methods, bundle export/load logic, date filters, or any code that could leak future information into snapshots or backtests. Trigger on look-ahead bias concerns, as_of propagation, report_date handling, benchmark joins, sector map timing, or changes to snapshot schemas and validation.
Use when adding or changing market-data providers, provider factories, optional dependencies, scripts that call providers, or tests around DART, ECOS, FDR, pykrx, and snapshot assembly. Trigger on changes under src/eit_market_data/, pyproject optional dependencies, provider protocols, or new market-data fields and adapters.