watchlist-manager

ウォッチリスト管理（米国市場）

price-alerts および watchlist-brief のスキルが読み込む、信頼できる唯一の情報源となるウォッチリストファイルを管理します。 情報提供のみを目的とするツールです。**取引の発注、変更、キャンセルは決して行いません。**ウォッチリストの編集は取引ではありません。

ファイルの場所

1. $WATCHLIST_FILE が設定されている場合はそのファイルを使用し、設定されていない場合は作業ディレクトリ内の ./watchlist.json を使用します（PyYAML がインストールされていれば YAML の watchlist.yaml も使用できます）。
2. いずれも存在しない場合は、空の tickers リストを含む examples/watchlist.json の構造をもとに作成します。既存ファイルを上書きする前に確認してください。

スキーマ（バージョン1）

{
  "version": 1,
  "settings": { "cooldown_minutes": 240, "rearm_pct": 0.5, "sessions": ["regular"],
                "volume_spike_multiple": 2.0, "near_52w_pct": 2.0, "earnings_days": 3,
                "max_alerts_per_run": 20, "extra_closures": [], "stale_after_seconds": 900 },
  "tickers": [{
    "symbol": "NVDA",            // required, uppercase; class shares as BRK.B or BRK-B
    "side": "long",              // long | short | watch
    "added": "2026-10-15",
    "thesis": "AI datacenter capex",
    "entry": 160.0, "targets": [190.0, 220.0], "stop": 140.0,
    "tags": ["ai", "semis"],
    "alerts": [ {"type": "price_below", "value": 150, "cooldown_minutes": 60} ],
    "notes": ""
  }]
}

アラートの type 値とその value の意味は、skills/price-alerts/SKILL.md に記載されています。 stop を設定すると stop_hit アラートが自動的に設定され、targets を設定すると target_hit アラートが自動的に設定されます。

操作（スクリプトの使用を推奨。検証後、アトミックに書き込みます）

リポジトリのルート（またはこのスキルがインストールされている場所。スクリプトは scripts/ にあります）から実行します。

python scripts/watchlist.py add NVDA --thesis "AI capex" --entry 160 --target 190 --target 220 --stop 140 --tag ai --tag semis --alert price_below:150
python scripts/watchlist.py update NVDA --stop 145
python scripts/watchlist.py update NVDA --tag megacap --alert rsi_above:75 --append
python scripts/watchlist.py remove NVDA
python scripts/watchlist.py list [--tag semis]
python scripts/watchlist.py show NVDA
python scripts/watchlist.py validate

Python が利用できない場合は、スキーマと以下の検証ルールに従って JSON を手動で編集します。

ワークフロー

1. ティッカーを確定します。 大文字にします。ユーザーが企業名を指定した場合は、シンボルを確認します（例：「Alphabet」→ GOOGL と GOOG のどちらですか？）。米国以外の上場銘柄は拒否するか、デフォルトのデータでは対応していないことを伝えます。
2. ライブ価格で妥当性を確認します：python scripts/quotes.py NVDA。ロングでストップが価格を上回る場合（またはターゲットが価格を下回る場合）は、その点を伝えて確認します。
3. 理由を確認します。 投資理由が示されていない場合は、1行で理由を尋ねます。回答を断られた場合は "" を保存します。投資理由を作り上げてはいけません。
4. アラートは提案し、押し付けないでください。 提案する妥当なデフォルト値は、ストップ／ターゲットの水準、earnings_within: 3、pct_move: 5 です。ボラティリティまたは当日のレンジについてユーザーから質問があった場合に限り、iv_above／intraday_range_pct に触れます。また、ATM IV は公式データではなく Yahoo のデータであり、IV ランクではないことを伝えます。ユーザーが同意したものだけを追加します。
5. 書き込み、検証、確認を行います。 作成したエントリー（シンボル、エントリー、ストップ、ターゲット、アラート）を簡潔な1行で提示します。

検証ルール

• シンボルは ^[A-Z]{1,5}([.-][A-Z]{1,2})?$ に一致し、重複がないこと。
• entry、stop、targets[] は数値であること。side: long の場合は stop < entry、side: short の場合は stop > entry であること。
• settings.sessions が存在する場合、regular／pre／after のいずれかを含む空でないリストであること。
• settings.extra_closures が存在する場合、予定外の終日休場日を表す ISO 日付（YYYY-MM-DD）であること。
• すべてのアラートの type が既知のタイプであること。

表示形式

簡潔な表を使用します：ティッカー | 売買方向 | エントリー | ストップ | ターゲット | タグ | 投資理由。ユーザーから求められた場合、またはすでに価格を取得している場合に限り、ライブ価格の列を追加します。

禁止事項

• 明示的な指示なしにティッカーを削除してはいけません。「リストを整理して」と言われた場合は、先に削除候補を提示します。
• 買い／売りの推奨をしてはいけません。水準やリスク（例：「ストップはエントリーより12％低い」）の説明は可能です。