| name | tradingagents-analysis |
| version | 0.6.2 |
| description | AstraTrade 的外部重型个股深度分析技能。用于对单只或少量沪深 A 股进行多智能体投研分析,并把结果作为候选池、策略、持仓风控或复盘决策的证据来源。适用于用户明确要求个股深度分析、持仓复核、候选验证、买卖条件评估或风险复盘的场景。 |
| tags | ["A股","个股分析","深度投研","持仓复核","候选验证","风险评估"] |
| required_env_vars | ["TRADINGAGENTS_TOKEN"] |
| optional_env_vars | ["TRADINGAGENTS_API_URL","POLL_INTERVAL","POLL_TIMEOUT"] |
| credentials | [{"type":"api_token","name":"TRADINGAGENTS_TOKEN","description":"TradingAgents API 访问令牌"}] |
TradingAgents 个股深度分析
本 Skill 用于在 AstraTrade 中调用外部 TradingAgents 分析服务,对指定 A 股做深度研判。它是一个重型证据工具,不是交易执行器;分析结果必须与工作空间状态、风控规则和其他数据源共同使用。
适用场景
适合使用:
- 用户明确要求分析某只 A 股是否值得关注、买入、卖出、继续持有或加入候选池。
- 主 Agent 需要对候选股、持仓股或已有策略做二次验证。
- 盘后复盘、风险复核、重要事件后的个股再评估。
- 需要获得技术面、基本面、情绪、资金流向、宏观和风险维度的综合结论。
不适合使用:
- 全市场扫描或大批量选股;这类任务优先使用
stock-ranker。
- 分钟级盘中盯盘、超短线即时交易或实时成交决策。
- 非 A 股市场、加密货币、美股等标的。
- 绕过 AstraTrade 风控规则直接生成或执行交易。
输入规则
从用户任务或工作空间上下文中只提取必要参数:
symbol:股票名称或代码,例如 贵州茅台、600519.SH、宁德时代。
trade_date:分析日期。用户未指定时使用当前日期或当前交易日。
horizons:分析周期。未指定时使用 short;波段或更完整复核可使用 medium;需要多周期交叉验证时使用逗号分隔,例如 short,medium。
不要把用户完整对话、账户隐私、真实持仓明细或无关本地文件内容传给外部服务。脚本只需要股票标的、日期和周期参数。
调用方式
AstraTrade Agent 使用 exec 工具调用脚本。exec.cwd 默认以 workspace/ 为基准,因此脚本路径应写成:
{
"type": "tool_call",
"tool": "exec",
"args": {
"command": "bash skills/tradingagents-analysis-0.6.2/scripts/analyze.sh 贵州茅台 2026-05-26 short",
"cwd": "."
},
"reason": "调用 TradingAgents 获取贵州茅台的深度分析"
}
常用命令:
bash skills/tradingagents-analysis-0.6.2/scripts/analyze.sh 贵州茅台
bash skills/tradingagents-analysis-0.6.2/scripts/analyze.sh 600519.SH 2026-05-26 short
bash skills/tradingagents-analysis-0.6.2/scripts/analyze.sh 600519.SH 2026-05-26 short,medium
bash skills/tradingagents-analysis-0.6.2/scripts/analyze.sh 贵州茅台,比亚迪,宁德时代 2026-05-26 short
脚本会自动完成提交任务、轮询状态和获取结果。不要手写 curl 轮询循环,也不要把 API 调用逻辑复制到 prompt 中。
执行约束
- 深度分析通常耗时 10 到 20 分钟,只对单只或少量标的使用。
- 批量分析只用于少量明确标的,通常不超过 3 只。
- 轮询间隔由
POLL_INTERVAL 控制,默认 15 秒;最大等待时间由 POLL_TIMEOUT 控制,默认 1200 秒。
- 缺少
TRADINGAGENTS_TOKEN 时,停止调用并说明需要配置凭证,不得编造结果。
- 网络错误、任务失败或超时时,保留错误信息和
job_id,并根据任务需要改用 mx-data、mx-search 或稍后复查。
结果处理
脚本返回 JSON 后,先提取对决策有用的字段,再结合 AstraTrade 工作空间状态判断下一步:
- 结论:
decision、direction、confidence。
- 价格与条件:目标价、止损价、关键触发条件。
- 风险:
risk_items、负面因素、失效条件。
- 依据:技术面、基本面、资金、情绪、事件或宏观相关证据。
- 备注:
final_trade_decision 或等价的最终分析文本。
面向用户或最终结果时,用中文给出简洁摘要,重点说明:
- 分析结论及置信度。
- 支撑结论的 3 到 5 条关键依据。
- 主要风险和需要继续验证的数据。
- 对候选、持仓、策略或复盘的建议动作。
不要原样倾倒大段 JSON;除非用户明确要求查看原始返回。
与工作空间的关系
TradingAgents 的结果只能作为外部证据,不能单独触发交易。涉及工作空间写入时必须遵守 AstraTrade 文件协议:
- 写入
pools/candidates.jsonl、pools/strategies.jsonl、pools/holdings.jsonl、logs/events.jsonl 或 logs/trades.jsonl 前,必须先使用 astra-trade-schema 读取对应 schema reference。
- JSONL 文件只能追加或精确编辑,不得直接覆盖。
- 买入、卖出、调仓、策略变更必须先读取账户、持仓、策略和风控状态。
- 若分析结果改变了重要判断,可以把它作为 evidence 写入候选、策略或事件记录,来源标记为
tradingagents-analysis。
- 若只是回答用户研究问题且不需要更新状态,不要强行写入工作空间。
安全说明
- 外部发送范围仅限
symbol、trade_date、horizons。
TRADINGAGENTS_TOKEN 只通过环境变量读取,不得写入日志、报告或用户可见内容。
- 本 Skill 输出不构成投资建议,也不能替代用户对行情、账户、风险和交易规则的独立核验。