SuperAPI AI 工具集

edge-strategy-reviewer

数据与分析

查看项目

更新于 10-16 08:23

技能介绍

Edge Strategy Reviewer 是 tradermonty/claude-trading-skills 中的一个技能,定位为对 edge-strategy-designer 产出的策略草稿进行确定性质量把关(quality gate)。

用途

该工具用于在策略草稿生成之后、导出到 edge-candidate-agent 之前,对草稿进行结构化审查,判断其边缘合理性(edge plausibility)、过拟合风险、样本量充分性以及执行现实性。也可用于人工验证单个草稿策略。

主要能力

工具会加载草稿 YAML 文件(来自 --drafts-dir 目录或单个 --draft 文件),按 8 项标准(C1-C8)进行加权评分,计算置信度分数(所有标准的加权平均),并给出判定结果:PASS / REVISE / REJECT。同时评估导出资格(需满足 PASS + export_ready_v1 + exportable family)。最终写出审查输出(YAML 或 JSON)以及可选的 markdown 摘要。

审查标准(C1-C8)

  • C1 边缘合理性,权重 20:检查论点质量、领域术语、机制关键词(连续评分 50-95)。
  • C2 过拟合风险,权重 20:按 5 级过滤器数量评分(90/80/60/40/10),并对精确阈值进行惩罚。
  • C3 样本充分性,权重 15:根据预估年度机会数进行连续评分(10-95)。
  • C4 制度依赖性,权重 10:跨制度验证。
  • C5 退出校准,权重 10:止损、回报风险比。
  • C6 风险集中度,权重 10:仓位规模限制。
  • C7 执行现实性,权重 10:成交量过滤、导出一致性。
  • C8 失效质量,权重 5:信号数量与具体性。

判定逻辑

  • C1 或 C2 的 severity=fail → 立即 REJECT。
  • confidence >= 70 且无 fail 发现 → PASS。
  • confidence < 35 → REJECT。
  • 其他情况 → REVISE(附带修订说明)。

使用方式

前置条件:策略草稿 YAML 文件(edge-strategy-designer 的输出)、Python 3.10+ 及 PyYAML。

运行脚本示例:

审查目录中的所有草稿

python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py
--drafts-dir reports/edge_strategy_drafts/
--output-dir reports/

审查单个草稿

python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py
--draft reports/edge_strategy_drafts/draft_xxx.yaml
--output-dir reports/

JSON 输出并附带 markdown 摘要

python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py
--drafts-dir reports/edge_strategy_drafts/
--output-dir reports/
--format json
--markdown-summary

严格导出模式:具备导出资格但存在任何 warn 的草稿 → REVISE

python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py
--drafts-dir reports/edge_strategy_drafts/
--output-dir reports/
--strict-export

偏差检查清单(issue #297):强制性的策略研究偏差门禁。

除非提供自定义 YAML 路径,否则使用内置检查清单。

任何必填项未处理的草稿会从 PASS 降级为 REVISE,并失去导出资格。

python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py
--drafts-dir reports/edge_strategy_drafts/
--output-dir reports/
--bias-checklist

输出格式

主要输出为 review.yaml(或 review.json),包含 generated_at_utc、source(drafts_dir、draft_count)、summary(total、PASS、REVISE、REJECT、export_eligible)以及 reviews 列表(每项含 draft_id、verdict、confidence_score、export_eligible、findings、revision_instructions)。

资源

  • references/review_criteria.md:C1-C8 的详细评分标准。
  • references/overfitting_checklist.md:过拟合检测启发式方法。

适用场景

适用于策略草稿生成后、导出至 edge-candidate-agent 之前的质量把关,以及人工验证单个草稿策略的边缘合理性。

限制

资料未提供关于收费、价格、平台支持范围或具体效果保证的信息。