Claude Trading Skills 泡沫探测器速查手册实战:Bubble-O-Meter 评分、五阶段风控与止盈做空纪律

原创2026-11-15 00:01:222,125 阅读
文章标签:金融科技AI 技能人工智能数据分析

Claude Trading Skills 泡沫探测器速查手册实战:Bubble-O-Meter 评分、五阶段风控与止盈做空纪律

本文以 weekly-trade-strategy 示例项目中 us-market-bubble-detector 的速查手册为骨架,完整拆解一套“每天 5 分钟即可完成”的市场泡沫风险巡检流程:如何按 0–2 分给指标打分、如何把总分映射为风险预算与 ATR 止损倍数、如何在三种止盈模板之间取舍,以及什么时候才允许考虑做空。读完你可以直接照着清单执行日检,并用仓库自带的 bubble_scorer.py 把主观判断变成可复现、可校验的机械评分。

一、速查手册在仓库中的位置与使用边界

关联文档是 quick_reference.md,它是 us-market-bubble-detector 技能的“日常操作页”,与以下文档形成分层:

文档 定位 何时加载
references/implementation_guide.md 分步评估流程、NG/OK 对照、自检质量分级 首次使用、需要详细指引
references/bubble_framework.md Minsky/Kindleberger 五阶段理论、行为心理学 需要理论背景
references/historical_cases.md 互联网泡沫、加密泡沫、疫情泡沫复盘 需要历史对照
references/quick_reference.md 日检清单、紧急三问、快捷打分、止盈模板 每日例行操作

这一分层说法在技能的入口文件 SKILL.md 中明确给出。从仓库结构看,该技能被 market-regime 技能集收录(见 market-regime.yaml),而 weekly-trade-strategy 示例项目在依赖清单中也列出了它,见 README.md,说明它承担的是“市场环境评估”环节中的泡沫风险子判断,而非独立的交易信号系统。

重要前提(务必先读):仓库中存在两份同名技能。skills/us-market-bubble-detector/ 是 v2.1 现行版(6 量化 + 3 定性,满分 15);而关联文档所在的 examples/weekly-trade-strategy/skills/us-market-bubble-detector/ 仍是 v2.0 时期的快照(8 指标、满分 16、四阶段)。两者差异会在第六、七节展开,并在文末给出迁移建议。本文在保留原速查手册全部要点的基础上,以现行 v2.1 口径作为执行标准。

二、每日清单:开盘前 5 分钟三步走

原文档给出的晨间例程是可以逐条打勾执行的,核心是把“看盘”拆成评分、持仓管理、信号确认三段,避免情绪化操作:

□ Step 1: Update Bubble-O-Meter (2 minutes)
   - Score 8 indicators on 0-2 scale
   - Confirm risk budget based on total score

□ Step 2: Position Management (2 minutes)
   - Update ATR trailing stops
   - Check if stair-step profit-taking targets reached
   - Determine new entry eligibility

□ Step 3: Signal Confirmation (1 minute)
   - Media/social media trends (Google Trends, Twitter)
   - Major indices' distance from 52-week highs
   - VIX & Put/Call ratio

对照现行版本,Step 1 的口径已改为“6 个量化指标(0–2 分)+ 3 个定性调整(0–1 分),按 0–15 总分确认风险预算”,见 quick_reference.md。实际执行时建议:

  1. Step 1 先收数再打分。指标值必须来自可核验来源(CBOE、FINRA、Renaissance Capital 等),不接受“感觉 VIX 很低”这类表述。
  2. Step 2 用机械规则约束。ATR 拖曳止损与阶梯止盈都是预设动作,盘前定好,盘中不临时改。
  3. Step 3 只做交叉验证。媒体热度、指数距 52 周高点距离、VIX 与 Put/Call 属于“信号确认”,不单独构成加仓或清仓理由。

三、紧急三问:从“直接下结论”改为“触发完整评估”

原文档的三问设计初衷是快速定性,但它给出的映射是直接跳到阶段结论:

Q1: "Are non-investors recommending?"
- YES → Mass penetration complete, likely late stage
- NO  → Still early-to-mid stage

Q2: "Has the narrative become 'common sense'?"
- YES → Euphoria stage, dissent socially unacceptable
- NO  → Skeptical views still tolerated, healthy state

Q3: "Is 'this time is different' the mantra?"
- YES → Historically typical bubble sign
- NO  → Healthy caution still functioning

All 3 YES → Critical zone, prioritize profit-taking/exit

现行版本已经收紧了这段逻辑,把三问降级为“预警信号”而非结论,见 quick_reference.md:

  • YES 只要求“记录具体的、独立的、可核验的案例”,用于后续定性加分取证;
  • 三个都 YES 时的动作是 “强预警信号:执行完整量化评估后再行动”,而不是直接进入 Critical;
  • 明确写入“仅凭 YES/NO 不构成任何阶段或动作判定,全部 NO 同样如此”,必须走完 Phase 1 数据收集、Phase 2 量化打分、Phase 3 证据化调整;
  • 数据缺失时的正确做法是“评估未完成,向用户索要缺失输入”,而不是硬给一个阶段。

这一约束由测试用例守护,test_skill_contract.py 会断言中英两版速查手册中不再出现 Critical zone、Euphoria stage、Still early、healthy state 这类“三问直达结论”的捷径表述。这一点非常值得借鉴:把纪律写进可执行的测试,而不是只写在文档里。

四、阶段—动作矩阵:风险预算、入场、止盈与止损

这是速查手册最实用的部分,一张表把总分直接翻译成仓位语言(原表见关联文档,此处按现行 v2.1 完整继承):

阶段 分数 风险预算 新入场 止盈 止损 做空
Normal 0-4 100% 正常 到目标位 2.0 ATR 不做
Caution 5-7 70-80% 减半 +20% 时减 25% 1.8 ATR 不做
Elevated Risk 8-9 50-70% 高度选择性 +20% 时减 40% 1.6 ATR 谨慎考虑
Euphoria 10-12 40-50% 停止 +20% 时减 50% 1.5 ATR 条件确认后
Critical 13-15 20-30% 停止 立即减 75-100% 1.2 ATR 建议

原文档在表下注明:“最高分从 16 分降至 15 分(Phase 2 上限 12 分,Phase 3 上限 3 分)”。这一改动的原因在 CHANGELOG.md 中有完整记录:v2.0 下 9 分被划入 Euphoria、风险预算直接压到 40%,属“过度防御”;v2.1 新增 8-9 分区间,把该档位放宽到 50-70%,让“有警戒但不极端”的市况也能保留优质仓位。

矩阵的关键读法:

  • 风险预算不是仓位比例,而是“愿意暴露给新风险的资金上限”,已有持仓的止损收紧与之独立执行。
  • 止损倍数随分数单调下降(2.0 → 1.2),意味着分数越高,容忍回撤的空间越小。
  • 入场权限最先关闭:进入 Euphoria 后不再开新多单,但止盈仍在分批推进,避免“一次性清仓错过末段”。

五、指标打分:8 项快捷评分逐条对照

原文档的快捷打分覆盖 8 个指标,全部 0–2 分,满分 16。以下完整保留其判据与语义:

# 指标 0 分 1 分 2 分
1 Mass Penetration(大众渗透) 仅投资者讨论 大众知晓但投资仍有限 出租车司机/家人开始推荐
2 Media Saturation(媒体饱和) 正常报道水平 搜索热度 2-3 倍 电视专题/杂志封面,搜索 5 倍以上
3 New Entrants(新开户) 正常开户节奏 同比 +50%~100% 同比 +200% 以上,新手涌入
4 Issuance Flood(发行泛滥) 正常 IPO 数量 IPO/相关产品增加 50% 低质 IPO、主题 ETF 泛滥
5 Leverage(杠杆) 正常区间 融资余额 1.5 倍 历史新高,融资利率抬升
6 Price Acceleration(价格加速) 接近历史中位数 超过 90 分位 95-99 分位或仍在加速
7 Valuation Disconnect(估值脱节) 可由基本面解释 估值高但有增长预期支撑 完全依赖“叙事”,基本面被忽略
8 Correlation & Breadth(相关性与广度) 仅部分龙头上涨 板块级扩散 低质/僵尸公司也普涨

对应的“原始代码块”写法便于逐条抄录打分:

### 1. Mass Penetration
0 points: Investors only
1 point: General awareness but investment still limited
2 points: Taxi drivers/family recommending

### 5. Leverage
0 points: Normal range
1 point: Margin balance 1.5x
2 points: All-time high, funding rates elevated

### 6. Price Acceleration
0 points: Near historical median
1 point: Exceeds 90th percentile
2 points: 95-99th percentile or accelerating

### 8. Correlation & Breadth
0 points: Only some leaders rising
1 point: Sector-wide spread
2 points: Even low-quality/zombie companies rallying

必须注意的口径差异:现行 v2.1 把这 8 项重组为“6 个量化指标 + 3 个定性调整”,定性合计最多 +3 分,且每个定性项都要求可测量证据。映射关系如下(依据 bubble_scorer.py 的指标定义):

原 8 指标 v2.1 归属 分值上限 判据变化
1 Mass Penetration 定性 social_penetration 0-1 需直接的用户报告 + 具体案例 + ≥3 个独立来源
2 Media Saturation 定性 media_search_trends 0-1 需 Google Trends 同比 5 倍以上“且”主流媒体报道可核验
3 New Entrants 量化 ipo_heat 的辅助证据 计入 0-2 不再单列,避免与发行数据重复计分
4 Issuance Flood 量化 ipo_heat 0-2 季度 IPO 数 >5 年均值 2 倍且首日涨幅 +20% 以上
5 Leverage 量化 leverage 0-2 融资余额同比 ≥+20% 且创历史新高
6 Price Acceleration 量化 price_acceleration 0-2 近 3 月收益 >过去 10 年 95 分位
7 Valuation Disconnect 定性 valuation_disconnect 0-1 P/E >25 且基本面被明确忽略,且不与量化项重复计分
8 Correlation & Breadth 量化 breadth_anomaly 0-2 创新高但 50 日均线之上个股 <45%
—(原文档未单列) 量化 put_call_ratio 0-2 P/C <0.70 得 2 分,0.70-0.85 得 1 分
—(原文档未单列) 量化 volatility_suppression 0-2 VIX <12 且指数距 52 周高点 5% 以内

现行版每个阈值都在 SKILL.md 与 bubble_scorer.py 的 get_scoring_guidelines() 中三处保持一致,可直接作为打分依据。

六、用 bubble_scorer.py 把评分机械化

手工打分容易前后口径漂移,仓库提供了纯标准库实现的评分器(requirements.txt 中明确写着 stdlib-only)。入口是 bubble_scorer.py。

6.1 交互式打分

cd skills/us-market-bubble-detector
python3 scripts/bubble_scorer.py --manual

manual_assessment() 会先打印评分指引,再逐个指标提示输入,并对非法输入原地重试:输入非数字提示 Enter a numeric value,越界提示 Enter a value between 0 and 2(见 bubble_scorer.py)。

6.2 一次性传入 JSON 分数

支持两种 JSON 结构:扁平对象(9 个键混在一起)与嵌套对象(显式区分 quantitative / qualitative),解析逻辑在 _scores_from_json():

# 扁平写法
python3 scripts/bubble_scorer.py --scores '{
  "put_call_ratio":2,
  "volatility_suppression":2,
  "leverage":1,
  "ipo_heat":0,
  "breadth_anomaly":2,
  "price_acceleration":1,
  "social_penetration":1,
  "media_search_trends":0,
  "valuation_disconnect":0
}'

实际运行输出(本仓库实测):

============================================================
US Market Bubble Risk - Bubble-O-Meter v2.1
============================================================
Evaluated at: 2026-11-14T23:56:41.120004

Quantitative: 8/12
Qualitative adjustment: +1/3
Final score: 9/15 (60.0%)
Phase: Elevated Risk (Risk: Medium-High)
Risk budget: 50-70%
Minsky phase: Late Boom/Elevated Risk
Recommended action: Reduce risk budget and tighten trailing stops
...

6.3 机器可读输出与失败即报错

python3 scripts/bubble_scorer.py --scores '{...}' --output json

--output json 会输出完整结果字典,包含 quantitative_score、qualitative_adjustment、total_score、max_score、percentage、phase、risk_level、risk_budget、minsky_phase、recommended_action 以及逐项明细,适合被上层 Agent 或报告生成器直接消费。

校验相当严格,任何“差不多”的输入都会被拒绝,并返回退出码 1:

python3 scripts/bubble_scorer.py --scores '{"put_call_ratio":3,...}'
# stderr: Error: put_call_ratio must be between 0 and 2
# EXIT=1

从 _validate_scores() 的实现看,它同时检查:键是否缺失(Missing score(s))、是否有未知键(Unknown score(s))、值是否为整数(布尔值会被显式排除,True 不当作 1)、是否落在该指标的 0-2 或 0-1 区间内。未提供任何参数时也不会静默通过,而是把评分指引打印到 stderr 并返回 1。这套“fail closed”行为在 test_skill_contract.py 与 test_cli_emits_json_and_fails_closed_on_invalid_input 中被逐条覆盖。

6.4 阶段与 Minsky 映射的实现细节

_classify_score() 用边界值 <=4 / <=7 / <=9 / <=12 / 其余 划出五个阶段,与动作矩阵完全一致。_estimate_minsky_phase() 则不是简单按总分线性映射,而是引入了成分判断:

  • 总分 ≤4 → Displacement/Early Boom;
  • 5-7 分:若 price_acceleration 与 volatility_suppression 均 ≥1 → Boom,否则退回 Displacement/Early Boom;
  • 8-9 分 → Late Boom/Elevated Risk;
  • 10-12 分:若 price_acceleration 与 breadth_anomaly 均达 2 分 → Euphoria,否则 Late Boom/Early Euphoria;
  • ≥13 分 → Peak Euphoria/Profit Taking。

这段结构与 bubble_framework.md 描述的五阶段推进(Displacement → Boom → Euphoria → Profit Taking → Panic)对应:同样是 10 分,若价格加速与广度异常都打满,说明“低质量标的普涨 + 抛物线”的典型热狂特征已具备;若只是估值和杠杆偏高,则仍停留在扩张后期。测试 test_bubble_scorer_distinguishes_boom_and_euphoria_components 专门锁定了这一区分。

七、止盈三模板:数字要算清楚

模板 1:阶梯止盈(保守)

Position: $10,000 initial investment
Targets:  +20%, +40%, +60%, +80%

+20% ($12,000) → Sell 25% = $3,000 secured
+40% ($14,000) → Sell 25% = $3,500 secured
+60% ($16,000) → Sell 25% = $4,000 secured
+80% ($18,000) → Sell 25% = $4,500 secured

Total profits: $15,000 (+50% equivalent)

这里需要精确解读原文的“Total profits: $15,000 (+50% equivalent)”:四次卖出累计回收现金 $3,000+$3,500+$4,000+$4,500 = $15,000,即原始本金 $10,000 的 1.5 倍;对应已实现收益 $5,000,收益率 +50%。之所以“回收总额”等于 1.5 倍本金,是因为每一档都按当时市值的 25% 减仓(等价于按股数分批卖出),而价格逐级抬升。理解这一点才能正确设置限价单:四笔卖单的量应按“当前持股数的 25%”而非“初始股数的 25%”挂出。

该模板的适用阶段是 Caution 及以下(+20% 减 25%),进入 Elevated Risk 后单档比例提高到 40%,Euphoria 提高到 50%,Critical 则要求立即减 75-100%。

模板 2:ATR 拖曳止损(激进)

def calculate_trailing_stop(current_price, atr_20d, bubble_phase):
    """
    根据泡沫阶段计算拖曳止损价

    bubble_phase: 'normal', 'caution', 'elevated_risk', 'euphoria', 'critical'
    """
    multipliers = {
        'normal': 2.0,
        'caution': 1.8,
        'elevated_risk': 1.6,
        'euphoria': 1.5,
        'critical': 1.2
    }
    multiplier = multipliers.get(bubble_phase, 2.0)
    stop_price = current_price - (atr_20d * multiplier)
    return stop_price

current_price = 450.0
atr_20d = 10.0          # 20 日平均真实波幅
bubble_phase = 'euphoria'

stop = calculate_trailing_stop(current_price, atr_20d, bubble_phase)
print(f"Trailing Stop: ${stop:.2f}")
# Output: Trailing Stop: $435.00

两个易错点:一是 bubble_phase 必须传小写下划线形式(elevated_risk,而非 Elevated Risk),否则 dict.get 会静默回退到 2.0 倍的默认值,等于把风险预算最紧的阶段当成最松的阶段处理;二是 $450 − 10×1.5 = $435 的示例只在 euphoria 下成立,若当前阶段是 elevated_risk 则应为 $434。

模板 3:混合策略(推荐)

Stage 1 (Boom period):
  → Reduce 50% of position via stair-step profit-taking

Stage 2 (Euphoria period):
  → Apply ATR trailing to remaining 50%, follow upside

Stage 3 (Panic signs):
  → Exit immediately when ATR stop hit

混合策略解决的是“全卖怕踏空、全拿怕回撤”的两难:先用阶梯止盈锁定一半利润(把浮盈变成已实现),剩余一半交给 ATR 拖曳跟随上涨,一旦触发止损无条件离场。它的隐含假设是“泡沫末段仍可能有可观涨幅,但回撤速度极快”,这与金律第 8 条“泡沫比预期更久,崩塌比预期更快”一致。

八、做空时机:七个复合条件与分阶段门槛

原文档用最强的语气标注了“绝对 NG”的做法:

❌ Absolutely NG: Early Contrarian
Reason: Normal for prices to rise 2-3x more after feeling "too high"
Risk: "Markets can remain irrational longer than you can remain solvent"

推荐路径是等复合条件成立,至少满足 3 项才考虑:

  1. 周线出现明确的更低高点(lower highs)
  2. 成交量见顶(连续 3 周下滑)
  3. 杠杆指标快速回落(融资余额 -20% 以上)
  4. 媒体/搜索热度见顶
  5. 板块内弱势股率先破位
  6. VIX 急升(+30% 以上)
  7. 美联储/政策转向信号

原文档的执行示例:

Condition Check:
[✓] 1. Weekly lower highs forming
[✓] 2. Volume declining 3 weeks straight
[×] 3. Margin balance still elevated
[✓] 4. Google search trends -40%
[×] 5. Still broad rally continuing
[✓] 6. VIX +35% surge
[×] 7. No policy changes

→ 4/7 met, shorts consideration OK
→ Small position (25% of normal) for test entry

现行 v2.1 进一步把门槛与阶段绑定(见 SKILL.md):

阶段 做空门槛 建议仓位 止损
Normal / Caution 不允许 / 不推荐 — —
Elevated Risk ≥2/7 条件 正常规模的 10-15% 试仓 2.0 ATR 严格止损
Euphoria ≥3/7 条件 正常规模的 20-25% 只做风险可控结构(期权、紧止损)
Critical ≥5/7 条件 小仓分批、确认后金字塔加仓 1.5 ATR 或更紧,可考虑看跌期权

这解释了一个常见困惑:速查手册说“3 项即可”,而 SKILL.md 在 Critical 阶段要求 5 项。二者不矛盾——3/7 是“开始研究做空”的通用底线,阶段越高,要求的确认度越高,因为高分区间的反向波动(轧空)也更剧烈。

九、四类典型失败与对应解法

失败模式 心理成因 解法
1. “太晚了”瘫痪,错过机会 后悔厌恶(怕追高被套) 用 Bubble-O-Meter 打分:≤7 分可小仓入场;8-9 分仅参与极佳形态并缩小仓位;≥10 分才应放弃
2. 止盈后回补(买在高点) 后见之明偏误(“早知道还会涨”) 止盈后 72 小时禁止回补;回补前必须重新打分
3. “还在涨”舍不得卖 贪婪 + 过度自信 阶梯止盈自动化(预设限价单);目标是“满意”而非“完美”
4. 做空过早 主观觉得“明显太高” 机械核对 7 项复合条件;至少 3 项成立再动手

原文第 1 条写的是“≤8 分可小仓、≥9 分应观望”,现行版改为“≤7 / 8-9 / ≥10”三段,正是为了匹配新增的 Elevated Risk 区间——否则 8 分和 9 分会落在同一处置档,与动作矩阵矛盾。

十、紧急响应流程:把决策顺序固化

Detect market volatility
    ↓
Q: Have positions?
    ↓YES
Q: Down -5% or more?
    ↓YES
Q: ATR stop reached?
    ↓YES
→ Sell immediately (no debate)

    ↓NO (Stop not reached)
Q: Bubble-O-Meter score 13+?
    ↓YES
→ Consider 75%+ profit-taking

    ↓NO (Score ≤12)
Q: VIX surge +30%+?
    ↓YES
→ 50% profit-taking, tighten remaining stops

    ↓NO
→ Business as usual, continue calm observation

这条流程的价值在于“决策优先级不可交换”:止损优先于评分,评分优先于波动率。也就是说,当 ATR 止损已被击穿时,不需要再讨论当前分数是 11 还是 14——先执行卖出。反过来,只要止损未破、分数未到 13、VIX 未急升 30%,就按原计划执行,不做临时干预。

十一、关键数据源与自动化取数

速查手册列出的即时可查指标:

指标 来源 示例
Google 搜索趋势 Google Trends trends.google.com
VIX(恐慌指数) CBOE cboe.com/vix
Put/Call 比率 CBOE cboe.com/data
融资余额 FINRA finra.org/data
期货持仓 CFTC COT cftc.gov/reports
IPO 统计 Renaissance IPO renaissancecapital.com

可 API 化自动取数的示例代码(原文档提供的思路):

# Google Trends
from pytrends.request import TrendReq
pytrends = TrendReq()
pytrends.build_payload(['SPY', 'stock market'])
data = pytrends.interest_over_time()

# VIX
import yfinance as yf
vix = yf.Ticker('^VIX')
current_vix = vix.history(period='1d')['Close'].iloc[-1]

需要强调:这两个库不是本技能的运行依赖。技能的 requirements.txt 只有一行 # stdlib-only,bubble_scorer.py 仅用标准库;上述代码属于“自建取数管道”的可选补充,仅供你自行搭建数据采集时参考。技能本身的设计前提是“由使用方提供已测量的指标值”,API key 不需要。

十二、十条金律(可直接贴墙)

  1. 看过程,不看价格
  2. 当出租车司机开始聊股票时,执行完整量化评估(原文档旧表述为“立即离场”,现行版已改写,理由见 bubble_framework.md 中“社交轶事本身不构成阶段判定或离场决策”的说明)
  3. “这次不一样”每次都一样
  4. 机械规则保护心理
  5. 确认后再做空,止盈要早
  6. 当质疑让人社交不适时,终点就开始了
  7. 追求满意,放弃完美
  8. 泡沫比预期更久,崩塌比预期更快
  9. 杠杆是通往毁灭的快车票
  10. “市场保持非理性的时间,可能长过你保持偿付能力的时间”

第 2 条的改写同样有测试守护:test_skill_contract.py 会断言两份速查手册中都不再出现 When taxi drivers talk stocks, exit(原句会导致“单一轶事直接清仓”的危险捷径),且紧急段落中必须包含 Phase 1/2/3 的完整流程要求。

十三、延伸阅读与版本维护建议

原文档推荐的书目与研究方向(用于理解框架来源,非本仓库内容):

  • 书籍:《Manias, Panics, and Crashes》(Charles Kindleberger)、《Irrational Exuberance》(Robert Shiller)、《The Alchemy of Finance》(George Soros)
  • 研究:Hyman Minsky 的金融不稳定假说、行为金融学经典论文
  • 工具:TradingView(图表)、FRED(经济时间序列)、Finviz(筛选与热力图)、Google Trends(社会热度)

关于两份副本的实操建议:关联文档及其同目录下的 bubble_scorer.py 仍停留在旧口径——脚本内是 8 个指标、max_score = len(self.indicators) * 2(即 16 分),阈值为 <=4 / <=8 / <=12 / 其余,输出为日文阶段名(正常域/警戒域/热狂域/临界域),且不支持定性调整的 0-1 分约束。若你直接运行示例目录下的脚本,得到的分数与本文动作矩阵不兼容。建议以 skills/us-market-bubble-detector 作为唯一执行口径:其 bubble_scorer.py 的满分、阶段边界、Minsky 映射均与文档、测试三方一致;迁移动作可参照 implementation_guide.md 的六步流程与四级质量自评(Level 1 失败 → Level 4 最佳实践)。

无论用哪个版本,评估完成后都应过一遍自检清单:六项量化数据是否都有具体数值与采集日期、定性调整是否控制在 +3 分以内、是否与其它量化框架的结论出现 10 分以上偏差。只有这些条件全部满足,评分才具备被独立复现的资格——这也是这套速查手册真正的设计目标:用可核验的数据与机械规则,替代“感觉太高了”的主观判断。

登录后查看全文
claude-trading-skills