| name | ftd-detector |
| description | 检测Follow-Through Day（FTD）信号以确认市场底部，采用William O'Neil的方法论。双指数跟踪（S&P 500 + NASDAQ），使用状态机进行反弹尝试、FTD确认和FTD后健康监控。当用户询问市场底部信号、Follow-Through Day、反弹尝试、调整后的重新入场时机，或是否可以安全增加股票仓位时使用。与market-top-detector（防御性）互补——本技能为进攻性（底部确认）。 |
| allowed-tools | ["Bash(python3:*)"] |
FTD检测器技能
目的
检测确认市场底部的Follow-Through Day（FTD）信号，采用William O'Neil经过验证的方法论。生成质量评分（0-100），并提供重新进入市场的仓位建议。
与Market Top Detector互补：
- Market Top Detector = 防御性（检测派发、轮动、恶化）
- FTD Detector = 进攻性（检测反弹尝试、底部确认）
何时使用本技能
英文：
- User asks "Is the market bottoming?" or "Is it safe to buy again?"
- User observes a market correction (3%+ decline) and wants re-entry timing
- User asks about Follow-Through Days or rally attempts
- User wants to assess if a recent bounce is sustainable
- User asks about increasing equity exposure after a correction
- Market Top Detector shows elevated risk and user wants bottom signals
中文：
- "市场见底了吗？""可以重新买入了吗？"
- 调整行情（3%以上的下跌）后的入场时机判断
- 关于Follow-Through Day或反弹尝试的问题
- 想要评估近期反弹是否可持续
- 调整后是否应增加仓位的判断
- Market Top Detector显示高风险后，确认底部信号
与Market Top Detector的区别
| 方面 | FTD Detector | Market Top Detector |
|---|
| 关注点 | 底部确认（进攻性） | 顶部检测（防御性） |
| 触发条件 | 市场调整（3%+下跌） | 市场处于/接近高点 |
| 信号 | 反弹尝试 → FTD → 重新入场 | 派发 → 恶化 → 退出 |
| 评分 | 0-100 FTD质量 | 0-100 顶部概率 |
| 行动 | 何时增加仓位 | 何时减少仓位 |
执行工作流
第一阶段：执行Python脚本
运行FTD检测器脚本：
python3 skills/ftd-detector/scripts/ftd_detector.py --api-key $FMP_API_KEY
脚本将执行以下操作：
- 从FMP API获取S&P 500和QQQ的历史数据（60+个交易日）
- 获取两个指数的当前报价
- 运行双指数状态机（调整 → 反弹 → FTD检测）
- 评估FTD后的健康状况（派发日、失效、强势趋势）
- 计算质量评分（0-100）
- 生成JSON和Markdown报告
API预算： 4次调用（完全在免费层250次/天的范围内）
第二阶段：展示结果
向用户展示生成的Markdown报告，重点说明：
- 当前市场状态（调整、反弹尝试、FTD已确认等）
- 质量评分和信号强度
- 建议的仓位水平
- 关键观察水平（摆动低点、FTD当日低点）
- FTD后的健康状况（派发日、强势趋势）
第三阶段：情境化指导
根据市场状态提供额外指导：
如果FTD已确认（评分60+）：
- 建议关注处于正确形态的领涨股
- 参考CANSLIM筛选器寻找候选股票
- 提醒注意仓位大小和止损
如果处于反弹尝试阶段（第1-3天）：
- 建议耐心等待，不要在FTD之前买入
- 建议构建观察列表
如果没有调整：
- FTD分析在上升趋势中不适用
- 转向Market Top Detector获取防御性信号
状态机
NO_SIGNAL → CORRECTION → RALLY_ATTEMPT → FTD_WINDOW → FTD_CONFIRMED
↑ ↓ ↓ ↓
└── RALLY_FAILED ←─────────────┘ FTD_INVALIDATED
| 状态 | 定义 |
|---|
| NO_SIGNAL | 上升趋势，无符合条件的调整 |
| CORRECTION | 3%+的下跌，伴随3+个下跌日 |
| RALLY_ATTEMPT | 从摆动低点开始的第1-3天反弹 |
| FTD_WINDOW | 第4-10天，等待符合条件的FTD |
| FTD_CONFIRMED | 检测到有效的FTD信号 |
| RALLY_FAILED | 反弹跌破摆动低点 |
| FTD_INVALIDATED | 收盘价低于FTD当日低点 |
质量评分（0-100）
| 评分 | 信号 | 仓位 |
|---|
| 80-100 | 强FTD | 75-100% |
| 60-79 | 中等FTD | 50-75% |
| 40-59 | 弱FTD | 25-50% |
| <40 | 无FTD / 失败 | 0-25% |
API要求
必需： FMP API密钥（免费层即可：每次执行4次调用）
输出文件
- JSON:
ftd_detector_YYYY-MM-DD_HHMMSS.json
- Markdown:
ftd_detector_YYYY-MM-DD_HHMMSS.md
参考文档
references/ftd_methodology.md
- O'Neil的FTD规则详解
- 反弹尝试机制和天数计算
- 历史FTD案例（2020年3月、2022年10月）
references/post_ftd_guide.md
- FTD后派发日失败率
- 强势趋势（Power Trend）的定义和条件
- 成功与失败模式对比
何时加载参考文档
- 首次使用： 加载
ftd_methodology.md 以全面理解
- FTD后的问题： 加载
post_ftd_guide.md
- 常规执行： 无需参考文档——脚本会处理分析
