🎯 Latency Hunter Toolkit
给一人量化的工程审查插件包 —— 无 alpha、无密钥、无模型,edge 你自己带。
中文 | English
回测虚高 0.x 个夏普的坑,实盘会一次性还给你。
热路径上多一把锁、一次 false sharing、一回堆分配,尾延迟会替你买单。
这个工具不帮你找 alpha,只帮你别在工程上自欺。
这是什么
Latency Hunter Toolkit 是一个面向**一人量化(OPC)**的 Claude Code 插件包。作者人设 "Latency Hunter" —— 一个专盯延迟与陷阱、对"乐观假设"零容忍的猎手。
它不是策略库、不是信号源、不是模型。它做且只做一件事:对你的量化工程代码做尽职调查(due diligence),把会让回测虚高、让实盘亏钱、让热路径变慢的工程陷阱逐项揪出来,按严重度出一张"体检报告"。
核心 ethos:
无 alpha · 无密钥 · 无模型 —— 只做工程审查,edge 你自己带。
它不碰你的 API key,不预测收益,不给买卖点。它只回答三个问题:
- 这个值,在该时点真能算出来吗?(未来函数 / 前视偏差)
- 这笔成交,实盘真能成吗?(成交真实性 / 成本)
- 这段热路径,为什么慢?(锁争用 / false sharing / cache miss / 分配 / syscall)
当前含五个 skill:四个审查型(backtest-guard / latency-audit / orderbook-sanity / risk-config-lint,按"严重度分级 + 定位到 文件:行 + 不臆测"的铁律工作)+ 一个生成型(connector-forge,把"连接器锻造协议"固化成可运行骨架,让连接器从地基上就不漏)。
一键安装
方式一:Claude Code 插件市场(推荐)
# 1. 添加本仓库为插件市场
/plugin marketplace add paidaxing1234/latency-hunter-toolkit
# 2. 安装插件(包含五个 skill + 五个 slash command)
/plugin install latency-hunter
装完后,五个 skill 会在你聊到回测/热路径/连接器/行情数据/风控相关话题时自动触发,也可以用 slash command 显式调用:
/backtest-guard ./strategy # 审一份回测/策略目录
/latency-audit ./engine/src # 审一段 C++ 热路径
/connector-forge ./my-bot # 生成/修复一个交易所连接器骨架
/orderbook-sanity ./data # 审行情数据/采集落库代码的质量坑
/risk-config-lint ./risk # 审风控配置/pre-trade 风控代码
方式二:手动拷贝到 skills 目录(备选)
如果你不走插件市场,只想要 skill 本体:
# 克隆仓库
git clone https://github.com/paidaxing1234/latency-hunter-toolkit.git
# 拷贝五个 skill 到你的用户级 skills 目录
mkdir -p ~/.claude/skills
cp -r latency-hunter-toolkit/skills/backtest-guard ~/.claude/skills/
cp -r latency-hunter-toolkit/skills/latency-audit ~/.claude/skills/
cp -r latency-hunter-toolkit/skills/connector-forge ~/.claude/skills/
cp -r latency-hunter-toolkit/skills/orderbook-sanity ~/.claude/skills/
cp -r latency-hunter-toolkit/skills/risk-config-lint ~/.claude/skills/
重启 Claude Code 后,直接说"帮我审一下这个回测有没有未来函数""看看这段热路径为什么慢""帮我生成一个 Binance 连接器 / WS 老掉线帮我加重连""这数据干不干净 / K 线有没有缺口"或"帮我看看风控配置 / kill-switch 靠不靠谱"即可触发。
五个 skill
1. backtest-guard · 回测照妖镜
把一份回测/策略代码当"嫌疑犯"过堂,逐项揪出会让回测虚高、实盘还回去的陷阱。
是什么 —— 量化回测代码的"照妖镜"。回测的默认假设是乐观的(零成本、零延迟、能看到未来、永远成交);实盘的默认假设是敌意的。这个 skill 的工作就是把每一处"乐观假设"暴露出来,标注严重度,而不是替你优化收益。
覆盖四大类、共 48 条检测点(完整清单见 skills/backtest-guard/references/backtest-pitfalls.md):
| 类别 | 抓什么 |
|---|
| ① 未来函数 / 数据泄漏 | 负数 shift、同 bar 信号即成交偷价、全样本 fit 预处理、bfill 灌未来值、center=True 滚动、repaint 指标、point-in-time 缺失、时序 shuffle 切分… |
| ② 过拟合 / 数据窥探 / 幸存者偏差 | 无样本外、网格只报最优参、p-hacking、用"当前"成分股回测历史、自由参数过多、样本量不足、无多重检验校正… |
| ③ 成交真实性 / 成本执行 | 零手续费、零滑点、用 bar 内极值当成交价、假设无限流动性、零延迟限价即成、忽略爆仓/资金费率/做空成本… |
| ④ 收益统计 / 口径错误 | 年化因子用错(crypto 套 252)、算术累加冒充复利、夏普分母口径错、权益曲线 realized/MTM 混用… |
怎么触发
- 自动:把策略/回测/信号/数据加载/参数寻优代码丢过来,问"这个回测能信吗 / 为什么实盘对不上回测 / 帮我查未来函数 / 有没有过拟合"。
- 触发词(中):回测审查、回测照妖镜、回测体检、未来函数、前视偏差、数据泄漏、过拟合、数据窥探、幸存者偏差、回测陷阱、回测可信度、实盘对不上回测。
- 触发词(英):backtest audit、look-ahead bias、data leakage、overfitting、survivorship bias、curve fitting。
- 显式:
/backtest-guard ./your-strategy
示例体检报告(片段)
══════════════════════════════════════════
回测体检报告 · backtest-guard
══════════════════════════════════════════
受检对象: my-strategy/ 扫描文件: 12 个 代码行: ~3,400
总评: 🔴 致命 2 项 · 🟠 高危 2 项 · 🟡 中 1 项 · 🔵 低 0 项
判语: 「这更像一次对 2021 牛市的精细过拟合,而不是一个策略。」
[🔴 致命] 负数 shift 引入未来值
位置: src/features.py:84
问题: df['mom'] = df['close'].shift(-5) 把 t+5 收盘移到 t,
该列进入了 X 特征矩阵(features.py:131)。
修复: 进特征的列改 shift(>=1);未来收益只留 y/label,绝不进 X。
[🟠 高危] 零手续费 + 零滑点
位置: backtest/engine.py:––(全文件未发现 commission/slippage)
问题: 成交按 close 原值记账,日内策略年换手 ~900 次,成本被完全忽略。
修复: 按 taker 费率建模 + 半个 spread 滑点,做成本翻倍敏感性。
══════════════════════════════════════════
报告只给方向性判断("剔除偏差后表现往哪边走"),绝不承诺任何具体收益数字。每条都定位到 文件:行,找不到证据就标"未发现 / 需人工确认"。
2. latency-audit · 热路径猎手
把 C++ 低延迟交易引擎的热路径放上手术台,逐项揪出偷走微秒、抖动尾延迟的工程缺陷。
是什么 —— C++ 低延迟/高频交易引擎热路径的审查器。它先定位真正的热路径(tick 回调 → 信号 → 下单 → 撮合 → 序列化 → 无锁队列),再逐项检查那些在均值上看不出、却在 p99/p99.9 尾延迟上要命的工程问题,出一张"热路径体检报告"。
覆盖三大类:
| 类别 | 抓什么 |
|---|
| ① 并发 / 锁 / 伪共享 | 热路径上的 mutex/锁争用、false sharing(未对齐到 cache line 的共享计数器)、虚假唤醒、原子操作内存序过严… |
| ② 内存 / 缓存 / 分配 | 热路径堆分配(new/malloc/隐式 std::string/std::vector 扩容)、cache miss、指针追逐、未预留容量、拷贝而非 zero-copy… |
| ③ syscall / IO / 序列化 / 网络 / 分支 | 热路径 syscall、未批处理的网络 IO、序列化拷贝、不可预测分支、缺 __builtin_expect/[[likely]]、日志阻塞热路径… |
怎么触发
