Agent Skill
2/7/2026

factor-backtest-skill

安全、高效地批量回测 8 个 Alpha 表达式,内置验证、熔断和异常处理机制。

G
grd
26GitHub Stars
1Views
npx skills add GRD-Chang/worldquant-skill

SKILL.md

Namefactor-backtest-skill
Description安全、高效地批量回测 8 个 Alpha 表达式,内置验证、熔断和异常处理机制。

name: factor-backtest-skill description: 安全、高效地批量回测 8 个 Alpha 表达式,内置验证、熔断和异常处理机制。

因子回测 Skill

📌 用途

当你有 8 个 Alpha 表达式需要批量回测时,使用此技能。它会:

  • ✅ 验证表达式的合法性
  • ✅ 提交批量回测任务
  • ✅ 监控进度并处理异常
  • ✅ 返回完整的回测结果

🔑 核心约束(不可违反)

1. Rule of 8

  • 必须恰好传入 8 个表达式
  • 少于或多于 8 个都会被平台拒绝

2. 加速配置

  • 必须设置 visualization=false(大幅加速回测)

3. 中性化选择

neutralization 必须从以下 5 项中选一:

适用场景
SLOW适用于低换手率信号(<50%年化)、长期趋势捕捉、基本面或价值策略
FAST适用于高换手率信号(>70%年化)、短期趋势捕捉、高频数据或短期价格动量策略
SLOW_AND_FAST适用于同时考虑短期和长期趋势的策略、多元化Alpha组合、平衡型投资策略
REVERSION_AND_MOMENTUM适用于需要对冲短期均值回归和长期动量的策略、平衡型多空Alpha因子
CROWDING适用于希望降低拥挤交易风险的策略、强动量市场环境、流行因子或拥挤交易策略

🔄 标准流程(4 步)

步骤 1:验证表达式

mcp:validate_alpha_expressions([表达式1, ..., 表达式8])

  • 要求:必须 100% 通过验证
  • 失败处理:修正错误 → 重新验证 → 严禁未全部通过就进入回测

步骤 2:提交回测

mcp: create_multiSim( alpha_expressions=[表达式1, ..., 表达式8], ... )

步骤 3:监控进度

mcp: check_multisimulation_status()

监控策略

  • ⏱️ 回测时间较长,可每 5–10 分钟查询一次
  • 🚨 僵尸回测熔断:超过 40 分钟仍 in_progress → 放弃当前任务,重新提交

步骤 4:获取结果

mcp: get_multisimulation_result()


⚠️ 异常处理

语法错误

现象:回测返回 "No alpha ID found in completed simulation"

处理

  1. 调用 get_SimError_detail 查看详细错误
  2. 对照 get_operators 检查操作符签名
  3. 修正表达式 → 重新走完整验证流程
  4. 严禁无修改直接重试

回测卡死

现象:状态持续 in_progress 超过 40 分钟

处理

  1. 重新认证会话
  2. 再次检查状态
  3. 若仍卡死 → 放弃当前任务,创建新回测

🚫 禁止操作

  • ❌ 传入非 8 个表达式
  • ❌ 使用 neutralization 列表外的值
  • ❌ 设置 visualization=true
  • ❌ 语法错误后无修改重试
  • ❌ 高频轮询状态(< 5 分钟)

📊 输入/输出

输入

{
    "alpha_expressions": [8 个表达式],
    "decay": 5,                          # 可选
    "neutralization": "SLOW",            # 必须从 5 项中选
    "truncation": 0.0,                   # 可选
    "test_period": "P0Y0M"               # 可选
}

输出

{
    "location": "multiSim 结果 URL",
    "alphas": [
        {
            "alpha_id": "...",
            "sharpe": 1.8,
            "fitness": 1.2,
            "turnover": 0.25,
            "ic": 0.05
        },
        ...
    ],
    "status": "completed" | "failed",
    "errors": []
}

🛠️ 常用 MCP 工具

核心

  • validate_alpha_expressions - 验证表达式
  • create_multiSim - 批量回测
  • check_multisimulation_status - 检查状态
  • get_multisimulation_result - 获取结果

分析

  • get_alpha_details - 详细指标
  • get_alpha_pnl - 收益曲线
  • get_alpha_yearly_stats - 年度统计
  • check_correlation - 相关性检查

调试

  • get_SimError_detail - 错误详情
  • get_operators - 操作符列表

Skills Info
Original Name:factor-backtest-skillAuthor:grd