SuperAPI AI 工具集

backtest

测试与质量

查看项目

更新于 10-16 01:06

技能介绍

用途:从 JSON 策略文件出发运行回测,解读结果并支持“假设—证伪”工作流。该技能是 CLI 封装与结果解读指南,回测数值由工具确定性地返回,技能只解释含义,不重算或估算任何结果值。

主要能力:运行已保存策略并解读结果;按事实陈述+基准对比+假设证伪判断组织输出;结果需修订时交回 create-strategy。详细规则见 references/result-interpretation.md(解读原则与报告格式)、benchmark.md(基准对比)、period-defaults.md(按周期默认区间)、market-rules.md(手动核查用官方市场规则来源);解释韩文指标名、指标名或策略术语时加载 glossary.md。

使用方式与数据根目录:开始前先判定运行模式并把 {data_root} 解析为绝对路径。clone 模式(在 upbit-strategy-toolkit 仓库工作区/cwd 运行)、全局 agent skills 模式(npx skills add ... -g 安装且仓库不在当前工作区)、项目级 agent skills 模式(无 -g)均取运行时当前工作目录;若 config get data-dir 返回 unset,无论何种模式 CLI 都使用运行时当前工作目录,若用户已 config set data-dir 则用存储值,不确定时用 bash scripts/upbit-strategy-toolkit.sh config get data-dir 确认。基于 slug 的请求解析为 {data_root}/strategies/{slug}.json,向包装脚本始终传绝对路径。工具调用使用包装脚本 bash scripts/upbit-strategy-toolkit.sh ...,不要直接运行 upbit-strategy-toolkit。

流程:接收 create-strategy 交接或直接调用,展示策略/市场/周期/假设/证伪条件;周期优先用户显式给出的 start/end,否则用周期默认值(1d 为近一年,1h 为近三个月,1m 为近一周,其他约 250 根 K 线;end 默认为昨天 UTC)。回测按 UTC 解释日期。运行命令:bash scripts/upbit-strategy-toolkit.sh backtest run "$STRATEGY_PATH" --start {start_date} --end {end_date},可选 --capital、--fee-rate、--no-verbose、--force-refresh;CSV 自动保存到 {data_root}/reports/{slug}-{YYYYMMDD_HHMMSS}.csv。输出周期、基准、总收益、CAGR、MDD、Sharpe、交易数、胜率、盈亏因子、退出原因、总费用等,需原样引用 stdout。

限制与边界:不重算或估算结果值,不对结果做“好/坏”的形容词判断,不推荐策略、标的、交易时机或价格、目标收益、持有期;不隐藏工具局限(滑点、订单簿流动性、部分成交未反映);不连接实盘;不含策略生成(超出范围)。市场或周期与策略文件不一致时须先经 create-strategy 更新,不可用临时文件绕过。投资警示市场会交互提示,无 stdin 时会立即 EOF 并以退出码 1 自动取消,需确认后再以 echo y 管道重跑;周期无数据、交易所/周期不支持等错误按对应分支处理,不擅自改动用户指定日期。