edge-candidate-agent

Edge Candidate Agent

概述

将每日市场观察转化为可复现的研究工单和兼容 Phase I 的候选项规格。 优先考虑信号质量和接口兼容性，而非激进地扩充策略数量。 此技能可独立端到端运行，但在拆分工作流中主要用于最终导出和验证阶段。

适用场景

• 将市场观察、异常或假设转化为结构化研究工单。
• 运行每日自动检测，从 EOD OHLCV 和可选提示中发现新的 Edge 候选项。
• 将已验证的工单导出为 strategy.yaml + metadata.json，供 trade-strategy-pipeline Phase I 使用。
• 在管道执行前，对 edge-finder-candidate/v1 运行预检兼容性检查。

前置条件

• 安装了 PyYAML 的 Python 3.9+。
• 可访问目标 trade-strategy-pipeline 仓库，以进行架构和阶段验证。
• 使用 --pipeline-root 运行由管道管理的验证时，需确保 uv 可用。

输出

• strategies/<candidate_id>/strategy.yaml：兼容 Phase I 的策略规格。
• strategies/<candidate_id>/metadata.json：来源元数据，包含接口版本和工单上下文。
• scripts/validate_candidate.py 的验证状态（通过/失败 + 原因）。
• 每日检测产物：
  • daily_report.md
  • market_summary.json
  • anomalies.json
  • watchlist.csv
  • tickets/exportable/*.yaml
  • tickets/research_only/*.yaml

在拆分工作流中的位置

推荐的拆分工作流：

1. skills/edge-hint-extractor：观察/新闻 -> hints.yaml
2. skills/edge-concept-synthesizer：工单/提示 -> edge_concepts.yaml
3. skills/edge-strategy-designer：概念 -> strategy_drafts + 可导出的工单 YAML
4. skills/edge-candidate-agent（此技能）：为移交给管道做导出和验证

工作流

1. 从 EOD OHLCV 运行自动检测：
   • skills/edge-candidate-agent/scripts/auto_detect_candidates.py
   • 可选：使用 --hints 提供人工构思的输入
   • 可选：使用 --llm-ideas-cmd 运行外部 LLM 构思循环
2. 加载契约和映射参考资料：
   • references/pipeline_if_v1.md
   • references/signal_mapping.md
   • references/research_ticket_schema.md
   • references/ideation_loop.md
3. 使用 references/research_ticket_schema.md 创建或更新研究工单。
4. 使用 skills/edge-candidate-agent/scripts/export_candidate.py 导出候选项产物。
5. 使用 skills/edge-candidate-agent/scripts/validate_candidate.py 验证接口和 Phase I 约束。
6. 将候选项目录移交给 trade-strategy-pipeline，并先运行 dry-run。

快速命令

每日自动检测（可选导出/验证）：

python3 skills/edge-candidate-agent/scripts/auto_detect_candidates.py \
  --ohlcv /path/to/ohlcv.parquet \
  --output-dir reports/edge_candidate_auto \
  --top-n 10 \
  --hints path/to/hints.yaml \
  --export-strategies-dir /path/to/trade-strategy-pipeline/strategies \
  --pipeline-root /path/to/trade-strategy-pipeline

根据工单创建候选项目录：

python3 skills/edge-candidate-agent/scripts/export_candidate.py \
  --ticket path/to/ticket.yaml \
  --strategies-dir /path/to/trade-strategy-pipeline/strategies

仅验证接口契约：

python3 skills/edge-candidate-agent/scripts/validate_candidate.py \
  --strategy /path/to/trade-strategy-pipeline/strategies/my_candidate_v1/strategy.yaml

验证接口契约以及管道架构/阶段规则：

python3 skills/edge-candidate-agent/scripts/validate_candidate.py \
  --strategy /path/to/trade-strategy-pipeline/strategies/my_candidate_v1/strategy.yaml \
  --pipeline-root /path/to/trade-strategy-pipeline \
  --stage phase1

导出规则

• 保留 validation.method: full_sample。
• 保持省略 validation.oos_ratio 或将其设为 null。
• v1 仅导出支持的入场类型：
  • pivot_breakout 搭配 vcp_detection
  • gap_up_continuation 搭配 gap_up_detection
• 在工单备注中将不支持的假设类型标记为仅供研究，不要将其作为可导出的候选项。

防护措施

• 拒绝违反架构边界的候选项（风险、退出条件、空条件）。
• 如果文件夹名称与 id 不匹配，则拒绝候选项。
• 要求元数据具有确定性，并包含 interface_version: edge-finder-candidate/v1。
• 在完整执行前，先在管道中使用 --dry-run。

资源

skills/edge-candidate-agent/scripts/export_candidate.py

根据研究工单 YAML 生成 strategies/<candidate_id>/strategy.yaml 和 metadata.json。

skills/edge-candidate-agent/scripts/validate_candidate.py

运行接口检查；也可选择针对 trade-strategy-pipeline 运行 StrategySpec/validate_spec 检查。

skills/edge-candidate-agent/scripts/auto_detect_candidates.py

从每日收盘 OHLCV 数据中自动检测边缘想法，生成可导出的研究工单，并可选择自动导出和验证。

references/pipeline_if_v1.md

edge-finder-candidate/v1 的精简集成契约。

references/signal_mapping.md

将假设类别映射到当前可导出的信号类别。

references/research_ticket_schema.md

export_candidate.py 使用的工单架构。

references/ideation_loop.md

提示架构和外部大模型构思命令契约。