Communitygithub.com

austin-starks/Public-Portfolio-Challenge

為 Public Portfolio Challenge 的動量-LEAP 選擇權投資組合設定的嚴格結構約束——包括價差形狀規則、獲利了結凸性上限陷阱、可負擔性階梯,以及已知不應重新測試的失敗策略。在建立或審查選擇權策略結構時、於認證前檢查價差形狀合規性時、選擇 DTE/履約價級距時,或決定是否允許提出的結構變更時使用。違反任何規則將自動導致認證失敗。

Public-Portfolio-Challenge 是什麼?

此技能定義了 Public Portfolio Challenge 中動量-LEAP 選擇權投資組合的硬性結構約束。它是一系列不可違反的規則,旨在確保策略的結構完整性與長期可行性。核心規則包括:價差形狀規則(長期曝險僅能使用單純買權,短期價差則限制在30天內)、獲利了結凸性上限陷阱(多重獲利了結點會意外限制報酬潛力)、可負擔性階梯(確保所有標的都能在預算內建立倉位),以及已知失敗策略清單(如停損、長期垂直價差等)。此技能適用於 Claude Code 等 AI 代理平台,並緊密整合於代理的工作流程中,用於驗證選擇權策略結構、審查投資組合變更,並作為認證前的合規檢查工具。違反任何規則都將導致認證失敗,因此是保持策略效能與避免常見陷阱的關鍵參考。它透過清晰的規則定義與具體的實施指南(如檢查 DTE、履約價、成本與預算限制),協助開發者與交易者建立穩健的選擇權書。

相容平台~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)= 僅限單純買權。 無上限凸性,無短腿。不允許長期借記或垂直價差(例如,Mar-'27 價平/+3/+10/+20 有上限的垂直價差是違規的,無法通過認證)。
  • 任何借記/垂直價差必須是短期的——在 ≤ ~30 DTE 內到期。 薄價在該處是可接受的。

每次審查最終入選者時,都應透過 get_portfolio 讀取每腿的 DTE/履約價來重新確認合規性。違規 = 自動失敗,無一例外。

短期垂直價差是候選方案,並非禁止

先前一個**+3% 寬、無上限、所有標的可選** ≤30-DTE 的薄價部位未能通過認證(Theta 時間衰減損耗、費用週轉、壓垮了 2025 年 4 月折疊測試)。這只否定了一個點,而非整個類別。一個短期的寬、股份上限的借記價差是另一種結構——讓 sweep + OOS 認證來裁決它,但要設計好讓失敗模式無所遁形:寬度是一個基因,部位股份是上限基因,並且它必須通過相同的 OOS 關卡,同時還要加上週轉/費用護欄(報告每次折疊的費用 + 週轉 + 部位股份;先前一個部位在某次折疊中,費用膨脹到 1.5–8.9k 美元,而現行方案約為 100–600 美元,必須能在 2025 年 4 月的折疊測試中存活)。

已確定的結構系列

僅限單純買權的動量-LEAP:一個7 級深度價外階梯(價平 / +10 / +20 / +35 / +50 / +75 / +100% 價外,365–730 DTE),獲利了結 +250%,可負擔性回填,SelectTop 21。替代數據可以影響排名訊號、進場過濾器、個股傾斜或附加條件——但絕不能影響結構級距、價差形狀規則或選股範圍。

獲利了結凸性上限陷阱

如果存在多個「總是」獲利了結的條件(例如,P/L ≥ 20% / 50% / 200%),最低的那個會優先觸發,並有效地將所有贏家的報酬限制在約 +20% 左右——這違背了使用單純買權以獲得無上限凸性的初衷。這是回報率落後於「讓贏家奔跑」投資組合的單一最可能原因。在任何活躍投資組合上對出場階梯進行健全性檢查;部署配置使用單一的高獲利了結點(例如 +250%)或無獲利了結點。

可負擔性階梯(結構可行性)

在 25,000 美元的冷啟動資金下,一個單一模板、每標的約 1,000 美元的投資組合在結構上不可行。在昂貴的標的(META / LLY / GS / TSM / ADI / AVGO)上,最小定義風險結構的每張合約成本為 1.3–2.4k 美元。

  • 每個模板集必須以最昂貴標的也能買得起的級距結尾——在 sweep 結構時,絕不能移除最便宜的級距。
  • 按昂貴→便宜的順序排列模板,讓引擎能填入第一個可負擔的級距。
  • 將便宜的結構作為主要機制 = 死路;階梯必須為每個標的提供一個可負擔的單位。
  • 每個層級的 totalBudget ≥ K × perNameAllocation。預算限制的是成本基礎,而非市值——務必透過 audit_backtest_posture 在 tape 上驗證。美元預算的風險降低效果不同於 NAV 百分比規模。

請參閱 breadth-audit 以衡量階梯在固定 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.

相關技能