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을 사용하십시오. 러너는 세 개 이상의 티커에 대해 --confirm이 필요합니다.
• 하위 TradingAgents/Codex CLI 명령에 대해 항상 NODE_OPTIONS를 지우십시오. 이 프로젝트에는 알려진 --use-env-proxy 실패가 있습니다.

스크립트

• scripts/check_setup.py: 프로젝트 경로, 가상 환경 CLI, 필수 플래그, UTF-8 로케일 및 NODE_OPTIONS 해결 방법을 확인합니다.
• scripts/run_analysis.py: 드라이런, 시간 초과 및 배치 확인과 함께 tradingagents codex-analyze 명령을 구성하고 실행합니다.
• scripts/summarize_report.py: portfolio_manager.json을 읽고 중국어 마크다운 또는 JSON 요약을 출력합니다.
• scripts/quick_validate.py: 라이브 분석을 실행하지 않고 스킬 구조와 스크립트를 확인합니다.

참고

명령 예제 및 운영 선택 사항은 references/workflow.md를 읽으십시오. 알려진 실패 및 완화 방법은 references/troubleshooting.md를 읽으십시오.