SuperAPI AI 工具集

pre-trade-discipline-gate

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:在手动下单前评估本地检查清单,拦截无计划、超仓、报复性交易、市场状态受限或熔断受限的订单。它只做下单前的检查门,不连接券商 API、不下单、不撤单、不获取行情数据。

主要能力:读取本地 JSON 或 YAML 清单答案,以及可选的 trader-memory-core 论点状态、exposure_decision、circuit_breaker_decision 文件,生成 pre_trade_discipline_decision 工件,并可将报告链接回相关论点而不改变论点复核计划。

使用方式:需 Python 3.9+。准备含候选答案的 JSON/YAML 文件,仅对可执行手动订单意图(ENTRY_READY、ACTIONABLE、ACTIONABLE_DAY1、MANUAL_ORDER)进行门控;WATCHLIST、IGNORE 等非可执行意图仅记录。每个可执行候选需提供 planned_risk_dollars 与 actual_risk_dollars,须为有限非负数。运行命令:python3 skills/pre-trade-discipline-gate/scripts/check_pre_trade_discipline.py --answers-file state/manual-entry-checklist.json --state-dir state/theses --market-regime-decision reports/exposure_decision_latest.json --circuit-breaker-decision reports/circuit_breaker_decision_latest.json --output-dir reports/pre-trade-discipline --journal-dir state/journal/pre-trade-discipline。可用 --as-of 做确定性测试或回填。

决策含义:GO 表示全部通过;REVIEW_REQUIRED 表示输入缺失、未知或日志失败,需复核;NO_GO 表示至少一个可执行候选违反纪律规则;NO_ACTIONABLE_ORDERS 表示无可执行手动订单。默认 CLI 对有效决策退出码为 0,仅输入或运行时错误为 1;可用 --fail-on-non-go 让非 GO 决策返回 2。

拦截规则:入场未在书面计划中确认、止损未预定义、仓位未确认在计划内、风险金额字段缺失或非有限非负数、实际风险超过计划风险、交易记忆在报复窗口内有亏损退出或部分亏损、exposure-coach 建议为 REDUCE_ONLY 或 CASH_PRIORITY、drawdown-circuit-breaker 建议为 COOLDOWN、HALTED 或 TRADING_HALTED。市场状态或熔断工件缺失或不可读时,可执行订单为 REVIEW_REQUIRED;无可执行订单则仍为 NO_ACTIONABLE_ORDERS。

输出:生成带时间戳的 JSON 决策文件、对应 Markdown 报告(除非 --json-only),以及可选 JSONL 日志行。候选结果包含 checklist_answers,便于事后审计;无效风险金额存为 null,无法精确往返的十进制数保留为字符串。若候选含 thesis_id 且提供 --state-dir,报告会链接进论点 linked_reports,但不调用 mark_reviewed、不改变监控复核日期。

适用场景:手动下单前、图表验证与仓位计算通过后、近期亏损后的冷却窗口内、存在上游 exposure_decision 与 circuit_breaker_decision 时。限制:仅手动执行,不路由订单;无书面入场计划、止损或仓位确认则不放行;离线运行,不获取实时行情。