invest-a-stock 投研助手

工具约束说明：frontmatter 的 allowed-tools 是 Claude Code 约定；在 DSH 等不读取该字段的 harness 下不生效，实际可用工具由平台自身沙箱控制。本技能主体操作为本地数据采集与计算（Bash/Python 引擎）；新闻、研报与政策证据检索经 WebSearch/WebFetch 补充（平台不可用时标注数据缺口）

OUTPUT CONTRACT（LAWs）

以下法则约束所有输出。违反即为 Bug。

契约 A：合规与非决策边界

A1（原 LAW 6）— 禁止买卖建议、仓位建议。 允许多情景估值参考价（须假设前提+概率权重+免责声明）。禁止无假设的单一目标价。

A2（原 LAW 6a）— 允许「交易结构分析」（假设一致性检验）；详见 references/trade-structure.md：

• 基于多情景估值推导条件性估值区间（标注锚定哪个情景 + 对应的假设前提）（v0.3.1 A5：原称「入场区间」，动作暗示强，已全链改称）
• 基于假设追踪输出复核触发（假设被证伪时启动重新评估流程）。触发 ≠ 离场。
• 操作纪律（研究流程规则，如"季报后 48 小时内 thesis --update"）
• 允许"条件性估值区间/复核触发/操作纪律"，仍禁止"建议买入/卖出/建仓/加仓/减仓/止损/止盈"
• 条件性估值区间 ≠ 买入建议：它告诉你"在中性假设下，估值模型给出的合理价格带"，由用户自行决定是否、何时、如何行动
• 每条复核触发须绑 fact_id + 来源 + as_of + 情景前提 + 可证伪条件；无已登记 thesis 时只渲染「基线：信息不足，不能形成研究进入条件／复核触发」，不得编造条件

A3（原 LAW 9）— 无数据源支撑的分析不输出。 某维度未取得可验证数据时：列出已尝试来源与失败原因，标注"未获取到任何有效数据，无法判断"，给出补证路径；不生成数值情景、概率、归因或交易结构字段。

A4（原 LAW 3）— 区分"事实陈述"与"分析判断"。

契约 B：数字纪律（P0）

B1 — 禁止 AI 心算。 一切数值须经 Python 引擎或脚本计算；引擎未覆盖的字段，先用 Python 算一遍再作引用源。

B2 — 引擎清单的二次加工必须跑 Python 聚合。 从引擎输出的清单（big_move_days 数组、份额流 rows、事件表等）中计数、算比例、做区间推导，禁止目视。

B3 — 极值断言须全量核验。 断言"峰值/最大/最少/首个"前，必须对全量序列跑 Python max/min，禁止凭打印的子集断言。

B4 — 来源标注仅两种形态：[来源: 引擎字段名] 或 [来源: Python calc: formula]。其余未实跑字样（"Python calc 视角"、"复算一致"、"自洽校验"、"口径源自引擎"）一律禁止——要么真跑 Python，要么删除该数字。

契约 C：溯源与不确定性

C1（原 LAW 1）— 每条分析论述必须引用数据来源。

C2（原 LAW 7）— 每个数字标注追溯路径；References 表须含 API/query 参数。

C3（原 LAW 12）— 结论附带证据强度：✅ 强 / ⚠️ 中 / ❓ 弱。

C4（原 LAW 5，判定规则重立）— 多源取证（旧「并行取证」措辞已废止：它与实现的首选源单发/降级语义矛盾）。各渠道独立记录；全失败须标注"未获取到任何有效数据，无法判断"。分类规则：

• L2 财务／估值（有可比独立来源）→ 并行双源，先到先用；双源冲突并列不裁决；任一源缺口不自动补值
• L3 行情／快照 → 按优先级 cascade，首源成功即可停止（不强制补验）；源失败按序降级；全失败＝不可得
• 单一权威源字段 → 单源可用，但须标明单源事实与可得性边界，不伪造第二源
• 新闻／事件／传闻 → 一手优先，二手只作线索不可取代一手核验；无一手确认时标待核验
• 输出须披露：实际使用源 / 尝试链 / 抓取时间 / as_of / 降级原因

契约 D：结构与表述

D1（原 LAW 4）— 风险声明出现于首屏显著位置 + 尾部。 首部 boilerplate 须是完整可见的非投资建议/风险声明，不得以"置尾"为由删去（AGENTS.md 首部／尾部两项检查项）。

D2（原 LAW 8）— 每个维度末尾要求"🔍 待独立验证项"。

D3（原 LAW 16）— 左/右概率并列呈现，禁止单一「左侧/右侧」结论；概率为主观估计时须标注「研究框架估计值（非统计频率）」（共享规范 §2.3 强制行为 5）。

D4（原 LAW 17）— 结论先行（金字塔结构）：简报和报告均采用结论→论据→细节倒金字塔——首屏核心结论+逻辑链、标题传递信息量（完整判断句）、段首加粗主旨句、看摘要等于看全文（完整铁律见 report-conventions.md §1.1）。

降级与废止（legacy 编号逐条列出，便于下游引用解析）：

• 降级为模块规格：LAW 10、LAW 11、LAW 13、LAW 14、LAW 15 —— 条文仍有效，执行位置移到 references/modules.md（模块 0 问题卡 / 模块 2 动态驱动 / 模块 4 静态基本面 / 模块 5 市场分歧）与 references/deep-sop.md。
• 废止：LAW 2（v0.1.2 七段结构，与现行九模块冲突；现行结构由 modules.md 承担）、LAW 5（旧「并行取证」措辞；内容已由 C4 多源取证重立）。
• 18 个 legacy 标识与子条款的 canonical 映射表见 host-docs/v0.3.1/law-contract-v0.3.1.md（维护者材料，不随包分发，故此处只用纯文本指针，不留相对链接）。

常见违规模式

通用违规模式（左侧/右侧、买卖建议、目标价、往往/通常、PE 分位、极度高估、K 线断言主线等）见 report-conventions.md §3.2。以下为 stock 特有项：

措辞规范

Canonical 源：skills/lib/references/report-conventions.md §2 硬约束 + §3 措辞规范 + §1 输出格式。

§2.3 事实边界（最高优先级）：禁止猜测/推断/幻觉。引擎/数据源没有的字段写「未知/不可得」，不推断；「检索不到」不得断言「数据不存在」（可能被付费墙/权限遮挡），只允许「公开不可独立验证」；数据冲突并列报告不自行裁决；每个数字必须带来源（引擎字段 / [来源: Python calc: formula] / 一手源）。

禁止：买入/卖出/持有/建仓/加仓/减仓/止损/止盈、建议（某价格）买入/卖出。

允许（契约 A2 / 原 LAW 6a 交易结构分析）：条件性估值区间、复核触发（假设失效触发）、操作纪律、情景锚定。

报告路径：reports/{symbol}-{name}/{YYYY-MM-DD-HH-MM-SS}.md，Claude 内只输出简报。详见共享规范 §1。

数据源策略

v0.2.4 R12h 多源降级链：L3 行情类（kline/quote/basic_info/shareholders/northbound）首选源单发、失败按序降级（cascade）；L2 财务类（financials/valuation）并行双源先到先用。

跨源差异的处置不是「事后靠 agent 发现」：引擎在渲染层自动算跨源偏差并落「数据验算警示（financial_rigor）」段（financial_rigor.py：>5% 记 ❌ fail、>1% 记 ⚠️ warn，--strict-rigor 追加降级提示），差异明细同时保留于 _meta.all_sources。分析阶段只做两件事——并列复述（A 口径 X vs B 口径 Y）与标注口径，不得自行裁决谁对（共享规范 §2.3 强制行为 4）；警示段标 ❌ 时，相关估值段须按 --strict-rigor 的语义处理，标注「仅供参考，须独立核验原始数据源」（该提示由 --strict-rigor 渲染，未开该旗标时须由分析段自行补标）。

Skill 身份声明

研究工具，非决策工具。 多因子交叉验证、归因讨论、概率结构；不做买卖/仓位建议。

多源取证哲学

按数据类别分流，而非一律并行（旧「全部可用源并行查询」的表述已废止：它与首选源单发／降级的实际实现矛盾）：

• L2 财务／估值（有可比独立来源）→ 并行双源，先到先用；双源冲突并列不裁决；任一源缺口不自动补值
• L3 行情／快照 → 按优先级 cascade，首源成功即可停止，不强制补验
• 单一权威源字段 → 单源可用，须标明单源事实与可得性边界
• 新闻／事件 → 一手优先，二手只作线索

各渠道独立记录；全失败 → 按 A3/C4 标注「未获取到任何有效数据，无法判断」；多源有数据 → 标注以何为主，并披露实际源 / 尝试链 / as_of / 降级原因。

输出格式（层叠输出）

第一层（Claude 对话简报）：结论先行、逻辑链闭环、一屏可扫描。禁止展开完整九模块。模板如下：

简报铁律

• 结论在首屏：读者 30 秒内看到核心判断，禁止以问题卡/模块编号开头。风险声明按 D1 置于首屏显著位置（不得删去），但其篇幅不得挤占结论——D1 管「声明必须在」，本条管「谁先说」
• 每条结论带逻辑链：数据 → 推理 → 判断，一行闭环
• 标题即论点：禁止 "模块1：当前状态快照" 等名词标签，改为完整判断句
• 看摘要等于看全文：简报本身是完整判断，详细论证在 .md 文件中

简报模板（严格顺序）

模板使用说明： 以下 ## 标题为结构占位符，实际输出时须替换为传递信息量的完整判断句（LAW 17）。如 ## 核心结论 → ## {一句话概括最重要的判断}。段首必须加粗主旨句。

# {name} ({symbol}) — {date} 研究简报

## 核心结论
[2-3 句最重要的判断，每条携带支撑数据]
[证据强度: ✅ 强 🌐 多源 📅 报告期已注明 ✓✓ 跨源一致]

## 逻辑链
1. 数据 A → 推论 B → 子结论 C
2. ...
∴ 核心判断

## 位置感
周期位置: [...] / 估值位置: [...] / 市场态度: [...]

## 多模块结论速览
> 模板表内每个数值都须带来源（P0）：占位处照写 `[来源: 引擎字段]` / `[来源: Python calc: formula]`，禁止留空来源。

| 维度 | 结论 | 关键数据（逐项带来源） | 逻辑链 | 置信度 |
|------|------|---------|--------|:------:|
| 估值 | PE 38.5x, 92% 分位, 已定价乐观预期 | PE 38.5x [来源: valuation.pe_ttm] vs 中位 18.2x [来源: valuation.pe_median] | ... | ⚠️ |
| 经营 | ... | ... [来源: …] | ... | ... |
| 资金 | ... | ... [来源: …] | ... | ... |
| 催化 | ... | ... [来源: …] | ... | ... |
| 风险 | ... | ... [来源: …] | ... | ... |

## 多情景参考
| 情景 | 核心假设 | 传导路径 | 估值区间 | 概率（研究框架估计值，非统计频率） |
|------|---------|---------|:------:|:---:|
| 乐观 | ... | A→B→C | XX~YY [来源: Python calc: …] | 30% |
| 中性 | ... | ... | ... [来源: …] | 40% |
| 悲观 | ... | ... | ... [来源: …] | 30% |

## 关键观察节点
| 时间 | 事件 | 验证什么 | 如何修正判断 |
|------|------|---------|-------------|

## 交易结构分析
> ⚠️ 假设一致性检验，非买卖建议。条件性估值区间基于多情景估值按 3 段参考输出（悲观锚区/中性-悲观区/中性锚区），不设触发条件/比例；量化风险收益指标见 `invest.py risk-reward` 子命令（研究指标，非交易比例）。

### 条件性估值区间（基于情景锚定 — 3 段参考，不设触发条件/比例）
| 情景锚定 | 价格区间 | Forward PE | 假设前提 | 该区间的状态含义 |
|---------|:------:|:-----:|---------|------|
| 悲观锚区 | XX~YY | — | 悲观假设全部兑现 | 市场定价比悲观情景假设更差——悲观假设可能已被证伪或超预期恶化（描述含义，非操作指令） |
| 中性-悲观区 | XX~YY | — | 悲观叙事部分定价 | 悲观叙事开始定价、尚未全部兑现，安全边际在收窄 |
| 中性锚区 | XX~YY | — | 当前中性假设全部成立 | 中性假设全部兑现时的合理价带，无安全边际 |

> 条件性估值区间 ≠ 买入建议；分批动作与比例由用户按自身纪律执行。

### 复核触发（假设失效触发）
| 条件 | 类型 | 触发后动作 |
|------|------|----------|
| ... | 假设证伪/叙事动摇/财务恶化 | 重新评估/下调情景/收紧估值前提 |

### 操作纪律
1. 定期检查（季报后 / 宏观重大变化 / 价格落在极端区间）
2. 假设追踪（thesis --update 对照假设 vs 实际）
3. 假设完整度（被弱化/推翻的假设 > 半数 → 启动全面重评估）；资金与仓位安排由用户按自身纪律决定，不在本研究输出范围内

## 主要风险
[3-5 条，标注严重度 🔴/🟡/🟢]

## 致命风险
> 若 [X 可观测条件] 发生，当前核心判断 [Y] 失效。

## 盲点
- [盲点 1] — 当前: [未知/数据不可得]
- [盲点 2] — 当前: [未知/数据不可得]

> ⚠️ 免责声明：本简报由自动化引擎 + Claude 分析生成，不构成投资建议。完整报告见 `reports/{symbol}-{name}/{YYYY-MM-DD-HH-MM-SS}.md`

第二层（.md 文件）：完整备忘录 + References（见 references/references-format.md），采用 LAW 17 金字塔结构。

Insight 层（report --mode insight，v0.3.0 MVP）：面向阅读的研究要点，由确定性 Facts / Findings 模型生成。首层只给可追溯结论、核心矛盾、分析合成、反证/关联边界、观察节点与补证路径；九模块原始表和公式继续留在 full 审计底稿。每次同时落盘 .facts.json、.insight.json 与 .report.json，Markdown 与 HTML 只能消费同一代 Finding。证据不足时明确标为「分析未完成」，不以空模板或数据罗列伪装完成。

分析合成注入（--analysis）：传入时把 analysis.json 渲染为「分析合成（Claude 撰写）」独立分区（置于核心矛盾之后），并落同代 <ts>.insight.analysis.json 侧车、在 manifest 登记 analysis_sidecar。该分区不是 Finding：不参与 findings / core_tension / analysis_chains / completion 的任何推导。段内数字先由 facts 数组检查 [事实: F{n}] 引用与 formula；固定快照链进一步按 source_path 对封存数值，外部 source_url 仍由研究者读原文核验。未声明 facts 的段不触发字段级校验，其可审计性止于「来源 + 同代绑定 + 段级证据等级」，不得承载未经核验的关键数字。completion 与 synthesis.status 是两条独立状态轴——AI 散文不得把「证据不足」抬成「分析完成」。未传 --analysis 时不渲染分析合成分区、不写分析侧车；既有输出契约不变，但有两处新增字段（非逐字节一致）：状态卡多一段「分析合成：未注入（仅引擎结论）」，.insight.json 多一个 synthesis 键（status="absent"）。以逐字节基线验收的消费者需知悉。

第三层（concise 对话模式，按需专项）：Hermes/OpenClaw 等对话场景使用。结论先行 + 关键数据展开块。3-5 段核心结论直出，详细数据用 <details> 折叠。CLI 对应 --mode concise。

v0.3.1 D1：退出默认流程（代码保留）。 默认交付链不提示该模式，需要时显式指定。依据：本机 603 份报告侧车统计中 concise 使用 0 次（host-docs/v0.3.1/默认报告内容取舍清单_20260925.md §1.1）——这是本机观察结果，不外推为「无人使用」，故只退出流程而不删代码。

Concise 输出契约

对话场景下遵循以下两层结构：

第 1 层 — 结论速览（3-5 段，最先输出）：

第 2 层 — 关键数据展开（<details> 块）：

<details><summary>展开：财务速览</summary>
| 指标 | 最近报告期 | 趋势 |
ROE / EPS / 毛利率 / OCF/净利润
</details>

<details><summary>展开：估值位置</summary>
| 指标 | 当前值 | 历史分位 | 中位数 |
PE / PB / PS
</details>

<details><summary>展开：资金行为</summary>
- 北向资金 / 股东户数 / 内部人信号
</details>

强制规则：

1. 结论速览第一条输出，不得在前置过程后
2. 每条结论附来源标签
3. Bull/Bear 含数值假设
4. 禁止输出完整九模块
5. 按"假设→证据→结论"链式排列

SOP-QC 自检

机器层准出（写入后必跑，非可选自检）：uv run python skills/lib/report_qc.py <报告文件> --fail-on error → 无 error 级发现（overall ≠ FAIL）方可交付；sourcing warning（F2 派生词缺来源 / F4 §N 引用不存在）须人工复核后消除或说明。这是「标准交付链」的第 4 步（见下节 CLI 命令），不是事后补做的收尾动作——--analysis 注入与本次 QC 同属链上步骤。

共享清单：report-conventions.md §7 Self-Check（通用 + stock 专项）。

措辞（LAW 6/16/3/17）、结构（简报一屏内、首屏含结论+逻辑链、标题传递信息量、段首主旨句、风险提示首尾、LAW 7）、数字（P0 铁律：全部经 Python——引擎字段直引或 [来源: Python calc: formula]；无 LLM 心算/目视计数/清单目测/未实跑标注；计数断言 len() 聚合，见共享规范 §2.3 强制行为 5-7；[分析] 事实性前提须带来源/「框架性陈述/待验证」标注（强制行为 7））、证据（SOP-EV、分位伴中位数、Bull/Bear 数值化）、分析合成三步（对抗性假设检验覆盖实际关键假设（不设固定条数）、致命一击条件句、盲点逐条列出（不设固定条数，不得为空），详见共享规范 §4）。财报专项的 Bull/Bear 撰写与快速否决 8 条见 financials.md F-2 / F-3。

分析合成三步（所有模式强制）

Canonical 定义：report-conventions.md §4 分析合成框架。完整表格/示例/硬约束见共享规范 §4，此处仅列 stock 硬约束行：

简报和完整报告均须包含以下三步，不可跳过：

1. 对抗性假设检验：逐一检验实际关键假设（攻击最核心判断，不设固定条数），每项必须带可观测证伪条件 + 具体观测窗口（时间/事件节点）；不可证伪标注「不可验证，置信度降级」
2. 「致命一击」归纳：一句话条件句（若 [X 可观测] 发生，则 [Y 判断] 失效），禁止「市场风险」等标签式罗列
3. 盲点检查：逐条列出实际盲点（不设固定条数，不得为空），格式 🔍 盲点发现: - [盲点] — 当前: [未知/数据不可得/未覆盖]

SOP-EV 证据强度

按实际证据填写完整四维，顺序为强度→来源→时效→交叉；图标必须带匹配注解，不能只填图标或追加自由尾注。强度：✅ 强 / ⚠️ 中 / ❓ 弱；来源：🌐 多源 / 📡 单源 / 🔮 推测；时效：🕐 近 30 日 / 📅 近季度或报告期已注明 / 🗄️ 滞后 >1 年；交叉：✓✓ 跨源一致 / ✓✗ 源间有差异 / — 单源无验证。上方模板是格式示例，不能照抄其证据评级；正文判断另带来源/事实绑定。

专项加载与 intent 路由

执行前用 Read 加载对应专项（完整 report --deep 加载全部）：

规则：专项单独运行仍须 evidence；完整分析用 report --mode full；读者优先的确定性研究要点用 report --mode insight（--mode 允许 brief/full/concise/insight——默认面是 full；concise 与 brief 为按需专项，见 D1/D2 裁决；不用 --mode=sentiment）。

九模块结构详见 references/modules.md。财报 F 规范详见 references/financials.md。

R12f 分析深化契约（v0.2.4，简报铁律升级）

用户画像：调用本 skill 的用户大概率已在交易软件看过现价/走势/图形——基础行情数据用户已有。期望的是"为什么、然后呢、怎么办"，不是数据罗列。

三条铁律：

1. 默认跳过行情罗列：现价/涨跌幅/MA/RSI/BOLL 等只作引用（一句话带过或进表格），不展开描述"价格 X、涨跌 Y、均线 Z"——除非用户明确要求基础行情。
2. 每个数据必须带 so-what：引用任何数字后紧跟"这意味着……"——数据 → 归因（为什么）→ 推演（然后呢）→ 预案（怎么办）四层递进。禁止"数据表 + 无解读"。
3. 分析主轴 = 核心矛盾：简报以"核心矛盾 → 归因 → 多情景推演 → 失效触发"为骨架，而不是"模块 1 → 模块 2 → …"的流程罗列。R1 收益驱动假设 + R12d 模块权重决定矛盾主轴（期权型=事件链，周期型=稳态视角）。

执行检查：简报完成后自查——"如果用户删掉所有数字，只剩我的判断句，还能读吗？"若不能（判断句依赖罗列支撑而非逻辑链），重写。

R12a 关联数据挖掘 SOP（v0.2.4，采集后、合成前强制）

动机：引擎按固定维度清单采集，无法覆盖"这家公司特有的数据"（分部收入、订单/临床里程碑、可比公司、行业技术路线）。引擎没采到 ≠ 数据不存在——先找材料，找不到才标「数据不足」（借鉴 ai-berkshire "材料驱动"）。

采集完成后、合成报告前，必须执行以下四步（每步 ≤2 次查询新闻/研报——WebSearch / web-search 技能 / /web，视 harness 而定；遵守 agent-prompts.md 搜索纪律——并行批搜 + search_cache）：

同一快照的 evidence、首版 MD 和已知公告 ID／分部缺口的原文检索可并行；它们必须引用同一个 collection_id。检索前列出有限问题清单，批量提交可并行查询并按 URL 去重；每份用于结论的材料记录 URL、发布日期、抓取时刻、原文定位和核验状态，标题或摘要仅作线索。草稿提出新问题时只针对具体缺口做一次有界补证，写独立证据记录；若改变数值输入，重新采集并生成新 ID，不修改旧快照。

STEP 1 公司画像锚定（必做）：主营构成/收入分项（修正引擎行业标签）+ 客户结构 + 技术路线一句话 → 「公司画像锚定」小节（来源 + SOP-EV）
STEP 2 数据缺口回填（classify / --material-gap / 12 题缺口项）：营收净利→财报摘要源；现金流应收存货→年报附注；分红再融资→公告；每项带来源，回填不到 → 「数据不足 + 原因 + 建议补查路径」
STEP 3 可比公司挖掘（12 题 D-②/A-③ 触发时）：同行 3-5 家 + 毛利率/ROE/PE 相对对比（引擎算，AI 引用）
STEP 4 事件链挖掘（公告 + 新闻 + 订单/临床/扩产里程碑）：事件-价格对照 + 可观测节点 → 观察节点表

硬约束：

• 数据缺口项（report --material-gap 输出）回填优先于分析撰写
• 关联数据必须带来源与 SOP-EV；无源断言 → 删除（LAW 3/9）
• 画像锚定发现引擎行业标签与实际业务不符 → 以画像为准，标注差异
• 材料不足的题目允许「数据不足 + 原因」，禁止用推测填充

R12d 模块权重自适应（v0.2.4，依赖 R1 classify）

借鉴 ai-berkshire "模板是长出来的，不是套子"：同一套九模块不适合所有标的。classify 输出收益驱动假设后，按四分支调整模块权重——基本面框架对"期权型/周期型"标的解释力有限，事件链与周期位置升权。

执行：报告每模块标题后附 [权重: 标准/参考/升权] 标注；「暂无法判定」标的的观察节点表必须以事件里程碑为主轴（临床/订单/注册节点），而非财务季报。

禁止：模块降权 ≠ "该标的不值得分析"定性（B 裁决：不自动断言无投资价值）；权重调整只影响分析重点与顺序，不影响 LAW 输出纪律。

R4 行业成功关键因素（v0.2.4，行业洞见层）

动机：通用 12 题是兜底清单，不是行业洞见——"每个行业都有 3-5 个决定成败的问题，答不出等于研究等于没研究"。

执行：报告头部 [行业成功关键因素（R4）] 块先答行业关键问题（引擎按行业路由，数据字段值从财务最新期取值），每项回答后再进通用 12 题。

• 已覆盖行业：银行（净息差 / 资产质量 / 资本充足）、电子半导体（产能周期 / 技术路线 / 客户结构）
• 未覆盖行业 → 输出「无行业成功因素定义」，回退通用 12 题，不得编造行业因素
• 引擎外字段（客户结构、技术替代等）→ 输出「需 AI 补查」，由 R12a SOP 回填

禁止：不引用数据字段值/来源的"成功因素"空谈；不跳过成功因素段直接进通用 12 题。

R5 行业景气状态卡（v0.2.4，结构性季节）

借鉴 A 的结构性四季（"AI 主题已入秋、消费处于寒冬后期"）：行业状态是可解释的，不是模糊感觉。五维独立呈现、≥3 维有效才给结论、政策维度必须官方来源。

命令：market-status --industry 半导体（独立输出，不进入 snapshot 流程）。

五维：① 估值分位（行业 TTM PE 在全体申万一级行业分布内的分位，sw_index_first_info）② 盈利趋势（申万行业指数月线方向，index_hist_sw）③ 相对强度（申万行业指数 vs 沪深300，relative_strength）④ 资金流（同花顺行业资金流净额）⑤ 政策证据（引擎不自动判定——由 SOP-M1/新闻检索（WebSearch / web-search 技能 / /web，视 harness 而定）引用官方文件填入；无官方来源固定「未查」）。

判定纪律（决策 U4）：

• 有效维度 <3 → 「数据不完整（有效维度 N/5）」+ 缺失维度清单，不做状态结论、不自动降级猜测
• 方向投票仅盈利趋势/相对强度/资金流三票（估值分位只定语境，政策证据不参与投票）；有效方向维 <2 → 无法定论
• 真值表：方向↑×估值低位→复苏；↑×中/高位→扩张；↓×高位→降温；↓×低/中位→收缩；平局→无法定论
• 各维度独立呈现，禁止单维下结论；政策证据任何情况下不改变状态判定

LAW 边界：状态卡是研究判断（可解释状态），不构成操作信号，也不携带任何仓位/交易含义。

禁止：有效维 <3 时编造状态结论；用非官方来源的政策证据；把状态卡当作买卖信号。

R7 成长股四分类分流（v0.2.4，R1=成长兑现 时启用）

R1 判定「成长兑现」后，分析模板按成长驱动来源进一步分流——四类成长的分析重点不同，套同一模板会答错问题。

执行：见 references/financials.md F-5 段（各分类的「分析重点切换」清单）；分类依据来自财务数据 + 业务画像（R12a SOP 回填），AI 不得凭空判定。

R12g 双路径分流 + 连板触发（v0.2.4，趋势路径引擎）

沃格（连板）、宜安（期权型）、588000（ETF）案例暴露：同一套九模块流程服务所有用户是错误的——用户风格决定分析主轴（开场四问见 R12g-B），趋势路径由引擎补强均线与连板结构。

引擎补强（本段，R12g-A）：

• 均线系统表：报告头部 [均线系统表（R12g）] 行——MA5/10/20/60 值 + 现价位置 + 排列标签 [来源: kline derived]
• 连板触发：近 5 日 ≥2 涨停（R12e 检测）→ 自动附加 [连板结构（R12g）] 段，并采集龙虎榜/涨停池（仅触发时，未触发零额外网络调用）

连板六步数据边界（AI 不得越界）：

注意：连板 ≠ 必然上榜（603773 8-04/8-05 双连板但双源龙虎榜均未上榜）——席位缺失时降级用资金流三日结构，不强行归因。

R12g-B 开场四问 + 双路径分流（v0.2.4，会话起点）

用户风格决定分析主轴（趋势 = 常见情况：当前时点 + 过去数据，MA5/20/60 是常用指标；价值 = 判断数月-数年后的可能性）。开场四问在 skill 会话起点执行（AskUserQuestion 一次性，每题带默认值）。

不必问的情形（共享规范 §1.3）：调用参数/命令已给出答案、档案已有可用默认（user_style.json 有风格记录、Q_已看默认「是」）、或流程已固定时，跳过对应问题直接开工，不重复录入；harness 无 AskUserQuestion 时改用一次普通对话提问或按默认值执行，不得因提问阻塞采集。四问只影响阅读顺序与深化方向，不改变取证范围。

四问结果的落点（v0.3.0 P0-5）：把四问答案经 report 的 --horizon（Q_周期）/ --focus（Q_焦点，可重复）/ --goal / --already-knows-price（Q_已看）传入；--style 缺省读 user_style.json（Q_风格），无需重复录入。引擎写同代 <report>.profile.json 侧车，并在 full 模式报告头部的「报告说明」块内展示。档案不是过滤器：它只改变阅读顺序与补证优先级，不得隐藏反证、关键缺口与风险。

风格↔Q1 驱动逻辑显式映射表（无对应项一律走中性，不自动推断）：

分流矩阵（Q_周期 + Q_焦点 决定主轴；取证范围不缩水）：

用户焦点 × 引擎判定仲裁（决策 U1）：

• 冲突矩阵（Q_焦点 × R1 假设）仅有「估值 × 暂无法判定」与「估值 × 周期均值回归」两格存在冲突
• 冲突时：用户焦点为主轴，同时输出引擎建议行（「引擎建议主轴：XXX，因收益驱动为 YYY」）并注明「方法论一致性」张力——不强行改主轴，不隐藏引擎判定
• 强制例外：周期均值回归标的用户选「估值」→ 估值输出必须并入 R2 稳态对照（当期低 PE 可能源于周期高位，引擎纪律不容偏好绕过）

概率来源标注：价值路径多情景概率 = 用户输入，或明确标注为分析假设并给出敏感性——禁止把概率包装成事实。

LAW 边界：趋势路径输出为状态描述 + 证据 + 可证伪条件 + 待核验节点（"MA5 上穿 MA20"是状态，不生成交易信号；不输出默认操作预案路径）；价值路径远期判断为多情景参考（LAW 6）。

数据来源

详见 references/source-guide.md。

报告产物协议（v0.2.8）

分析协议（analysis.json，v0.2.8）

报告步骤产出三类产物，同目录并存：md + analysis.json + html。

两处「默认」不是同一个口径，勿混用：CLI 的 report --emit 默认值是 md（保持既有单命令行为，不隐式改写）；本技能工作流的默认交付形态是 HTML——走步骤 3 时须显式写 --emit html（该分支同时写 md_v2，保证 md/html 同代）。未执行步骤 3 时 md 为唯一产物，属例外情形。

首屏不再放「判断索引」（v0.3.1 起移除）：正文最前直接进入研究问题与判断，不再列出「分类标签 + 各分析段标题」的索引层。删除理由：该层只复述各分析段标题，不交代判断，占用首屏却不提供信息增量（三份读者版样稿均未使用）。重要结论直接写进正文；需要导航时以正文小标题为准。

• 实施记录：analysis_schema.index_entries、md 侧 _render_judgment_index、html 侧 _html_judgment_index 及其专用常量已一并移除（2026-09-25，v0.3.1 A1）。analysis_schema 中供其他分析功能使用的键常量与 find_section 等保持不动。
• 分析段的分类标签不再进入读者面，module 仅作为 HTML 锚点与内部标识使用。

默认报告为「单文件双段式」（v0.3.1 A4）：--mode full 的正文分两段，边界即 md.index("<details>")。

• 单层折叠：--mode full 全篇只有审计底稿这一层 <details>——折内的 12 题、风险与不确定性、引擎自动空头链直接展开（原先它们是二级折叠，会让「展开审计底稿」之后这些节仍被藏住，与「底稿一层展开」的预期不符）。无底稿层的 brief/concise 保留各自的展开块。

写 overview 槽位时按阅读路径组织，不增删固定栏目：本次问题与数据截止 → 主判断（最多一条次判断）→ 决定判断的 3–5 项证据（数值 + 期间 + as_of + 来源）→ 竞争解释与边界 → 多情景前提与失效条件 → 下一步最值得核验。每段 title 写完整判断句（D4 原 LAW 17）且短（一句话，不复述段内全部数据）；段数由证据量决定，证据不足就少写、写「尚不能回答」。阅读预算：首屏约 300–500 汉字，主阅读面 1,500–2,500 汉字。

阅读区写作规则（v0.3.1 阅读验收）：按「数据 → 事实逻辑 → 可追溯方法框架 → 有边界的分析结论」写，短标题、少量关键事实（完整表放正文现有宿主），核验段用「问题/候选解释（非穷尽）/判别数据/观察节点」，方法框架须可核验、情景前提按引擎实际模型、首屏不写开发返工记录；业务与产业位置须用封存分项数据 + 来源路径，行业映射只作分类层面声明（不验证竞争优势/定价权）。完整条文（含段数按证据量、同一主阅读面去重、迁移段非默认机制）见 report-conventions.md §5.4。

• 去重硬约束：同一结论只说一次——同一读数/判断（如 PE/PB 历史位置）在同一主阅读面只出现一次、由其主段承担。与正文底稿/分析详情的重复不算首屏重复——允许关键事实从底稿引用，正文明细保留不当作首屏重复。唯一例外：event_classification 槽位仍有两个宿主（§3a 与 A-5 单元格），属已知遗留，见 host-docs/v0.3.1/默认报告内容取舍清单_20260925.md §4.2。
• 折叠对门禁透明：lint 与 report_qc 的结构/完成度层都按行首 ^## 工作，折叠不改变其判定；readability_metrics 仅跳过 full 报告的「审计底稿」折叠跨度。insight、brief 与 concise 的其他折叠内容仍计入篇幅。

1. 先出 md：report SYMBOL → reports/{symbol}-{name}/{ts}.draft.md（分析段以占位符保留，qc 的 F0-3 会拦截未填占位——正文写完立刻填写）
2. 再写分析协议（输入路径任意；引擎会把已校验的段原样复制到 <报告>.analysis.json 同代侧车，故建议直接写在报告同目录），段结构： [{module, title, facts_md, analysis_md, evidence_tag, position, facts?}]
   • facts_md：事实块（带 [来源: ...]）；analysis_md：逻辑推演（每条断言带 [来源: ...] / [证据: A-C] / 真实 [事实: F…]；证据强度标签仅是元数据，不能替代绑定）
   • evidence_tag：A-D 或 L1-L4，可附上述完整四维序列（如 B ⚠️ 中 📡 单源 📅 报告期已注明 —）；禁止任意尾注或半截序列；position ∈ events/valuation/financials/northbound/holders/refs/conclusion
   • facts（协议层可选，交付路径必填——P0 数字纪律的机器保证只在带它时生效）：固定快照链还须逐项提供 source_path（封存 JSON 的点路径，可用 dimension_by_name.<维度>.data...，必要时显式 source_scale）或外部原文 source_url；前者由 validate-analysis --collection-id 与 report --collection-id 复核数值，后者须人工核验原文。 本段数值事实数组 [{id: "F1", value: 12.5, formula: "…", field: "valuation.pe_ttm"}]。 value 必填且必为数值（只写 field 不写 value 会 fail-loud：value 必为数值）； field（来源标签）与 formula 均可选、不互斥，两者都省略时该 fact 无来源标签亦无复算。 不带 facts 的段照常通过（v0.3.1 #4 向后兼容契约，存量报告不受影响），但本技能交付路径 要求含数字的分析段声明 facts：未声明即视为「未审计研究注记」，其数字不得承载核心结论， 也不得据以给出证据强度标签。 一旦给出即强制：① value 必为数值；② 有 formula 时公式须能被安全求值且算出该数 （按书写精度判等——直接拦截「标了公式但公式算不出这个数」= report-conventions §2.3 强制 5 的未实跑标注）；③ facts_md/analysis_md 中的 [事实: F1] 引用须在本段 facts 内存在（防悬空）；④ 正文中每个非结构性数字（年份/日期/期数/序号/标的代码/ URL 内数字等豁免）必须对得上某个 fact 的 value。 ⚠️ formula 须是可求值算术式（仅数字与 + - * / ** ()）；agent_facts 表的 [来源: Python calc: …] 是散文式说明（含 ≤ × （），不可照抄当 formula （实测 11/11 条不可求值，照抄会被 fail-loud 拦下）
   • 校验：先运行 uv run python skills/invest-a-stock/scripts/invest.py validate-analysis <path> --draft <首版MD>（仅校验，不采集、不渲染；一次列出全部错误，并按本次初稿实际占位检查槽位），通过后再 report --analysis <path> --draft <首版MD>。后者也会在恢复快照或现场采集前校验，失败退出 2。
   • full 报告中填就地槽位：bull_chain（核对多头依据；替换引擎自动多头链）、bear_chain（空头依据）；有 MD&A 卡时 mda_narrative；有参与者扫描行时 participant_scan；有事件卡时 event_classification。以首版 MD 中实际出现的占位和 report_qc 为准，条件宿主未出现时无需硬填。bull_chain 的 facts_md 须列可追溯证据，analysis_md 须说明假设与传导；证据不足时明确披露缺口。
   • 槽位注入体例（#36 R2）：渲染器按各宿主体例输出 **[事实]** / **[分析]** / **证据等级：** 标签行（字段非空才逐行输出，体例随宿主而异——如 participant_scan 的 **[事实]** 行自带引导语），作者勿在 facts_md/analysis_md 里重复写这三个标签。四个槽位只消费 analysis_md（facts_md 不落地）：bear_chain、mda_narrative、participant_scan、event_classification（事件分类节注入完整 analysis_md；A-5 决策时间线另取其首行摘要）——证据与数字须写进 analysis_md；bull_chain 两者都落地（facts_md 列可追溯证据）。节边界只认行首 ## ：#### 子标题不截断 [事实]→[分析] 回溯。
   • 改动须知：facts 契约与 [事实: F{n}] 引用语法由 lib/analysis_schema.py 单点定义， 文档/prompt/校验三处须同步改（2026-09-18 review #3 的教训：三处不一致 → 闸门空转）
3. 复合重渲（工作流默认出 html；--emit 须显式写 html）：report SYMBOL --analysis <path> --emit html（或 --resume）→ 分析段替换占位 → {ts}.final.html + 同代 {ts}.final.md 同源落盘（--emit html 分支同时写 md_v2，保证 md/html 同代；不重渲则以 md 为唯一产物，属例外情形）

HTML 产物

• 默认路径：步骤 3 的 --emit html（工作流默认步骤，非可选项；CLI 旗标默认值仍为 md，两者口径差异见上），reports/{symbol}-{name}/{ts}.final.html（单文件自包含，无 CDN，file:// 离线可用）
• 若 <script> 未内联图表库（资产缺失）报告仍正常出稿（图表 disabled），语义同「数据缺失降级」
• --analysis <path> 在 HTML 中同样生效（分析段渲染进页面）
• full 模式 HTML 与 md 同源渲染分析段（--analysis）；首屏不再有「判断索引」层（v0.3.1 A1 移除），分析卡在页末，正文直接进入研究问题与判断

CLI 命令

标准交付链（唯一权威顺序 — 勿跳步，勿分散执行）

交付一条完整研究产物只有这一条链。--analysis 注入与末步 report_qc 是链上步骤，不是可省略的收尾动作。任一步失败即停在该步，不带缺陷往下走。

# 1) plan → 一次 report-ready 采集。plan 必须重定向落盘；无效/空计划会报错退出。
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py plan 600176 --intent deep_analysis > /tmp/plan.json
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py collect 600176 --plan /tmp/plan.json --report-ready
# 从上一条 stderr 的 collection_id= 读取本轮 ID；以下命令均填同一个 ID，不查“同标的最新”。
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py evidence 600176 --plan /tmp/plan.json --collection-id <本轮ID>
# 按本次四问替换下列档案值；焦点可重复。步骤 2、预检、终稿逐条传同一组值。
# 2) 出 md（分析段为占位符；qc 的 F0-3 拦截未填占位）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 --plan /tmp/plan.json --mode full --collection-id <本轮ID> --style <本次风格> --horizon <本次周期枚举> --focus <本次焦点枚举>
# 3) 写 analysis.json（含 facts 数组）→ 协议校验 → 候选完整 MD 的离线 lint/QC → 最终 HTML+MD
#    输入路径任意；引擎会把已校验的段原样复制到 <报告>.analysis.json 同代侧车（勿手写侧车路径）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py validate-analysis /tmp/600176-analysis.json --draft <步骤2 stderr 的 md 路径> --collection-id <本轮ID> --plan /tmp/plan.json
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 --plan /tmp/plan.json --mode full --collection-id <本轮ID> \
  --analysis /tmp/600176-analysis.json --draft <步骤2 stderr 的 md 路径> --emit html --preflight --style <本次风格> --horizon <本次周期枚举> --focus <本次焦点枚举>
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 --plan /tmp/plan.json --mode full --collection-id <本轮ID> \
  --analysis /tmp/600176-analysis.json --draft <步骤2 stderr 的 md 路径> --emit html --style <本次风格> --horizon <本次周期枚举> --focus <本次焦点枚举>
# 4) 机器准出（必跑；退出码 0=PASS / 1=WARN 可交付 / 2=FAIL 不得交付）
#    目标 = **步骤 3 刚落盘的 md**：路径逐字取步骤 3 stderr 的「📝 Markdown 报告:」行。
#    勿用 --latest——它按全局 mtime 取 reports/ 下最新 .md，并发或多标的时会复检到别的报告，
#    当前产物反而漏检（闸门空转）。
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/lib/report_qc.py <步骤3 stderr 的 md 路径> --fail-on error

collect --report-ready 封存市场结构（含 PCR 样本与来源状态）、事件、条件连板项、沪深300 基准序列（DCF beta 用，渲染链唯一的联网点由此前移）和默认 value 结果，输出 ID/hash；每条依赖另落 available/unavailable/not_triggered 三态（条件项未触发不算缺口）。绑定计划的快照在后续每条只读命令都须附同一 --plan；仅传 ID 或匹配维度不够。首次 report 用固定 ID 时会打印事实路径索引（写 facts.source_path 用）、数据时点/样本窗口与写作约束。evidence 与首次 report 用同一 ID 并行只读；R12a 一手核验可同时开始，分析须等证据与初稿齐备。value SYMBOL --collection-id <本轮ID> --plan /tmp/plan.json 读取同代默认估值；若需 --steady 等额外参数，须单列现场取证，不能称为同快照结果。候选 --preflight 须使用固定 ID，调用同一报告产物路径并仅在临时目录写入；Insight 候选含其 sidecars。最终 HTML 同代 MD 仍须对最终路径执行 report_qc 与三层人工复检。旧 --resume 保留兼容，会按最近 collect 快照恢复，缺扩展字段时仍可能现场补采（未封存快照会在 stderr 显式提示：补采仅本次、不写回快照），不用于固定输入链。

第 4 步之后仍须走共享规范 §7 Self-Check 与 delivery-qc.md §2–§5 的第 0 层机器准出 + 三层人工复检（数字 / 合规 / 逻辑），机器 PASS ≠ 可交付。

常用命令

# 按计划采集（intent: deep_analysis | quick_check | catalyst_monitor | compare | sentiment_deep | financials_deep | game_theory）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py plan 600176 --intent game_theory > /tmp/plan.json  # 必须重定向，否则下一条 --plan 读不到文件（见「标准交付链」）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py collect 600176 --plan /tmp/plan.json
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py evidence 600176 --plan /tmp/plan.json --from-store  # F2-3: 复用 collect 快照，跳过重复现场采集
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 --plan /tmp/plan.json --mode full --resume  # 复用采集
# 常用（collect 默认自动入库；--no-store 关闭；--mode: brief|full|concise|insight）
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py collect 600176
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 [--outdir=./reports/] [--deep]
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py report 600176 --mode insight --emit html  # 研究要点 MD+HTML+Facts/Findings 侧车
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py compare 600176 000858
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py diagnose
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py diff 600176
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py store list

运行目录：code/。必须用 uv run python（所有引擎命令已统一带 ${INVEST_SKILLS_ROOT:-.} cd 前缀）。子命令全清单以 invest.py --help 为准。

代理 / VPN

akshare/baostock 自动绕过 HTTP 代理；diagnose 可查 proxy_detected。规则与 TUN 说明见 source-guide.md。

引用格式（精简）

事实："数值" [来源: {路径} / {日期}] | 分析：[依据: …；逻辑链: …] | 推测：[推测，待验证]

完整规范：references/references-format.md

技术指标

MA/MACD 仅描述市场状态，不生成交易信号。

固定提示行（引擎/模板层，AI 不得删改）：

技术指标仅用于描述市场状态（价格与均线位置关系、MACD 方向）与交叉验证其他证据，不单独构成结论，也不构成任何操作依据。学术检验（Chen, Zhou & Wang 2018, Physica A）：沪深 300 期指 279 个技术策略计入交易成本后利润被完全消除。

信息深度匹配提示（C 原则 2）：对 R1「暂无法判定」假设或信息不足标的，自上而下（宏观/行业）视角比单票技术/财务深挖更稳健（Zurek & Heinrich 2021）——研究深度与信息可得性不匹配时，先补宏观/行业语境，不硬挖单票。

三维共振定位：技术形态是「产业趋势 + 技术形态 + 流动性」三维共振的交叉验证维度之一（模块 2 + 技术模块 + 模块 3），不单独构成决策依据。

采集顺序

diagnose → plan/collect → evidence（专项推荐）→ report → --analysis 注入 + --emit html → report_qc（机器准出）→ store（可选）

SOP-M1 宏观情景（--with-macro）

完整指标清单与输出格式见 report-conventions.md §9.1（宏观情景）。要点：full Markdown 报告首屏为分组展示块（短摘要 + 国内/海外指标表：读数/信号/来源/币种口径逐项准确，保留全部原读数；整块多行迁移，不得漏行进底稿；现有 HTML 产物无该块，属后续事项）；brief/concise 与 invest-a-pulse 仍用紧凑两段式标签（macro_signal_label 合同不变：首行「国内：PMI + CPI + LPR + M2 →政策方向 |」，次行「海外：VIX + SOX + 美 10Y/实际利率/期限利差/布油 →海外结论」）。海外段指标集由 TestLabelE2 锁定，不得删减；结论均由确定性规则生成，不由 LLM 书写；宏观状态只作背景锚定，不自动推演为公司成本/盈利结论。

CLI 扩展命令

cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py rigor 600176 --verify-all [--strict]   # 质量门
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py audit report.md --extract|--verdict  # 报告审计
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py check 600176                          # 质地 7 指标
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py portfolio holdings.json [--stress]    # 组合
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py thesis 600176 --init|--update|--status # 假设追踪
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py shock 300274 --pre-price 163.46 --post-price 140 --eps-base 6.55 --eps-hit 1.64 --pe-normal 27 --pe-stressed 20
cd "${INVEST_SKILLS_ROOT:-.}" && uv run python skills/invest-a-stock/scripts/invest.py collect 600176 --with-news-pack       # 新闻包

TAVILY_API_KEY 可选；无 Key 时 Layer3 静默跳过，Layer1+2 仍产出。

SOP-DEEP（四视角并行，按需专项）

v0.3.1 D2：默认不提示、不预设。 3+4 Agent 编排纯文档驱动（代码侧 --deep 只扩采集面：K 线窗口与 industry/research 维度，见 invest.py:_apply_deep_dims），只在需要更宽数据面与四视角交叉验证时显式 --deep 启用；默认研究流程不提示该路径。

完整流程（Phase 1 采集 3 Agent / Phase 2 分析 4 Agent / Phase 3 合成模板 / 四视角覆盖内容 / 交叉验证规则）见 references/deep-sop.md。report --deep 时主编 Claude 必须先 Read 该文件，其余流程不读。

要点：采集 3 Agent（财务 Tushare / 行情+财务交叉 akshare / 股东研报事件）并行 ≈ 30-40s；financials 跨源差异 ≥5% 触发第三方口径核对（并列呈现，不投票裁决，见共享规范 §2.3 强制行为 4）；分析 4 Agent 用 agent-prompts.md 模板；Agent 只调 Bash 不直连 API（防限流）；合成阶段执行分析合成三步（实际关键假设逐一检验，不设固定条数）。

SOP earnings-review（季报/年报后）

• 对比指引 vs 实际（营收/净利/毛利率）；OCF/净利润背离（阈值 0.6）；资本开支与产能叙事一致；thesis --update 更新假设状态

SOP industry-research / news-pulse

• collect --with-news-pack → 对 query_pack 查询新闻/研报（WebSearch / web-search / /web；Tavily 可选）回填 NewsCard
• NewsCard 只作线索：默认报告不再渲染新闻/公告标题表与固定「外生叙事」句（v0.3.1 A2 整段移除，卡数据仍留在快照 JSON 供回查）。要用某条事件支撑判断，须先取到原文再写进分析段——公告走 notice-body（art_code 或详情页 url；原文不改写 + 截断三态），检索源须打开原链核对；只有标题的条目不作证据
• 重大波动用 shock CLI 计算价格冲击插值比例（附学术声明）