Communitygithub.com

austin-starks/公开投资组合部署挑战

NexusTrade 实盘交易簿的有门控部署 + 清理流程:克隆决赛选手、预览增量差异、暂存未批准订单、验证成交。仅当人类明确说出"部署 + 清理"并指定决赛选手后方可执行。

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

该技能为开发者提供了一个严谨的、有门控的部署流程,专用于 NexusTrade 平台的实盘交易簿。它仅在人类用户明确指示“部署并清理”并指定某个决赛选手(finalist)策略时触发,确保不会发生意外操作。核心逻辑是:首先将决赛选手的策略克隆到实盘交易簿中(如果尚未是当前策略),然后运行增量(delta)模式的对账预览以生成所需订单,但绝不自动提交到券商。所有生成的订单都会被标记为“未批准”(UNAPPROVED),需要人类用户在 NexusTrade UI 中手动确认。流程还包括成交后验证步骤,确保订单清空,并报告实现利润、洗售标志和投资组合参与情况。此技能强制要求信号新鲜度检查、清除过期待处理订单等先决条件,防止部署到不健康的状态。它支持 Claude Code 等 AI 代理平台,通过严格的步骤和人工确认环节,在自动化的便利性和人类监督的安全性之间取得了平衡。

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

在你喜欢的 AI 中提问

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

文档

部署门控(阶段 E — 有门控)

在人类明确说出"部署 + 清理"并指定具体决赛选手之前,不会进行任何部署,也不会下达任何订单。 此技能仅在此之后运行。目标:通过增量交易(不重复来回交易重叠部分)使实盘持仓等于所选决赛选手今日的新部署。

部署前门控(硬性)

  1. 信号新鲜度门控。 其替代数据序列未延伸至当前且无有效刷新路径的决赛选手不得部署,无论其认证如何 — 过时的排名序列相当于一个死亡交易簿。
  2. 首先处理过期的待处理订单。 检查实盘交易簿中是否存在待处理/等待用户批准 → 已取消 的订单 — 它们会阻碍新的暂存。列出它们;人类在 UI 中取消。注意 automaticOrderApproval 状态(默认:保持不变,除非被告知在部署时切换)。

五个步骤

  1. 首先将决赛选手克隆到实盘交易簿上 — clone_strategies_to_portfolio(源 = 决赛选手,目标 = 实盘交易簿),然后通过字段验证克隆。这就是“部署”:它设置实盘交易簿的策略,供下一步对其进行对账。reconcile_portfolio_to_strategy 没有 strategy_source 参数 — 它使实盘交易簿以其自身的策略为基准进行对账,因此必须首先进行克隆。如果决赛选手就是未更改且已部署的实盘交易簿,则无需克隆 — 请说明。
  2. 对账预览 — reconcile_portfolio_to_strategy({ portfolio_id: "<live>", mode: "delta" })。仅预览 — 绝不会下单。 返回 target、current、orders(已采用 create_orders 格式)、估计成本、已实现损益以及洗售标志。期望单次达成目标 — 实盘策略的其余部分将通过每日再平衡逐步累积。请说明;不要将其重新诊断为错误。
  3. 向人类显示预览并获得明确批准。 合理性检查:订单仅触及增量部分(重叠部分不变)、成本合理、target 为全新部署,并且 — 对于参与度修复 — 目标覆盖多个名称,而不仅仅是一个。
  4. 暂存订单 — create_orders({ portfolio_id: "<live>", orders: <第 2 步的订单数组> })。暂存为未批准;该工具绝不向券商提交。人类在 NexusTrade UI 中手动批准它们 — 没有批准工具,您也无法批准它们。期权自动暂存为 LIMIT 单。
  5. 成交后验证 — 重新运行对账预览;增量 orders 数组应大致为空。报告成交情况、任何剩余部分、已实现损益、洗售标志以及最终的实盘参与度(持有的不同名称)。

规则

  • 默认 mode: "delta"。仅当人类明确要求重置计税基础时,才使用 "liquidate_all"。
  • 没有针对该特定决赛选手的明确指令,切勿运行此技能。
  • 当运行中尚未固定实盘交易簿时,通过 fetch_portfolios 发现实盘目标 — 切勿硬编码未经字段/状态确认的实盘投资组合 ID。
  • 签署完成后,重新附加部署所期望的任何每周监控代理。

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 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

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.

相关技能