Communitygithub.com

公开投资组合挑战

强制性的飞行前合约检查(阶段S0),必须在信任NexusTrade的认证引擎用于任何策略工作之前通过。在比拼或认证活动开始时使用,以证明行走前向引擎端到端运行、窗口不泄露、折叠赢家持续存在,并且引擎不会为已退市或未上市的名称捏造数值。每次检查都有“停止并报告”故障模式;这些运行不计入任何认证最低要求。

公开投资组合挑战 是什么?

此技能(austin-starks/Public-Portfolio-Challenge)是NexusTrade平台中认证引擎的强制性阶段S0合约检查集。它包含四项核心验证,确保在开展任何策略设计前引擎值得信赖:行走前向扫描冒烟测试验证端到端运行、窗口保真度确认无数据泄露、折叠赢家持久化检查其对象化存储,以及已退市/未上市名称处理确保不捏造数据。每次检查失败都会触发“停止并报告”的故障模式,表明引擎存在根本性缺陷(即bug协议),所有下游结果均不可信。这些检查运行不计入认证最低次数,属于基准测试性质。该技能适用于Claude Code、Cursor等AI编程助手,通过严格的合约检查保障策略开发流程的完整性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/austin-starks/Public-Portfolio-Challenge/tree/HEAD/skills/engine-sanity

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

引擎健全性检查(阶段S0)

强制;阻止一切。 四项合约检查,证明认证引擎在任何设计工作之前是值得信赖的。每项检查都有“停止并报告”故障模式——此处的失败意味着引擎本身存在缺陷(bug协议),任何下游数据都不可信。这些S0运行(以及S1基准评分)明确不计入认证机构的最低要求——它们是合约检查和基准测试,而非候选认证。

四项检查

  1. 行走前向扫描冒烟测试。 使用create_portfolio创建一个简单投资组合(例如SPY > SMA50)。运行run_walk_forward_study,参数为mode:"validation"、fold_count:2、engine_kind:"sweep"、一个gene_intent × 3个值、certification:false。它必须启动并完成,提供每个折叠的样本外(OOS)及汇总结果。 证明:认证引擎确实端到端运行。

  2. 窗口保真度(一个折叠)。 对材料化的折叠赢家在其验证和OOS窗口上进行回测;该折叠的validationStatistics/oosStatistics必须在舍入误差内与独立回测结果匹配。确认不相交性:训练∩验证、训练∩OOS、验证∩OOS均为空,且OOS在验证结束后开始。 证明:行走前向窗口化没有泄露。

  3. 持久性。 get_walk_forward_study_results为每个完成的折叠返回真实的selectedChatPortfolioId。 证明:折叠赢家材料化为可检查/部署的真实对象。

  4. 已退市名称处理。 对完整宇宙进行小规模2022窗口回测,其中包括当时尚未上市的名称(例如SNDK)。**通过:**该名称不存在,或出现在“尚未上市”拒绝列表中,且没有捏造的报价/指标值。**失败:**引擎报错,或对未交易的名称返回任何非空读数。 证明:引擎不会为未上市名称捏造数据。

失败时

任何S0检查失败 → 停止,提交bug协议交接文档,并且不继续执行设计工作。 引擎损坏会使所有下游工作无效;在此基础上认证策略毫无意义。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

austin-starks/Public-Portfolio-Challenge

Build alternative-data custom indicators on NexusTrade (Reddit/WSB mentions, congressional disclosures, insider filings, news-flow) and wire them into a certified book as a rank/tilt/filter signal. Use when adding alt-data to a strategy, building a CustomIndicator via compute sessions, auditing lookahead safety or per-ticker coverage, or deciding whether a data series is dense enough to drive a rank. Covers the compute-session workflow, the sparse-series rule, and source recipes (see references/). Invoke with the NexusTrade MCP connected.

austin-starks/Public-Portfolio-Challenge

Measure a NexusTrade options book's TRUE participation at a fixed cold-start capital base, defeating the compounded-NAV breadth illusion. Use whenever a book's headline \"holds N/21 names\" needs validating, when a live book collapses to a single name (the OSCR trap), when checking whether a SelectTop / per-name-allocation / total-budget change degraded simultaneous participation, or when a certification needs a breadth gate. Uses audit_backtest_breadth at held-fixed $25k.

austin-starks/Public-Portfolio-Challenge

The \"loudly declare\" protocol for platform, engine, or data bugs during a NexusTrade certification campaign — bugs are a first-class deliverable, not something to route around. Use whenever a NexusTrade tool errors, hangs, or returns numbers that contradict the config; whenever you're tempted to write \"probably an engine quirk\"; or when a discovered bug invalidates prior backtests and results must be quarantined. Includes the bug hand-off doc template (see references/BUG_TEMPLATE.md).

austin-starks/Public-Portfolio-Challenge

The GATED deploy + cleanup flow for a NexusTrade live book — clone the finalist, preview a delta reconcile, stage UNAPPROVED orders, verify fills. Use ONLY after the human explicitly says \"deploy + clean up\" and names a finalist. Covers the clone-before-reconcile ordering, the single-tick reconcile expectation, stale-pending-order hygiene, the signal-freshness gate, and why you can never approve orders yourself. Nothing here runs during certification.

austin-starks/Public-Portfolio-Challenge

The single-touch lockbox — a final anti-overfitting holdout run once, after design freeze, on a window held out from every fold, sweep, and search. Use when finalizing a bakeoff winner before deploy, setting up the A/B/C baselines as OOS bars, or running the S1.5 gate-coherence auto-relax. Covers why looking at the lockbox twice burns it, the lockbox pass conditions, and the three baselines. The lockbox is distinct from the walk-forward OOS folds.

austin-starks/Public-Portfolio-Challenge

The hard structural constraints for the Public Portfolio Challenge momentum-LEAP options book — the spread-shape rule, the take-profit convexity-cap footgun, the affordability ladder, and the known losers not to re-test. Use whenever building or auditing an options strategy structure, checking spread-shape compliance before a certification, choosing DTE/strike rungs, or deciding whether a proposed structure change is even allowed. A violation is an automatic certification FAIL.

austin-starks/Public-Portfolio-Challenge

Orchestrate an out-of-sample certification of a NexusTrade trading strategy or live book — the master discipline behind the Public Portfolio Challenge. Use whenever you must decide PASS/FAIL on whether a portfolio holds up out of sample before deploying real money, replaying the Episode 10 runbooks, or running a \"certify my book\" / \"prove it out of sample\" / \"re-certify the fix\" task with the NexusTrade MCP connected. Pulls in walk-forward-oos, breadth-audit, sweep-reoptimization, options-structure-rules, bug-protocol, and deploy-gate.

austin-starks/Public-Portfolio-Challenge

The single entry point that executes a Public Portfolio Challenge episode or addendum runbook end-to-end, delegating each stage to the functional skills. Use when asked to run/execute/replay Episode 10, its bakeoff, or its addendum with the NexusTrade MCP connected. Reads the target runbook, pins its real artifacts (IDs, the incumbent bar), sequences the stages, and stops at the gated deploy. It orchestrates; the functional skills do the work.

austin-starks/Public-Portfolio-Challenge

Run a multi-family strategy bakeoff — the SEARCH→CERTIFY funnel that screens many candidate mechanisms down to a certified deploy winner without letting the cheap search layer issue a verdict. Use when replaying the Episode 10 bakeoff, when exploring several distinct strategy families before certifying, when deciding whether \"no deployable winner\" is even a legal conclusion, or when building the per-family certification ledger. Enforces verdict-integrity: only certification can end a campaign.

austin-starks/Public-Portfolio-Challenge

Re-optimize a NexusTrade strategy with a walk-forward SWEEP and label parameter provenance — the discipline that prevents deploying inherited knobs. Use whenever a structural change (sizing, rung depth, universe membership, DTE family, adding a rank signal) forces a re-sweep, when authoring gene_intents from get_sweep_surface, when choosing sweep over GA for a deploy cert, or when selecting the cross-fold-robust winner instead of the per-fold argmax. Invoke with the NexusTrade MCP connected.

austin-starks/Public-Portfolio-Challenge

Run and read a NexusTrade walk-forward out-of-sample study — the certification engine behind the Public Portfolio Challenge. Use when certifying a fixed portfolio (backtest_only) or re-optimizing one (sweep), when setting fold_count / anchored / validation / embargo params, when monitoring a run_walk_forward_study to completion, when reading per-fold OOS returns/Sortino/drawdown, or when a variant's fold calendar needs calendar-alignment against a base control. Invoke with the NexusTrade MCP connected.

相关技能