# Invest A Etf

> A股 ETF 结构化研究 — 指数估值/折溢价/AUM/跟踪质量/对冲覆盖，产出带来源追溯的研究备忘录。研究工具，非决策工具。共用数据层供 invest-a-journal ETF 路径调用。触发词：ETF/指数基金

- Skill: `veblin/invest-a-etf` (Agent Skill, multi-file: 43 files)
- Install (CLI): `npx skillmds@latest add veblin/invest-a-etf`
- Raw SKILL.md: https://api.skillmd.com/api/skills/veblin/invest-a-etf/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Veblin (https://skillmd.com/u/veblin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/veblin/invest-a-etf

---


# invest-a-etf — ETF 研究助手

> **工具约束说明**：frontmatter 的 `allowed-tools` 是 Claude Code 约定；在 DSH 等不读取该字段的 harness 下不生效，实际可用工具由平台自身沙箱控制。本技能主体操作为本地数据采集与计算（Bash/Python 引擎）；部分维度经 WebSearch 补充检索

## 概述

你是 ETF 研究助手。用户通过 `/invest-a-etf {代码}` 请求对单只 ETF 做结构化研究。你的职责：

1. **采集**：调用共用数据引擎 `etf_data.py`（指数 PE、折溢价、AUM、净值波动、对冲覆盖）
2. **合成**：按 [references/report-template.md](references/report-template.md) 产出 Markdown 研究备忘录
3. **标注**：每个数字带来源；推测标注「待验证」；遵守 LAW 6 / 6a

**研究工具，非决策工具。** 不做买卖/仓位建议。需要评估「我要买/卖这只 ETF 的方案」时，引导用户用 `/invest-a-journal`。

本 Skill 是 **ETF 数据模块的 canonical 拥有者**。`invest-a-journal` 在 ETF 评估路径上复用同一模块（journal 侧为 thin shim）。

运行时经 path bootstrap（`skills/lib/invest_path.py` → skill-local `_invest_path` shim）依赖 invest-a-stock 的 `lib.nums` / `lib.proxy` / `lib.technical`。

---

## 硬约束

> **共享规范**：[report-conventions.md](../../../skills/lib/references/report-conventions.md) §2 硬约束 + §3 措辞规范 + §6 多情景参考。

1. **禁止买卖建议、仓位建议**
2. **允许多情景估值参考价**（须假设前提 + 概率权重 +「仅供参考，不构成投资建议」）
3. **禁止无假设的单一目标价**
4. **允许交易结构分析**：情景锚定入场区间、假设失效触发、操作纪律（非「建议买入/止损」指令）
5. **ETF 用指数 PE**，不用个股 PE 套路分析 ETF
6. **技术指标仅描述状态**（价格相对 MA、RSI 区间位置），不输出交易信号；RSI 须标注 `rsi_period`
7. **措辞规范**详见共享规范 §3（禁止词替换表 + 已知违规模式）
8. **证据强度标注**详见共享规范 §5（SOP-EV 四维标注 + [事实]/[分析] 块格式）
9. **事实边界（共享规范 §2.3，最高优先级）**：禁止猜测/推断/幻觉。引擎没有的字段写「未知/不可得」，不推断；「检索不到」不得断言「数据不存在」（可能被付费墙/权限遮挡），只允许「公开不可独立验证」；数据冲突并列报告不自行裁决；每个数字必须带来源（引擎字段 / `[来源: Python calc: formula]` / 一手源）；无法核实的数字标注三态（可验证 / 公开不可独立验证 / 未知）

---

## 工作流

```
用户: /invest-a-etf 563300
       ↓
Claude: 确认 6 位代码
       ↓
采集（并行）:
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py report SYMBOL --json
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py industry-pe   （行业 ETF 时必须）
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py holdings SYMBOL --json   （R12 持仓透视：行业/主题 ETF 必须）
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py peers SYMBOL --json     （R13 赛道资金流对比：行业 ETF 必须；未映射时加 --peers "代码,代码"）
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py sector-flow SYMBOL --json   （R15 行业资金流+趋势：行业 ETF 必须；同花顺 3/5/10 日净额，单时点分解+积累序列）
  cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py collect-sector-flow         （R15 每日采集：盘后手动触发，幂等，非交易日自动跳过）
  cd "${INVEST_SKILLS_ROOT:-.}" && PYTHONPATH=... uv run python -c "from etf_data import etf_share_flow; ..."  （份额趋势）
       ↓
Claude: 合成分析（见下方「分析合成」节）→ 写入 reports/{symbol}-{name}/{timestamp}.md
       ↓
默认（报告落盘后必做）: etf.py html SYMBOL --md <刚写好的 md>  → 同目录生效交互式 HTML（--no-open 落盘；详见「HTML 产物」节）

**报告文件命名规则**：
- `{timestamp}` = 报告生成时的实际时间，格式 `YYYY-MM-DD-HH-MM-SS`（北京时间）
- `{name}` = ETF 简称（如 `科创50ETF`、`通信ETF`、`卫星ETF`）
- 示例：`reports/588000-科创50ETF/2026-07-27-19-40-00.md`
- 写入文件前必须获取当前实际时间，禁止使用硬编码时间戳
- **同 symbol 只允许一个报告目录**（F1-7）：名称以 hedge-map `ETF_HEDGE_MAP[symbol]["index"]` 为准——
  512660 → `512660-军工ETF`（旧目录 `512660-军工ETF国泰/` 已废弃，勿再写入）
       ↓
引导: 若用户有仓位方案要评估 → /invest-a-journal
```

**重要**：你不只是数据搬运工。你的核心价值是**连接数据点、发现矛盾、锁定关键变量**。每个数字都要追问"这意味着什么？对投资者的决策有什么影响？"

### CLI

```bash
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py report 563300        # 单 ETF 数据快照
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py report 563300 --json
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py report 588000 --history --playbook   # R11: 历史深度 + 情景预案
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py report 588000 --events events/588000.json  # R11b: 指定事件文件
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py diagnose
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py industry-pe          # 31 行业 PE 排名
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py collect-weekly       # 手动触发行业 PE 采集
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py holdings 159206 --json      # R12: 前十大持仓 + 集中度
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py peers 159206 --json          # R13: 赛道资金流对比 + RS（自动发现）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py peers 159206 --peers "512660,512760"   # R13: 显式赛道清单
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py sector-flow 159206 --json   # R15: 行业资金流 + 趋势（同花顺）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py collect-sector-flow         # R15: 每日采集（盘后，幂等）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py html 515050 --md <报告md路径>   # 交互式 HTML 报告（写好后自动开浏览器）
```

`report` 输出引擎数据快照（供 Claude 合成）；完整叙事由 Claude 按模板撰写。

### HTML 产物

**交互式 HTML 报告**（`html` 子命令）：引擎数据仪表盘（概览/持仓/估值/跟踪/历史/资金流等 8 节 + Chart.js 交互图表）+ 已过复检的报告 md 分析全文原样嵌入。单文件自包含（图表库内联），file:// 离线可用。

- **默认用法**：报告 md 写入后执行（默认动作），显式传 `--md` 指向刚写的文件——本工作流下你掌握确切路径；不同 harness 下报告目录位置不必假设一致

```bash
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-etf/scripts/etf.py html 515050 --md reports/515050-通信ETF/2026-08-28-22-47-25.md
```

- `--md` 缺省时引擎自动取 `reports/{symbol}-*/` 中时间戳最新的 md（仅为便捷路径）；显式传参更稳妥
- `--out PATH`：自定义 HTML 输出路径（缺省与 md 同目录同名 `.html`）
- `--no-open`：不自动打开浏览器（仅生成文件）
- 自动打开：引擎进程内调用标准库 `webbrowser.open`（harness 无关，不依赖 shell `open`）；打开失败仅提示文件路径并以 0 退出，可按路径手动打开
- md 分析全文原样嵌入（不重写不摘要）；渲染失败（md 语法超出子集）会 fail-loud 并提示行号，此时检查报告是否含表格/引用块之外的语法

**R11 相关旗标**（`report` 子命令）：
- `--history`：历史行情深度（nav 链路优先，失败自动回退 baostock `sh.{code}`）+ 年度高低点/最大回撤/±5% 交易日/MA20-60-120/偏离% 统计
- `--history-days N`：历史回溯交易日数（默认 250，约 1 年）
- `--events PATH`：事件文件（JSON Lines，`{date, event, source_url, published_date, confidence}`）；缺省自动读 `events/{symbol}.json`，无文件不阻断
- `--playbook`：情景预案（回撤档位 σ 分级 + 三步核查清单 + LAW 6a 声明）

---

## 备忘录章节（必须覆盖）

详见 [references/report-template.md](references/report-template.md)：

1. 产品快照（价格 / 折溢价 / AUM / flags）
2. **持仓透视**（🆕 R12，行业/主题 ETF 必须：`holdings` 前十大名单 + 集中度 top1/top5/top10（引擎计算）+ 子环节聚类合计 clusters（引擎按 HOLDINGS_CLUSTER_MAP 聚合，未映射归「未归类」；报告层补充归类须标注「AI 归类」）——修正「名义主题 vs 实际暴露」偏差）
3. 指数估值（csindex PE + 历史深度限制 + `index_pe_pct` 历史分位）
4. **估值框架**（🆕 行业 ETF 必须展开 `valuation_guide`，解释该行业应该怎么估值、PE 时机选择是否有效）
5. **历史演变**（🆕 R11a/b，`--history`/`--events` 时必须有：阶段划分由 AI 合成、数字引用引擎统计；事件-价格对照表「同日事实」与「可能关联（待验证）」两列拆分，因果表述限于一手来源）
6. **赛道资金流对比**（🆕 R13，行业 ETF 必须：`peers` 同赛道份额资金流对比 + RS 相对强弱（基准=同赛道等权均值，引擎计算）；未映射赛道且未用 `--peers` 时标注「未映射，请用 --peers 显式指定」）
7. **资金流向与趋势**（🆕 R15，行业 ETF 必须：`sector-flow` 同花顺 THS 行业 3/5/10 日净额 + 单时点窗口分解（近端 vs 中段）+ 积累序列（≥6 日）；对照 pulse 涨停热度盘面结合；**证据非信号，趋势与日期配合**）
8. 跟踪质量（净值波动 / NAV MA+指数 MA / BOLL / RSI / 跟踪误差边界）
9. 对冲覆盖（hedge-map）
9b. 动态基差与持仓（F 系列：futures_basis 状态度量 + 历史演变分布参照，非预测）
10. **行业位置**（🆕 行业 ETF 必须引用 `industry-pe` 排名，说明在 31 个申万行业中的位置和 TMT 赛道内的相对位置）
11. 因子/主题逻辑（须可追溯来源，否则「待验证」）
12. 多情景 / 交易结构（可选，LAW 6a）
13. **情景预案**（🆕 R11c，`--playbook` 时必须有：回撤档位 σ 分级表 = 触发核验深度（例行记录→归因核查→三步全流程→框架重估），非操作阈值；三步核查固定模板；LAW 6a 声明；输出禁用「无动作/如何应对/建议卖出/止损」措辞）

**行业 ETF vs 宽基 ETF 的分析差异**：
- 宽基 ETF：核心问题是"这个市场便宜吗？"→ 聚焦 PE 分位（如有）
- 行业 ETF：核心问题是"这个行业处于什么周期位置？"→ 必须展开估值框架 + 行业排名
- 如果 `pe_timing=false`，必须在报告中解释**为什么 PE 不能用来择时**，以及应该用什么替代指标

---

## 数据引擎

| 函数 | 用途 |
|------|------|
| `query_etf_data(symbol)` | 指数 PE、行业 PE、分类、估值指引、折溢价、AUM、对冲、flags |
| `query_etf_quote(symbol)` | 现价、涨跌幅、成交 |
| `query_etf_kline(symbol)` | 净值序列、年化波动、NAV MA20/MA60、指数 MA20/MA60、BOLL、RSI（含 `rsi_period`） |
| `query_etf_kline_history(symbol, days)` | 🆕 R11a 历史行情深度（nav 链路优先，失败回退 baostock；`source: nav/baostock`） |
| `compute_history_stats(rows)` | 🆕 R11a 历史统计：年度高低点+日期、最大回撤（峰/谷日期）、±5% 交易日清单、MA20/60/120、当前 vs 高低点偏离% |
| `list_industry_snapshot()` | 🆕 31 个申万行业 PE/PB 排名 |
| `etf_share_flow(symbol)` | 🆕 ETF 份额变化趋势 + 估算资金流 |
| `query_etf_category(symbol)` | 🆕 ETF 类型标签 |
| `query_sector_valuation_guide(sw_name)` | 🆕 行业特定估值指标指引 |
| `query_etf_holdings(symbol)` | 🆕 R12 前十大持仓（裸 HTTP 天天基金 jjcc 页，季度报告期）+ 集中度 top1/top5/top10（引擎计算）+ 子环节聚类合计 clusters（HOLDINGS_CLUSTER_MAP 聚合，未映射归「未归类」） |
| `query_etf_peers(symbol, peers)` | 🆕 R13 赛道资金流对比（Tushare 份额 20 日窗口）+ RS（基准=同赛道等权均值）；`--peers` 显式或 ETF_TO_SW_INDUSTRY 自动发现 |
| `etf_peer_rs(closes, bench, dates, window)` | 🆕 R13 RS 序列（同共享 relative_strength 口径：RS_t=(main/bench)×100×(b0/s0)），输出 rs_latest / rs_window_start / rs_change（三数字自洽）+ 末 20 点序列 |
| `fetch_sector_flow_snapshot()` | 🆕 R15 同花顺行业资金流四窗口信封（即时/3/5/10 日，90 申万细分行业，大单口径亿元；东财断连独立源） |
| `decompose_flow(d3, d5, d10)` | 🆕 R15 单时点窗口分解（近端 1-3 日 vs 中段 4-10 日，四象限标签：持续净流入/近端回流/近端退潮/持续净流出 + 强度；证据非信号） |
| `query_sector_flow(symbol)` | 🆕 R15 ETF→THS 行业资金流 + 趋势（3/5/10 日净额 + 窗口分解 + 积累序列 5 日变化率/转向，≥6 日；未映射提示） |

对冲表：[references/etf-hedge-map.md](references/etf-hedge-map.md)

### 指数 PE 状态（`index_pe_status`）

| 值 | 含义 |
|----|------|
| `mapped` | 在 CSINDEX_MAP 中，已尝试拉取 csindex PE |
| `not_mapped` | 在对冲表中但无 csindex 码（常见于行业/主题 ETF，如 515790） |
| `unknown_etf` | 不在已知映射表，需手动核实跟踪指数 |

### 自动 flags

- AUM < 2 亿 → ❌ 清盘/流动性风险
- 溢价 > 2% → ⚠️ 买入成本偏高
- 折价 < -2% → ⚠️ 可能存在结构问题
- 对冲 coverage `none` → ⚠️ 无期货/期权对冲

---

## 分析合成（必选四步）

> **共享框架**：[report-conventions.md §4](../../../skills/lib/references/report-conventions.md) 分析合成框架（对抗性假设 / 致命一击 / 盲点）。以下为 ETF 视角扩展（增加估值框架展开 + 行业位置解读两步）。

报告按模板撰写完成后，**必须**执行以下六步合成（0/0b/1-4）。这不是 checklist——这是你的核心分析工作。

### 0. 持仓透视解读（R12，行业/主题 ETF 必选）

`holdings` 数据（前十大名单 + 集中度）的核心分析价值 = **修正「名义主题 vs 实际暴露」偏差**：

- 名义主题（如「卫星产业」）vs 实际暴露（前十大若 8 只集中于制造环节 → 实际是「军工制造」）
- 集中度数字（top1/top5/top10，引擎计算）引用引擎字段，**AI 不得心算**
- 聚类合计引用引擎 `clusters` 字段（HOLDINGS_CLUSTER_MAP 聚合，AI 不心算）；未映射股票归入「未归类」，报告层补充归类须标注「AI 归类」；行级细标签（光模块/存储芯片等）为 AI 标注，与聚合分组区分
- 权重股事件风险快速筛查：前十大中是否有停牌/解禁/暴雷风险标的（无需深研基本面）

### 0b. 赛道资金流解读（R13，行业 ETF 必选）

`peers` 数据（同赛道份额资金流 + RS）的解读边界：

- 资金流（20 日/近 5 日，Tushare 份额×均价估算，T+1 延迟）为**资金流主证据之一**，与 invest-a-pulse 主线确认原则一致
- RS（基准=同赛道等权均值）仅作**状态参考**，非交易信号；20 日收益排名描述相对强弱，不构成「接棒」预测
- 赛道口径（peer_source）含宽口径成员（如军工龙头）时注明，AI 可解释
- 主标的份额流 vs 同行对比：背离（如同行流入、本标的流出）是值得展开的矛盾点

### 0c. 资金流趋势解读（R15，行业 ETF 必选）

`sector-flow` 数据（THS 行业 3/5/10 日净额 + 趋势）的解读边界：

- **三源对照**：同花顺行业净额（大单口径）+ R13 ETF 份额流（配置口径）+ pulse 涨停热度（游资口径）——共振确认主线、背离展开矛盾（例：医药涨停第一热度但行业净额 -15 亿 + ETF 份额 -26 亿 → 题材短炒）
- **证据非信号**：趋势标签（持续流入/近端回流/近端退潮/持续流出）只描述引擎判定的方向/强度事实，**禁止**据此做方向性预测
- **趋势与日期配合**：方向/强度标签一律引用引擎字段（近端加速/减速为引擎输出，受量级守卫约束），不做引擎之外的强度断言；5 日变化率/转向需积累序列（≥6 日快照），积累不足标注「积累中」不硬编，快照跨度 trend_span_days ≠7 日须标注
- 口径声明：大单口径、日间净额噪声、THS 90 为权威（东财仅定性对照、差异名注明）

### 1. 估值框架展开（行业 ETF 必选，宽基 ETF 可选）

如果 `valuation_guide` 存在（行业 ETF），必须展开分析：

- 解释 `primary`/`secondary` 指标为什么适用这个行业
- **如果 `pe_timing=false`，必须明确说**：PE 不能用来判断这个 ETF 的买卖时机。给出替代判断框架（如看 CAPEX、看出口增速、看政策节点）
- 如果 `pe_timing=true`，说明 PE 分位在什么范围对应什么历史情景

格式（报告内段落）：
> **估值框架**：通信行业 `pe_timing=false`——PE 不能用来择时。通信 ETF 的正确估值框架是：① 跟踪运营商 CAPEX（钱在不在投）；② 跟踪光模块出口增速（收入端）；③ PE=25.69 本身不告诉你是贵还是便宜。

### 2. 行业位置解读（行业 ETF 必选）

如果 `industry_pe` 存在，必须引用 `industry-pe` 命令输出的 31 行业排名：

- 该行业 PE 在全市场排第几？在 TMT 赛道（电子/计算机/通信/传媒）内排第几？
- 这个位置的含义是什么？（如"TMT 中最便宜，但这不意味低估——通信天然比半导体估值低"）
- ⚠️ 行业 PE 是代理值，非 ETF 精确 PE，必须标注

### 3. 对抗性假设检验

对报告中每个关键假设，找出其**可证伪条件** — 未来什么可观测数据会让这个假设不成立。**重点攻击你自己报告中最核心的判断，而不是边角料。**

格式（报告内表格）：

| 关键假设 | 可证伪条件 | 观测窗口 |
|----------|----------|:---:|
| "CAPEX 结构转型利好通信 ETF" | 前十大权重中光模块/算力设备占比 <30% | 需核实持仓 |
| "RSI 近超卖是短期超跌" | RSI 跌破 25 且持续 >5 个交易日 | ~2 周 |
| ... | ... | ... |

**硬约束**：
- 至少 3 个关键假设，每个必须有可观测的证伪条件
- 不可证伪的假设须标注「不可验证，置信度降级」
- 观测窗口必须是具体时间或事件节点，不能是「待观察」

### 4. 「致命一击」+ 盲点检查

**致命一击**：用一句话回答——**如果这个分析错了，最可能是因为什么？**

> **1 个月持有的最大风险**：[X 条件]。若 [Y 可观测触发]，当前分析框架的 [Z 方向性判断] 失效。

**盲点检查**（≥2 条）：
1. 有什么重要变量完全没有被讨论？
2. 当前共识最可能忽略什么风险？
3. 如果一个月后回头看，今天最明显的盲点会是什么？

格式：
```
🔍 盲点发现:
- [盲点 1] — 当前: [未知/数据不可得/未覆盖]
- [盲点 2] — 当前: [未知/数据不可得/未覆盖]
```

---

## Self-Check

> **共享清单**：[report-conventions.md §7](../../../skills/lib/references/report-conventions.md) Self-Check（通用 + etf 专项）。

发出备忘录前：

- [ ] 无「建议买入/卖出/持有/加仓/减仓/止损」
- [ ] 无无假设的「目标价 XX」
- [ ] 每个关键数字有来源
- [ ] 用指数 PE / 行业 PE，非个股 PE 叙事
- [ ] 首尾有风险声明
- [ ] [事实]/[分析] 块带 SOP-EV 证据标签（共享规范 §5）
- [ ] 措辞无违规（共享规范 §3）
- [ ] 行业 ETF：估值框架已展开（`valuation_guide` 不是一行标签）
- [ ] 行业 ETF：行业排名已引用（`industry-pe` 31 行业位置 + TMT 赛道位置）
- [ ] 份额趋势已查询（`etf_share_flow`），有数据则展示，无数据则标注"积累中"
- [ ] 持仓透视已查（R12 `holdings`，行业/主题 ETF），集中度数字引用引擎 top1/top5/top10 字段，AI 未心算
- [ ] 聚类合计引用引擎 `clusters` 字段（AI 未心算）；未映射部分 AI 补充已标注「AI 归类」；「名义主题 vs 实际暴露」偏差已解读
- [ ] 赛道资金流已对比（R13 `peers`，行业 ETF；未映射时标注「请用 --peers 显式指定」），RS/资金流数字引用引擎字段
- [ ] 资金流向与趋势已查（R15 `sector-flow`，行业 ETF），3/5/10 日净额与趋势标签引用引擎字段，AI 未心算；单时点分解未作方向性预测（证据非信号）
- [ ] 盘面结合已对照 pulse `zt_industry_flow`（同源行业直接对照、差异名已注明）；口径声明（大单/日间噪声/趋势需与日期配合）已写入
- [ ] 对抗性假设检验：≥3 个关键假设有可证伪条件，核心假设被检验
- [ ] 致命一击：一句话条件式风险归纳，指向可观测失效条件
- [ ] 盲点检查：≥2 条盲点发现
- [ ] 关键矛盾已识别（如 CAPEX 总量降 vs 算力增），不是数据点的罗列
- [ ] 文件名包含实际北京时间（非硬编码）
- [ ] 极值断言（峰值/最大/最低）基于全量序列 Python 聚合，非打印子集（R1）
- [ ] 无「Python calc 视角」类未实跑标注——来源标注仅两种：引擎字段 / `[来源: Python calc: formula]`（共享规范 §2.3 强制行为 5）
- [ ] 检索/新闻口径数字带「检索摘要口径，出处待核实」标注，未归因到未读原文的媒体（R2）
- [ ] 计数经 Python（`len()`），无目视计数（R3）
- [ ] **报告复检流程已执行**（CLAUDE.md「报告复检流程」三层：数字对照→合规核对→逻辑自洽），并向用户汇报复检结果

---

## 与其他 Skill 的关系

| Skill | 关系 |
|-------|------|
| **invest-a-journal** | 方案四维评估；ETF 数据经 shim 调用本模块 |
| **invest-a-stock** | 个股深研；本 Skill 不替代。主题逻辑可引用龙头个股报告 |
| **invest-a-gap-scan** | 市场扫描；无关 |
| **invest-a-pulse** | 涨停行业热度（zt_industry_flow）供 R15 盘面结合对照（三源之一：同花顺净额 + ETF 份额 + 涨停热度）；报告层引用，引擎不跨 skill 耦合 |

---

## 参考

- [references/report-template.md](references/report-template.md)
- [references/etf-hedge-map.md](references/etf-hedge-map.md)