菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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 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.
| name | provider-maintenance |
| description | 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. |
Use this skill for provider evolution work in eit-market-data.
.env before importing/calling pykrx helpers.KRX_ID/KRX_PW can surface as dataframe column errors, not only as explicit auth errors.crawl_kr_data_pykrx.py reports missing 종가, BPS, PER, or KeyError('지수명'),
verify auth/session loading before editing normalizers.DartProvider를 테스트할 때 실제 API를 반복 호출하지 않는다.
SyntheticProvider 또는 diskcache 시드 데이터로 대체한다CacheOnlyDartProvider / --dart-mode cache_only로 전환한다.universe 제한 + 5s+ delay + cached ticker skip + progress/resume + transient 즉시 중단이 있어야 한다.DART fundamentals returned empty가 나오면 반복 013 가능성이 있으므로
live 호출을 중단한다.DART filing returned empty는 filing_empty로 기록하고 계속한다.
재무제표 cache coverage를 filing text section 추출 실패 때문에 막지 않는다.[첨부정정]사업보고서가 document API에서 014를 반환하면 같은 as_of 이전의 다음
retrievable 사업보고서로 fallback한다. 이때 실제 filing_date freshness를 보고한다.014를 filing 결측으로 바로 분류하지 않는다. report 후보 목록과 doc:<rcept_no> cache를
확인하고 fallback 후보가 없는 경우에만 실제 결측으로 본다.EIT_DART_CACHE_SIZE_LIMIT_BYTES로 조정한다.@rules/dart-api-limits.mdreferences/provider-map.md../kr-bundle-pipeline/SKILL.md../point-in-time-guardrails/SKILL.mdIf you make a commit while using this skill, follow @rules/commit-messages.md:
<type>: <message> then a blank line then <body>.