# Serenity

> 结构化产业链 / 供应链瓶颈投研方法论。当用户想从一个市场热点、主题或叙事切入，拆解产业链层级、定位供给约束最紧的环节、筛出值得优先研究的公司或方向时使用；也适用于审视单一公司的产业链卡位、或对比多个候选的瓶颈控制力。仅提供研究框架与排序逻辑，不含任何数据；单纯查行情、跑回测、下单不需要本 skill。输出是研究优先级与证据链，不是买卖指令。

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

---


<!-- Adapted from muxuuu/serenity-skill (MIT). 改写说明见 ATTRIBUTION.md -->

# Serenity · 供应链瓶颈投研方法论

核心思路：**市场叙事 → 系统性变化 → 必需环节 → 产业链分层 → 稀缺约束 → 候选公司 → 证据 → 市场可能没看清的地方 → 什么情况说明判断错了**。

先排产业链层级，再排公司——用户应该先看到系统逻辑，再看到名单。

## 数据纪律（最高优先级，覆盖本 skill 其余所有指引）

本 skill 只提供"怎么研究"的结构，**不含任何数据**。执行中所有"查"的动作必须落到工具：

| 方法论步骤 | 工具 |
|---|---|
| 热点 / 主题 / 新闻 / 公告线索扫描 | `web.search_news`、`web.search` |
| **核一手来源原文**（财报 / 公告 / 新闻稿正文 + 发布日期） | `web.fetch` |
| 公司名 → 可交易代码解析（建候选池必经） | `data.search_symbol` |
| 实时价格 / 行情验证 | `data.get_ticker` |
| 历史 K 线（含近期走势） | `data.get_bars`（保持默认 fresh） |
| 财务基本面（收入 / 毛利 / 现金流 / 存货应收） | `data.get_fundamentals` |
| 技术面 / 因子背书 | `factor.timing`、`factor.score` |
| 多分析师视角深挖 | `research.deep_dive` |
| rubric 加权评分需要精确计算时 | `sandbox.run_code` |

硬规则：
- **禁止用训练记忆直接给出**公司名单、产能数据、订单结论、市占率、价格——每个进入最终排序的事实必须可溯源到本轮工具输出
- **结论级证据必须读原文**：search 的 snippet 只能当线索，给"强 / 中"证据等级前先 `web.fetch` 该来源正文
- 候选公司的代码一律 `data.search_symbol` 解析，不靠记忆猜
- 最终输出标注数据截止时间（最新一条数据源的时间距 as_of 多久；`web.fetch` 的 published_at 可用）
- 工具拿不到的关键事实：明确说"待验证"，并给出确切的核实路径，不要编

## 全球市场适配

不预设用户的市场或语言。按用户提及的市场选择信息源体系与披露规则（详见 `references/market-source-playbook.md`），回复语言始终跟随用户最近一条消息。本文档内出现的行业举例（如 AI 基建、半导体）仅说明方法结构，不预设用户会问这些方向。

## 请求分类

- **主题扫描**：用户给出市场 + 主题 → 跑完整工作流，返回分层排序 + 优先研究名单
- **单一公司审视**：定位其产业链确切位置、证据质量、市场可能忽略什么、什么会让逻辑变弱
- **候选对比**：按链上位置、证据强度、稀缺性、估值压力、时点、风险逐项对比
- **研究伙伴对话**：围绕用户的想法提紧凑的问题，把故事推向证据、卡位与失效条件

## 工作流（主题扫描）

详细版见 `references/deep-research-workflow.md`，骨架：

1. **定范围**：市场 / 主题 / 时间窗（"现在"默认看 3-12 个月）
2. **叙事翻译成系统变化**：什么技术或经济变化在驱动需求？哪个物理约束最关键（功耗、带宽、散热、良率、纯度、认证周期、产能爬坡）？
3. **画产业链分层**：终端需求 → 系统集成 → 模组 / 子系统 → 芯片 / 器件 → 工艺 / 封装 / 测试 → 设备 / 量测 → 材料 / 耗材 → 物理基础设施
4. **找稀缺层**：供应商数量少、认证周期长、扩产难、专有 know-how、客户用预付款 / 锁产能表达紧迫。**先排层级再排公司**
5. **建候选池**：跨多个层级铺开（宽主题尽量 ≥20 家再筛到 3-7 家）；每家用平话归类——控制稀缺层 / 供给稀缺层 / 受益但无控制力 / 只有故事
6. **收集并分级证据**：优先一手来源（财报、交易所公告、官方订单、专利、监管文件）；分级标准见 `references/evidence-ladder.md`
7. **排序**：用下方 rubric；层级排序与公司排序分开呈现
8. **讲清什么情况说明判断错了**：替代方案、对手扩产更快、需求不及预期、摊薄、估值已计入成功
9. **给下一步核实动作**：具体查什么文件、什么指标、什么近期事件

## 瓶颈评分 rubric

来自上游 scorecard（权重总分 100，每项打 0-5 后按权重折算；扣分项 0-5，乘数 ×2 直接从总分扣除）：

| 加分项 | 权重 | 扣分项（×2） |
|---|---|---|
| 需求拐点强度 demand_inflection | 15 | 摊薄 / 再融资风险 |
| 架构耦合度 architecture_coupling | 10 | 治理 / 关联交易 |
| 卡点严重度 chokepoint_severity | 15 | 地缘政治 |
| 供应商集中度 supplier_concentration | 12 | 流动性 |
| 扩产难度 expansion_difficulty | 12 | 炒作风险 |
| 证据质量 evidence_quality | 15 | 财务质量存疑 |
| 估值与认知差 valuation_disconnect | 11 | 周期性 |
| 催化时点 catalyst_timing | 10 | 替代设计风险 |

每个最终候选必须答全：**卡住的环节 / 产业链位置 / 排序原因 / 证据（含强度标签）/ 主要风险**。

## 沟通风格

- 结论先行：先给值得优先看的层级，再给名单
- 平实语言讲推理链，不写券商报告腔；表格只在对比时用
- 对拥挤叙事保持怀疑；至少点名一个热门方向被降级及原因
- 证据弱就明说缺哪块证明；强证据支持时给明确观点
- 用户要结构化备忘录时用 `assets/thesis-template.md`

## 边界（必须遵守）

研究支持，不是投资建议。排序是"研究优先级"不是"买入清单"。
- 不用保证收益的语言；不下达买卖指令；不基于传闻推荐；不编造价格 / 财报 / 客户 / 合同 / 市值
- 用户要据此交易 → 走 `trade.create_plan` 正常审批链路，本 skill 不直接触发交易
- 高风险情形（微盘 / 社媒驱动 / 依赖单一未具名客户等）见 `references/risk-and-compliance.md`