Edge Concept Synthesizer

Overview

検出とストラテジ実装の間に抽象化レイヤーを作成します。 このスキルはチケット証拠をクラスタリングし、繰り返し発生する条件を要約し、明示的なテーゼと無効化ロジックを含む edge_concepts.yaml を出力します。

When to Use

• 多数の生のチケットがあり、メカニズムレベルの構造が必要な場合
• チケットからストラテジへの直接的な過学習を避けたい場合
• ストラテジドラフト前にコンセプトレベルのレビューが必要な場合

Prerequisites

• Python 3.9+
• PyYAML
• 検出器出力からのチケット YAML ディレクトリ (tickets/exportable, tickets/research_only)
• オプション: hints.yaml

Output

以下を含む edge_concepts.yaml:

• コンセプトクラスタ
• サポート統計
• 抽象的なテーゼ
• 無効化シグナル
• エクスポート準備完了フラグ

Workflow

1. 自動検出出力からチケット YAML ファイルを収集します。
2. オプションでコンテキストマッチングのための hints.yaml を提供します。
3. scripts/synthesize_edge_concepts.py を実行します。
4. コンセプトの重複排除: 同じ仮説を持つコンセプトを条件の重複でマージします(包含度 > しきい値)。
5. コンセプトをレビューし、高サポートのコンセプトのみをストラテジドラフト段階に昇格させます。

Quick Commands

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --min-ticket-support 2

# With hint promotion and synthetic cap
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --hints /tmp/edge-hints/hints.yaml \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --promote-hints \
  --max-synthetic-ratio 1.5

# With custom dedup threshold (or disable dedup)
python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --overlap-threshold 0.6

python3 skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py \
  --tickets-dir /tmp/edge-auto/tickets \
  --output /tmp/edge-concepts/edge_concepts.yaml \
  --no-dedup

Resources

• skills/edge-concept-synthesizer/scripts/synthesize_edge_concepts.py
• references/concept_schema.md