SKILL.md — news-signal 地図・判断基準

プロジェクト概要

ニュース（RSS / X 等）と価格スナップショットを紐付けて収集し、
「イベント → 価格反応」の観測データを貯めることを目的とする。
将来的にシグナル化・Telegram通知へ拡張する。

Phase 5 のゴール（完了）

• collectors/telegram_collector.py: Telethon で公開チャンネルを収集
  • 対象: whale_alert / CoinDesk / cointelegraph / solana_news_official / defipulse
  • StringSession で GitHub Actions 対応（セッションを Secrets で永続化）
  • TELEGRAM_API_ID 未設定時は自動スキップ（main.py に変更不要）
• scripts/telegram_auth.py: ローカル初回認証 → セッション文字列を出力
• main.py: Step 1b として Telegram Collector を追加
• collector.yml: TELEGRAM_API_ID / TELEGRAM_API_HASH / TELEGRAM_SESSION を追加

Phase 4 のゴール（完了）

• notifier/alert.py: 高インパクトイベントを Telegram に通知
  • 条件①: event_type == "hack" AND sentiment_label == "negative"
  • 条件②: event_type == "listing" AND pct_change_1h > 10.0
  • 条件③: abs(pct_change_1h) > 15.0（急騰・急落）
• notified_events テーブル: 送信済み event_id を記録して重複送信を防止
• 初回シードパターン: notified_events が空の場合に全件登録して遡及通知を回避
• dry-run 対応: BOT_TOKEN/CHAT_ID 未設定ではログのみ出力
• message_thread_id でスーパーグループのトピック宛送信（int 変換必須）
• collector.yml に TELEGRAM_TOPIC_NEWS_IMPACT シークレットを追加

Phase 3 のゴール（完了）

• dashboard/build.py: SQLite → docs/data.json 生成（172 events + 統計）
• docs/index.html: Chart.js ダークテーマ静的ダッシュボード
  • event_type 別棒グラフ / タイムラインフィード / カラーバッジ / モバイル対応
• .github/workflows/dashboard_build.yml: 毎時 :10 に自動ビルド → [skip ci] コミット
• GitHub Pages Source: GitHub Actions で公開（Settings → Pages で設定）

Phase 2 のゴール（完了）

• price_impact テーブル: T+5m/15m/1h/4h/24h の価格変化率を計算・保存
• Binance klines で過去時刻の確定価格を取得（Jupiter/DexScreener は直近のみ）
• storage/sheets_sync.py: SQLite → Google Sheets の差分フラッシュ
  • sheets_sync_state で最終 rowid/id を追跡
• .github/workflows/impact_calc.yml: 毎時 :05 に impact_calc + sheets_sync を実行

Phase 1 のゴール（完了）

• VADER 感情分析 + キーワードルールベースで event_type を分類
• events テーブルに sentiment / sentiment_label / event_type カラム追加（ALTER TABLE）
• RSS フィード拡充（rekt.news / Solana 公式）
• main.py の処理順序を rss → sentiment → snapshot に更新
• Jupiter への無駄リトライ排除（Solana CA がある場合のみ使用）

Phase 0 のゴール（完了）

• RSS フィードをポーリングして events テーブルに保存
• 本文から銘柄（シンボル / CA）を抽出し、Jupiter → Binance → DexScreener の順で価格取得
• price_snapshots テーブルに保存
• GitHub Actions で15分ごとに main.py を走らせる
• ローカル動作確認まで（Render 等のデプロイはまだ）

ディレクトリ構成（Phase 5 時点）

news-signal/
├── main.py                     # エントリポイント（RSS→TG→感情分析→価格スナップショット→アラート）
├── requirements.txt
├── .env.example
├── .gitignore
├── .github/
│   └── workflows/
│       ├── collector.yml       # 15分おき: RSS収集 + sentiment + snapshot + alert
│       ├── impact_calc.yml     # 毎時:05: price_impact計算 + Sheets sync
│       └── dashboard_build.yml # 毎時:10: data.json生成 + GitHub Pages デプロイ
│
├── shared/
│   ├── fetch_utils.py          # requests ラッパー + fetch_json
│   └── telegram_utils.py       # get_env / send_message
│
├── storage/
│   ├── db.py                   # SQLite 初期化 + マイグレーション
│   └── sheets_sync.py          # Phase 2: SQLite → Google Sheets 差分フラッシュ
│
├── collectors/
│   ├── rss_collector.py        # feedparser RSS ポーリング（7媒体）
│   └── telegram_collector.py   # Phase 5: Telethon 公開チャンネル収集
│
├── scripts/
│   └── telegram_auth.py        # Phase 5: ローカル初回認証 → セッション文字列生成
│
├── processors/
│   └── sentiment.py            # VADER感情分析 + キーワードevent_type分類
│
├── price/
│   ├── snapshot.py             # T0 価格取得（Binance/Jupiter/DexScreener）
│   └── impact_calculator.py    # Phase 2: T+5m/15m/1h/4h/24h 価格変化率計算
│
├── notifier/                   # Phase 4 追加
│   └── alert.py                # 高インパクトイベント Telegram 通知
│
├── dashboard/                  # Phase 3 追加
│   └── build.py                # SQLite → docs/data.json 生成
│
├── docs/                       # GitHub Pages ルート
│   ├── index.html              # Chart.js ダークテーマダッシュボード
│   └── data.json               # 自動生成（git 管理）
│
├── SKILL.md
├── GOTCHAS.md
└── MASTER_LOG.md

SKILL 設計パターン（該当フェーズ）

• Pipeline: main.py が rss_collector → snapshot を順に実行
• Tool Wrapper: shared/fetch_utils.py が HTTP 取得規約を注入
• Generator: price/snapshot.py が構造化行（symbol/ca/chain/price）を生成

判断基準

• 新しい「外部データ源」追加 → collectors/<name>.py
• 新しい「価格ソース」追加 → price/snapshot.py の fetch_price にフォールバック追加
• スキーマ変更は storage/db.py の SCHEMA を直接更新（マイグレーションは Phase 1 以降）
• 無料枠・読み取りのみの API を優先。鍵が要るものは .env 経由で渡す
• events.event_hash は source|url|title の SHA256。重複排除はこの列で一意化

将来の拡張ポイント（メモ）

• X(Twitter) collector の追加
• LLM による銘柄抽出精度向上（現状は正規表現＋主要ティッカーホワイトリスト）
• rekt.news の代替取得方法（現状 RSS は HTML を返すため feedparser 不可）
• Render へのバックグラウンドワーカー化
• DB を外部ストレージに移行（S3 / R2 / Supabase 等）
• gspread v6 対応（oauth2client → google-auth への移行）