edge-hint-extractor

Edge Hint Extractor

概要

生の観測シグナル（market_summary、anomalies、news reactions）を構造化されたエッジヒントに変換します。 このスキルは、分割されたワークフロー observe -> abstract -> design -> pipeline の最初の段階です。

使用する場面

• 日々の市場観測を、再利用可能なヒントオブジェクトに変換したい場合。
• 現在の異常やニュースのコンテキストに沿った、LLM が生成するアイデアが必要な場合。
• コンセプトの統合や自動検出に使う、クリーンな hints.yaml 入力が必要な場合。

前提条件

• Python 3.9+
• PyYAML
• 検出処理の実行から取得できる任意の入力：
  • market_summary.json
  • anomalies.json
  • news_reactions.csv または news_reactions.json

出力

• 以下を含む hints.yaml：
  • hints リスト
  • 生成メタデータ
  • ルール／LLM ヒント数

ワークフロー

1. 観測ファイル（market_summary、anomalies、任意のニュース反応）を集めます。
2. scripts/build_hints.py を実行して、決定論的なヒントを生成します。
3. 次のいずれかの方法で、LLM のアイデアをヒントに追加できます。
   • a. --llm-ideas-cmd — データを外部 LLM CLI にパイプで渡します（サブプロセス）。
   • b. --llm-ideas-file PATH — YAML ファイルから事前に作成したヒントを読み込みます（Claude が自らヒントを生成する Claude Code ワークフロー向け）。
4. hints.yaml をコンセプトの統合または自動検出に渡します。

注：--llm-ideas-cmd と --llm-ideas-file は同時に指定できません。

クイックコマンド

ルールベースのみ（デフォルトの出力先は reports/edge_hint_extractor/hints.yaml）：

python3 skills/edge-hint-extractor/scripts/build_hints.py \
  --market-summary /tmp/edge-auto/market_summary.json \
  --anomalies /tmp/edge-auto/anomalies.json \
  --news-reactions /tmp/news_reactions.csv \
  --as-of 2026-02-20 \
  --output-dir reports/

ルール＋LLM による追加（外部 CLI）：

python3 skills/edge-hint-extractor/scripts/build_hints.py \
  --market-summary /tmp/edge-auto/market_summary.json \
  --anomalies /tmp/edge-auto/anomalies.json \
  --llm-ideas-cmd "python3 /path/to/llm_ideas_cli.py" \
  --output-dir reports/

ルール＋LLM による追加（事前作成したファイル、Claude Code 向け）：

python3 skills/edge-hint-extractor/scripts/build_hints.py \
  --market-summary /tmp/edge-auto/market_summary.json \
  --anomalies /tmp/edge-auto/anomalies.json \
  --llm-ideas-file /tmp/llm_hints.yaml \
  --output-dir reports/

リソース

• skills/edge-hint-extractor/scripts/build_hints.py
• references/hints_schema.md