Communitygithub.com

austin-starks/公共投资组合挑战

公共投资组合挑战动量LEAP期权账簿的硬性结构约束——价差形态规则、止盈凸性上限陷阱、可负担性阶梯以及已知不应重测的失败策略。在构建或审计期权策略结构、认证前检查价差形态合规性、选择DTE/行权价阶梯、或判断提议的结构变更是否被允许时使用。违反则自动认证失败。

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

此技能规定了公共投资组合挑战中动量LEAP期权账簿的硬性结构约束,是策略结构认证的基石。它包含四个核心规则:价差形态规则禁止长期垂直价差并限制短期垂直价差;止盈凸性上限陷阱警告多个止盈点会限制收益;可负担性阶梯确保所有标的都能在预算内获得合适仓位;已知失败策略列表列出已被证明无效的策略,如止损和长期垂直价差。此技能适用于Claude Code、Coder、Cursor等AI代理平台,用于在构建或审计期权策略时自动执行结构规则,确保策略结构符合认证标准。违反任何规则将自动导致认证失败,无需例外。

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

在你喜欢的 AI 中提问

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

文档

期权结构规则

期权结构家族已由实证确定——只有信号(排名/加权/过滤)通常处于可调整范围。以下是硬性约束;违反将导致自动认证失败。

价差形态规则(硬性约束)

  • 长期暴露(≥ ~120 DTE)= 仅限 outright 多头看涨期权。 无上限凸性,无空头腿。禁止长期借方差价或垂直价差(例如,Mar-'27 ATM/+3/+10/+20 有上限垂直价差是违规行为,无法通过认证)。
  • 任何借差/垂直价差必须是短期的——在 ≤ ~30 DTE 内到期。 薄利在该处是可以的。

每次通过从 get_portfolio 读取腿 DTE/行权价来重新确认最终候选方案的合规性。违规 = 自动失败,无例外。

短期垂直价差是候选方案,而非被禁止

先前的一个薄利 +3% 幅度、无上限、每个名称都符合资格 的 ≤30-DTE 策略未能通过认证(Theta 衰减、费用消耗、破坏了 2025 年 4 月的折叠)。这仅否定了一个点,而非整个类别。一个短期宽幅、按份额设上限的借差价差是一个不同的结构——让扫描+OOS 认证来裁决它,但要以故障模式无法隐藏的方式进行工具化:宽度是一个基因,策略份额是一个有上限的基因,并且它必须通过相同的 OOS 门限加上一个周转/费用护栏(报告每折叠费用+周转+策略份额;之前的策略使费用膨胀到每次折叠 1.5–8900 美元,而现有策略约为 100–600 美元,并且必须能经受 2025 年 4 月的折叠)。

已确定的结构家族

仅限 outright 看涨期权的动量 LEAP:一个7 阶梯深度 OTM 梯形(ATM / +10 / +20 / +35 / +50 / +75 / +100% OTM,365–730 DTE),止盈 +250%,可负担性回填,SelectTop 21。另类数据可触及排名信号、入场过滤器、个股倾斜或叠加条件——绝不触及结构阶梯、价差形态规则或选股范围。

止盈凸性上限陷阱

如果存在多个“始终”止盈平仓(例如,盈利 ≥ 20% / 50% / 200%),则最低的那个首先生效并有效地将所有赢家的收益限制在大约 +20%——这违背了 outright 看涨期权无限凸性的逻辑。它是导致收益落后于让赢家奔跑策略的最可能原因。在任何实盘账簿上对退出阶梯进行合理性检查;部署配置使用单个高止盈点(例如 +250%)或不设止盈点。

可负担性阶梯(结构可行性)

在 25,000 美元冷启动资金下,单一模板每名称约 1,000 美元的账簿结构上会失败。昂贵标的(META / LLY / GS / TSM / ADI / AVGO)的最小定义风险结构成本为每张合约 1.3–2.4k 美元。

  • 每个模板集必须以一个最昂贵名称也能填充的阶梯结束——扫描结构时切勿移除最便宜的阶梯。
  • 按昂贵→便宜顺序排列模板,以便引擎填充第一个可负担的阶梯。
  • 以廉价结构作为主要机制 = 死路;梯形必须为每个名称提供一个可负担的单位。
  • totalBudget ≥ K × perNameAllocation 每层级。预算限制的是成本基础,而非市值——始终通过 audit_backtest_posture 在实盘上验证。美元预算不会像 NAV 百分比仓位那样降低风险。

参见 广度审计 以衡量梯形是否能在固定的 25,000 美元预算下实际参与。

该账簿已知的失败策略(无新理由则不要重测)

  • 多头看涨期权/持有至到期 LEAP 账簿的止损——反复波动;测试两次,两次都受伤。
  • SPY > 200-SMA 机制门限——2022 年空仓→无法通过认证活动最低要求;200D-SMA 动量过滤器测试结果也是最差的。
  • 长期垂直价差——被价差形态规则禁止。
  • 无上限份额的薄利短期策略——Theta 衰减失败(见上)。
  • 窄幅排名轮动(前 K ≤ 5 且共享节奏)——保持 K > 5。

节奏说明:DaysSinceLastRebalanceOptionOrder / DaysSinceOrder —— null >= N 在全新账簿上为 TRUE;节奏时钟在 RebalanceOption 策略之间共享。

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 mandatory pre-flight contract checks (Stage S0) that must pass before trusting NexusTrade's certification engine for any strategy work. Use at the start of a bakeoff or certification campaign to prove the walk-forward engine runs end-to-end, windows don't leak, fold winners persist, and the engine doesn't fabricate values for dead/not-yet-listed names. Each check has a STOP-and-report failure mode; these runs do NOT count toward any certification minimum.

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

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.

相关技能