用途：按 Mark Minervini 的波动收缩形态（VCP）筛选标普500股票，识别处于第二阶段上升趋势、波动收敛并接近突破枢轴点的标的，用于寻找定义风险的突破候选股。
主要能力：三阶段流水线。预筛选基于报价数据（价格、成交量、52周位置）；趋势模板执行七点第二阶段过滤，使用260日历史；VCP检测进行形态分析、评分和报告生成。输出结构化 JSON 和可读 Markdown 报告，包含综合评分、执行状态、形态类型、收缩细节（T1/T2/T3深度与比率）、枢轴价、止损、风险百分比、成交量比率与相对强度排名。
使用方式：需设置 FMP_API_KEY 环境变量或传入 --api-key。默认筛选标普500前100候选（免费层250次/天足够）；完整标普500需付费层。常用命令： python3 skills/vcp-screener/scripts/screen_vcp.py --output-dir skills/vcp-screener/scripts 自定义universe 可加 --universe 代码列表；--full-sp500 全量；--strict 仅返回有效VCP且状态为 Pre-breakout 或 Breakout 的股票。可调参数包括 --min-contractions、--t1-depth-min、--breakout-volume-ratio、--trend-min-score、--atr-multiplier、--contraction-ratio、--min-contraction-days、--lookback-days 等。
适用场景：用户要求 VCP 或 Minervini 式形态筛选、寻找紧密基底/波动收缩形态、第二阶段动量股扫描、含明确风险的突破候选。
限制：依赖 FMP API 及密钥与调用额度；默认筛选与完整筛选的可用范围受账户层级影响；形态识别与评分基于历史数据，不构成投资建议。