介绍
# Cryptocurrency Trading Agent Skill
## 目的
提供具备数学严谨性、多层验证和全面风险评估的生产级加密货币交易分析。专为实际交易应用而设计，通过 6 阶段验证管道实现零幻觉容忍。
## 何时使用此技能
当用户请求以下内容时使用此技能： - 分析特定加密货币交易对（例如 BTC/USDT, ETH/USDT） - 市场扫描以寻找最佳交易机会 - 基于概率建模的综合风险评估 - 具备高级模式识别的交易信号 - 专业的风险指标（VaR, CVaR, Sharpe, Sortino） - 用于场景分析的蒙特卡洛模拟 - 用于信号置信度的贝叶斯概率计算
## 核心能力
### 验证与准确性 - 具备零幻觉容忍度的 6 阶段验证管道 - 统计异常检测（Z-score, IQR, Benford's Law） - 跨多个时间周期的交叉验证 - 14 个熔断机制以防止无效信号
### 分析方法 - 用于概率计算的贝叶斯推断 - 蒙特卡洛模拟（10,000 个场景） - GARCH 波动率预测 - 高级图表形态识别 - 多时间周期共识（15m, 1h, 4h）
### 风险管理 - 风险价值 和条件风险价值 (CVaR) - 风险调整后指标（Sharpe, Sortino, Calmar） - 凯利准则仓位计算 - 自动止损和止盈计算
**详细能力：** 请参阅 `references/advanced-capabilities.md`
## 先决条件
在使用此技能之前，请确保满足以下条件： 1. 可用 Python 3.8+ 环境 2. 用于获取实时市场数据的互联网连接 3. 已安装所需包：`pip install -r requirements.txt` 4. 已知用户账户余额以便计算仓位
## 如何使用此技能
### 快速开始命令
**分析特定加密货币：** ```bash python skill.py analyze BTC/USDT --balance 10000 ```
**扫描市场寻找最佳机会：** ```bash python skill.py scan --top 5 --balance 10000 ```
**交互式探索模式：** ```bash python skill.py interactive --balance 10000 ```
### 默认参数
- **余额：** 如果用户未指定，使用 `--balance 10000` - **时间周期：** 15m, 1h, 4h（自动分析） - **每笔交易风险：** 余额的 2%（默认强制执行） - **最小风险/回报：** 1.5:1（由熔断机制验证）
### 常见交易对
主要：BTC/USDT, ETH/USDT, BNB/USDT, SOL/USDT, XRP/USDT AI 代币：RENDER/USDT, FET/USDT, AGIX/USDT Layer 1：ADA/USDT, AVAX/USDT, DOT/USDT Layer 2：MATIC/USDT, ARB/USDT, OP/USDT DeFi：UNI/USDT, AAVE/USDT, LINK/USDT Meme：DOGE/USDT, SHIB/USDT, PEPE/USDT
### 工作流程
1. **收集信息** - 询问用户交易对（如果分析特定代币） - 询问账户余额（或使用默认的 $10,000） - 确认用户需要生产级分析
2. **执行分析** - 运行适当的命令（analyze, scan 或 interactive） - 等待综合分析完成 - 系统自动通过 6 个阶段进行验证
3. **展示结果** - 显示交易信号（LONG/SHORT/NO_TRADE） - 显示置信度水平和执行就绪状态 - 解释入场、止损和止盈价格 - 展示风险指标和仓位计算 - 突出显示验证状态（6/6 通过 = 准备执行）
4. **解读输出** - 参阅 `references/output-interpretation.md` 获取详细指导 - 将技术指标转化为用户友好的语言 - 用简单的术语解释风险/回报 - 始终包含风险警告
5. **处理边缘情况** - 如果 execution_ready = NO：解释验证失败原因 - 如果 confidence <40%：建议等待更好的机会 - 如果触发熔断机制：解释具体问题 - 如果网络错误：建议使用指数退避重试
### 输出结构
**交易信号：** - Action（操作）：LONG/SHORT/NO_TRADE - Confidence（置信度）：0-95%（仅整数，无虚假精度） - Entry Price（入场价格）：推荐的入场点 - Stop Loss（止损）：风险管理退出点（始终必需） - Take Profit（止盈）：利润目标 - Risk/Reward（风险/回报）：最低 1.5:1 比率
**概率分析：** - 贝叶斯概率（看涨/看跌） - 蒙特卡洛盈利概率 - 信号强度（WEAK/MODERATE/STRONG） - 形态倾向确认
**风险评估：** - VaR 和 CVaR（风险价值指标） - Sharpe/Sortino/Calmar 比率 - 最大回撤和胜率 - 盈利因子
**仓位计算：** - 标准（2% 风险规则）- 推荐 - 凯利保守 - 数学最优 - 凯利激进 - 更高风险/回报 - 交易费用估算
**验证状态：** - 已通过阶段（必须为 6/6 才能准备执行） - 触发的熔断机制（如有） - 警告和关键失败
**详细解读：** 请参阅 `references/output-interpretation.md`
## 向用户展示结果
### 语言指南
使用适合初学者的解释： - "LONG" → "现在买入，以后卖出" - "SHORT" → "现在卖出，以后更低买回" - "Stop Loss" → "如果判断错误自动退出以限制损失" - "Confidence %" → "我们的把握程度（越高越好）" - "Risk/Reward" → "每承担 $1 风险，潜在的 $X 利润"
### 必需的风险警告
始终包含这些提醒： - 市场是不可预测的 - 完美的分析也可能是错的 - 从小额资金开始学习 - 每笔交易风险切勿超过 2%（自动强制执行） - 始终使用止损 - 这是分析，而非财务建议 - 过往表现并不保证未来结果 - 用户对所有交易决策负全责
### 何时不交易
建议用户在以下情况下避免交易： - 验证状态 < 6/6 通过 - 执行就绪标志 = NO - 中等信号置信度 < 60%，强信号 < 70% - 用户不理解分析内容 - 用户无法承受潜在损失 - 情绪压力大或疲劳
## 高级用法
### 程序化集成
对于自定义工作流，直接导入： ```python from scripts.trading_agent_refactored import TradingAgent
agent = TradingAgent(balance=10000) analysis = agent.comprehensive_analysis('BTC/USDT') print(analysis['final_recommendation']) ```
参阅 `example_usage.py` 获取 5 个综合示例。
### 配置
通过 `config.yaml` 自定义行为： - 验证严格程度（严格模式 vs 普通模式） - 风险参数（最大风险，仓位限制） - 熔断阈值 - 时间周期偏好
### 测试
验证安装和功能： ```bash # Run compatibility test ./test_claude_code_compat.sh
# Run comprehensive tests python -m pytest tests/ ```
## 参考文档
- `references/advanced-capabilities.md` - 详细的技术能力 - `references/output-interpretation.md` - 全面的输出指南 - `references/optimization.md` - 交易优化策略 - `references/protocol.md` - 使用协议和最佳实践 - `references/psychology.md` - 交易心理学原则 - `references/user-guide.md` - 终端用户文档 - `references/technical-docs/` - 实现细节和错误报告
## 架构
**核心模块：** - `scripts/trading_agent_refactored.py` - 主交易代理（生产环境） - `scripts/advanced_validation.py` - 多层验证系统 - `scripts/advanced_analytics.py` - 概率建模引擎 - `scripts/pattern_recognition_refactored.py` - 图表形态识别 - `scripts/indicators/` - 技术指标计算 - `scripts/market/` - 数据提供商和市场扫描器 - `scripts/risk/` - 仓位计算和风险管理 - `scripts/signals/` - 信号生成和推荐
**入口点：** - `skill.py` - 命令行界面（推荐） - `__main__.py` - Python 模块调用 - `example_usage.py` - 程序化用法示例
## 版本
**v2.0.1 - 生产硬化版**
最近的改进： - 修复了关键错误（除以零、导入路径、NaN 处理） - 增强了带有指数退避的网络重试逻辑 - 改进了日志记录基础设施 - 全面的输入验证 - UTC 时区一致性 - Benford's Law 阈值优化
**状态：** 🟢 生产就绪
完整变更日志请参阅 `references/technical-docs/FIXES_APPLIED.md`。
## 故障排除
**安装问题：** ```bash pip install --upgrade pip pip install -r requirements.txt ```
**导入错误：** 确保从技能目录运行或使用 `skill.py` 入口点。
**网络故障：** 系统会自动使用指数退避进行重试（3 次尝试）。
**验证失败：** 检查输出中的验证报告 - 解释了哪个阶段失败以及原因。
**用于详细调试：** 在 `config.yaml` 中启用日志记录或检查 `references/technical-docs/BUG_ANALYSIS_REPORT.md`