用途
该技能面向使用 vectorbt（开源版，导入方式为 import vectorbt as vbt）或 VectorBT PRO（导入方式为 import vectorbtpro as vbt）编写 Python 量化代码的场景，覆盖编写、调试、优化与迁移工作。
它不处理通用金融问题、券商下单执行、事件驱动回测（如 NautilusTrader）以及实盘/模拟交易，这些属于其他技能范围。
主要能力
- 识别环境与版本：通过
scripts/vbt_context.py doctor检查运行时包版本与来源、项目内的导入证据、PRO 访问状态（允许/拒绝/未知）以及缓存根目录。 - PRO 文档同步：通过
scripts/vbt_context.py sync-pro获取 PRO 版本的文档索引与 Markdown 文件，支持 24 小时内复用有效缓存、--refresh强制检查元数据、--offline仅用已验证缓存。 - 按版本实现与验证：在目标环境中确认 API 存在，检查签名与文档字符串，实现最小可用案例，并对仿真改动使用小型确定性 OHLC/信号验证订单时序、价格、数量、费用、滑点和止损优先级。
- 可选 MCP 集成：为连接、配置或修复 MCP 提供说明，覆盖官方 PRO 服务器、XDG 缓存复用、项目级 Codex/Claude Code 配置与协议检查。
使用方式
命令均相对于技能目录，而非用户仓库；需使用绝对项目路径与解释器路径。辅助脚本要求 macOS/Linux 上的 Python 3.11+，PRO 同步还需具备仓库访问权限的 gh。
python3 scripts/vbt_context.py doctor --project /path/to/strategy
python3 scripts/vbt_context.py doctor --project /path/to/strategy --python /path/to/env/bin/python
python3 scripts/vbt_context.py sync-pro --project /path/to/strategy --python /path/to/env/bin/python
python3 scripts/vbt_context.py sync-pro --release v2026.9.5
版本号仅为示例，应选择用户实际版本。缓存位置为 ${XDG_CACHE_HOME}/vectorbt-agent 或 ~/.cache/vectorbt-agent，可用 --cache-dir 覆盖并需在 sync、MCP 配置与检查中保持一致。
适用场景
- 需要判定项目使用 OSS 还是 PRO 版本，并沿用既有选择。
- 需要查阅对应版本的 API 名称、参数与示例。
- 需要为回测仿真改动做订单与成交验证。
- 需要比较冷/热执行性能时有可测量的基线。
限制
- vectorbt 与 vectorbtpro 名称与用法相似但 API 契约不可互换，公开示例不能作为另一版本行为的证据。
- 网站登录、GitHub 资源访问、已安装包与 MCP 客户端加载是彼此独立的状态。
- 不在对话中索取令牌，也不将令牌保存在技能内。
- 网络失败表示访问状态未知，而非权限丢失。
- 官方快照可能滞后于实时文档，需标注版本与新鲜度。
- 上游示例的已验证元数据不等同于本项目中的测试通过。
- 私有导出与生成的上下文应置于 Git 之外。