edge-strategy-reviewer

Edge Strategy Reviewer

edge-strategy-designer が作成した戦略ドラフトの品質を判定する決定論的なゲートです。

使用するタイミング

• edge-strategy-designer が strategy_drafts/*.yaml を生成した後
• パイプラインを介してドラフトを edge-candidate-agent にエクスポートする前
• エッジの妥当性を手動で検証する場合

前提条件

• 戦略ドラフトの YAML ファイル（edge-strategy-designer の出力）
• PyYAML を使用できる Python 3.10 以降

ワークフロー

1. --drafts-dir または単一の --draft ファイルからドラフト YAML ファイルを読み込みます
2. 重み付けスコアを用いて、各ドラフトを 8 つの基準（C1～C8）に照らして評価します
3. 信頼度スコア（全基準の加重平均）を算出します
4. 判定を決定します：PASS／REVISE／REJECT
5. エクスポートの適格性を評価します（PASS + export_ready_v1 + エクスポート可能なファミリー）
6. レビュー結果（YAML または JSON）と、オプションで Markdown の要約を出力します

レビュー基準

#	基準	重み	主なチェック項目
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 の重大度が fail → ただちに REJECT
• 信頼度が 70 以上で、fail の指摘がない → PASS
• 信頼度が 35 未満 → REJECT
• それ以外 → REVISE（修正指示付き）

スクリプトの実行

# Review all drafts in a directory
python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py \
  --drafts-dir reports/edge_strategy_drafts/ \
  --output-dir reports/

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

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

# Strict export mode: export-eligible drafts with any warn → REVISE
python3 skills/edge-strategy-reviewer/scripts/review_strategy_drafts.py \
  --drafts-dir reports/edge_strategy_drafts/ \
  --output-dir reports/ \
  --strict-export

# Bias checklist (issue #297): mandatory strategy-research bias gate.
# Uses the bundled checklist unless a custom YAML path is supplied.
# A draft leaving any required item unaddressed is downgraded PASS → REVISE
# and loses export eligibility.
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: "2026-02-28T12:00:00+00:00"
source:
  drafts_dir: "/path/to/strategy_drafts"
  draft_count: 4
summary:
  total: 4
  PASS: 1
  REVISE: 2
  REJECT: 1
  export_eligible: 1
reviews:
  - draft_id: "draft_xxx_core"
    verdict: "PASS"
    confidence_score: 80
    export_eligible: true
    findings: [...]
    revision_instructions: []

リソース

• references/review_criteria.md — C1～C8 の詳細な採点基準
• references/overfitting_checklist.md — 過剰適合を検出するためのヒューリスティクス