메뉴
Use when running backtests, debugging engine crashes, working with BacktestEngine lifecycle, or encountering segfaults and LogGuard panics. Covers engine setup sequence, result extraction, and C extension isolation.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | nautilus-engine-patterns |
| description | Use when running backtests, debugging engine crashes, working with BacktestEngine lifecycle, or encountering segfaults and LogGuard panics. Covers engine setup sequence, result extraction, and C extension isolation. |
Full reference:
docs/agent/nautilus.md
set_nautilus_log_guard() in src/utils/logging.py. Never let it go out of scope. See docs/agent/nautilus.md for details.run() — create a new instance each time.--forked. Always double gc.collect() after engine disposal.Violations cause cryptic errors. Must follow this exact order:
config = BacktestEngineConfig(trader_id=TraderId("BACKTESTER-001"))
engine = BacktestEngine(config=config)
# 1. Add venue FIRST
engine.add_venue(venue=venue, oms_type=OmsType.HEDGING,
account_type=AccountType.MARGIN, starting_balances=[Money(1_000_000, USD)],
fill_model=fill_model, fee_model=fee_model)
# 2. Add instrument (venue must exist)
engine.add_instrument(instrument)
# 3. Add data
engine.add_data(bars)
# 4. Add strategy (last)
engine.add_strategy(strategy=strategy)
# 5. Run
engine.run()
analyzer = engine.portfolio.analyzer
stats_returns = analyzer.get_performance_stats_returns()
stats_pnls = analyzer.get_performance_stats_pnls(currency=USD)
# Key metrics
sharpe = stats_returns.get("Sharpe Ratio (252 days)")
sortino = stats_returns.get("Sortino Ratio (252 days)")
profit_factor = stats_returns.get("Profit Factor")
total_pnl = stats_pnls.get("PnL (total)")
# Account and trades
account = engine.cache.account_for_venue(venue)
final_balance = float(account.balance_total(USD).as_double())
closed_positions = engine.cache.positions_closed()
positions_report = engine.trader.generate_positions_report()
venue = Venue("SIM") # mock data
venue = bars[0].bar_type.instrument_id.venue # real data (e.g., "NASDAQ")
The venue must match between instrument, bars, and engine setup.
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
Use when loading market data, working with the Parquet catalog, fetching from IBKR, converting CSV data, or diagnosing data availability issues. Covers the DataCatalogService API, catalog structure, and IBKR client configuration.
Use when diagnosing segfaults, test failures, data issues, or engine crashes. Covers LogGuard panics, C extension state leaks, common error messages with fixes, and debugging commands.
Use when writing tests, choosing test tiers, using test fixtures, or following TDD workflow. Covers the test pyramid (unit/component/integration/e2e), available test doubles, fixture catalog, and market scenarios.
Use when creating a new trading strategy, modifying strategy logic, adding indicators, or working on position sizing. Covers the 4-file registration pattern, on_bar() flow, and Nautilus indicator gotchas.
Use when adding web UI pages, API endpoints, chart routes, or working with HTMX/Jinja2 templates. Covers the FastAPI app structure, router registration, HTMX patterns, and Tailwind CSS build process.