wenyupapa-sys/tradingagents-codex-skill

TradingAgents Codex

概要

このスキルを使用して、ローカルの TradingAgents_codex プロジェクトをエンジニアリングワークフローとして実行および要約します。セットアップチェック、ドライランコマンド構築、フルチェーン分析の実行、レポートの要約を行います。

デフォルトのローカルプロジェクト:

~/TradingAgents_codex

--project または TRADINGAGENTS_PROJECT で上書きできます。

トリガー

このスキルは以下のようなリクエストで使用します:

• "QQQ で TradingAgents を実行"
• "全エージェントで TSLA を分析"
• "codex-analyze を実行"
• "TradingAgents レポートを要約"
• "TradingAgents Codex CLI を検証"
• "バッチ株/ETF 分析"
• "QQQ と TSLA の TradingAgents 出力を比較"

ワークフロー

1. ティッカー、分析日、出力言語、ユーザーがフルチェーンか --analysts-only かを特定します。
2. 現在のセッションで検証済みでない限り、実際の分析前にセットアップ検証を実行します:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/check_setup.py"

3. 実行が高コスト、バッチ処理、または日付に依存する場合は、コマンドをドライランします:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/run_analysis.py" \
  --ticker QQQ --ticker TSLA \
  --date 2026-05-08 \
  --output-language English \
  --dry-run

4. フルチェーン分析を実行します。ティッカーは逐次実行され、--max-parallel は TradingAgents に渡されて内部ロールの並列化に使用されます。

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/run_analysis.py" \
  --ticker QQQ --ticker TSLA \
  --date 2026-05-08 \
  --model gpt-5.5 \
  --reasoning-effort high \
  --output-language English \
  --confirm

5. reports/portfolio_manager.json から最終的なポートフォリオ決定を要約します:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/summarize_report.py" \
  --ticker QQQ \
  --date 2026-05-08

デフォルト設定

• モデル: gpt-5.5
• 推論努力: high
• アナリスト: market,news,social,fundamentals
• 検索: 有効
• 出力言語: Chinese
• ティッカーあたりのタイムアウト: 3600秒
• 最新日付のフォールバック: 前回の米国取引日（完了したもの）。週末はスキップ。

速度を重視する場合は、--output-language English を推奨し、ユーザーに中国語の要約を提供します。中国語出力は各ロールレポートの翻訳にかなりの時間を要する場合があります。

安全性

• 出力は調査結果の要約とみなし、投資アドバイスではありません。
• このスキルから取引を実行したり、注文を送信したり、証券会社の実行に接続したりしないでください。
• 欠落している価格、ソーシャルデータ、ETFファンダメンタルズ、最新のOHLC行を作成しないでください。
• 既知のデータギャップ（特にETFファンダメンタルズや分析日当日の市場データ行の欠落）について言及してください。
• 大規模バッチの前には --dry-run を使用してください。ランナーは3ティッカーを超える場合に --confirm を必要とします。
• 子プロセスとなるTradingAgents/Codex CLIコマンドでは、常に NODE_OPTIONS をクリアしてください。このプロジェクトには既知の --use-env-proxy 障害があります。

スクリプト

• scripts/check_setup.py: プロジェクトパス、virtualenv CLI、必須フラグ、UTF-8ロケール、NODE_OPTIONS 回避策を検証します。
• scripts/run_analysis.py: tradingagents codex-analyze コマンドを構築・実行します。ドライラン、タイムアウト、バッチ確認をサポートします。
• scripts/summarize_report.py: portfolio_manager.json を読み取り、中国語のMarkdownまたはJSON要約を出力します。
• scripts/quick_validate.py: 実際の分析を実行せずにスキルの構造とスクリプトを検証します。

参考情報

コマンド例と運用上の選択については references/workflow.md を参照してください。既知の障害と回避策については references/troubleshooting.md を参照してください。