trading-agents-research

name	trading-agents-research
description	AUTO-INVOKE when user says ta [ticker], research [ticker], or 研究 [ticker]. Runs the real TradingAgents multi-agent framework (analysts + debate + risk + PM) for a single stock ticker.
references	["scripts/call_trading_agents.py"]

Trading Agents Single Ticker Deep Research

Calls the real TradingAgents multi-agent framework. Runtime ≈ 15-20 minutes.

The script runs in the background and caches the finished report on disk (~/.tradingagents/results/<TICKER>/<date>-report.txt). Your jobs are to (1) confirm the research started, (2) retrieve the cached report with --resend when the user asks for the result (or after ~20 minutes), and (3) handle any error status.

---

HOW TO LAUNCH RESEARCH

Step 1 — Extract the ticker from the user's message (uppercase, strip whitespace). Tell the user: Starting TradingAgents research for <TICKER>. This takes 15-20 minutes — ask me for the result later (e.g. "resend <TICKER>") and I will fetch the finished report.

Step 2 — Call execute_code ONCE with timeout=60. Replace <TICKER> with the uppercase ticker string (e.g. "NVDA"):

import os, importlib.util, sys

script_path = os.path.expanduser("{{SKILLS_DIR}}/trading-agents-research/scripts/call_trading_agents.py")
spec = importlib.util.spec_from_file_location("call_ta_module", script_path)
mod = importlib.util.module_from_spec(spec)
sys.modules["call_ta_module"] = mod
spec.loader.exec_module(mod)

status = mod.run_in_background(<TICKER>)
print(status)

Step 3 — MANDATORY STATUS VALIDATION:

The output MUST start with exactly one of: STARTED:, DONE:, or FAILED:.

• STARTED: → relay to user verbatim. Research is running in background; the report is retrievable later (see below). No further action needed now.
• DONE: → the full report follows the status line — deliver it (see delivery rules below).
• FAILED: → relay verbatim so user sees the error. Do NOT retry automatically.
• Empty or none of the above → reply ONLY with: ERROR: TradingAgents 启动失败（状态行校验未通过）。

---

HOW TO RETRIEVE THE FINISHED REPORT

When the user asks for the result ("resend [ticker]" / "重新发送 [ticker]" / "研究结果好了吗"), fetch it from cache without re-running TA:

import os, importlib.util, sys

script_path = os.path.expanduser("{{SKILLS_DIR}}/trading-agents-research/scripts/call_trading_agents.py")
spec = importlib.util.spec_from_file_location("call_ta_module", script_path)
mod = importlib.util.module_from_spec(spec)
sys.modules["call_ta_module"] = mod
spec.loader.exec_module(mod)

status = mod.run_and_report(<TICKER>, resend=True)
print(status)

Use execute_code with timeout=120 for this call (it only reads cache, no TA run).

• DONE: → the full report follows. Deliver sections 1. FINAL DECISION and 2. TRADING PLAN verbatim; then offer the remaining sections (debate, risk, analyst reports) on request or deliver them in follow-up messages. Do not rewrite or summarise the decision/plan content itself.
• FAILED: No cached result found → research is still running (or was never started). Tell the user to wait, or launch a fresh run if none was started today.

---

Parameters

• ticker: Stock ticker symbol (e.g., "NVDA", "AAPL", "AMD")

Rules

• Call run_in_background exactly ONCE per research request — never loop or retry.
• The result IS cached on disk after every successful run. Use resend to retrieve it — never a fresh run just to re-read a report.
• If you get FAILED:, report the error to the user and stop. Do not retry automatically.
• Never compose research content from memory — 100% of user-facing research comes from the report text printed by the script.