# serenity-stock-choke

Adopt this skill: https://proskills.md/skills/other/fadewalk-serenity-stock-choke

Page: https://proskills.md/skills/other/fadewalk-serenity-stock-choke
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 17266
sha: 174cc767f31f66d7827735761fac5c395a46db1e
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/SKILL.md

````text
---
name: serenity-stock-choke
description: |
  A股/港股/美股通用"卡脖子"选股技能。应用 Serenity（@aleabitoreddit）的供应链瓶颈理论，
  对任意板块/产业链进行结构化分析，寻找"一旦断货整个产业就停工"的瓶颈环节，
  并筛选该环节中具备技术壁垒和资本信号的小盘股。

  触发词：分析XX板块、找XX卡脖子、serenity分析、A股/美股/港股瓶颈产业链
  EN triggers: analyze [sector] choke points / find bottlenecks in [industry]
  JP triggers: [セクター] のボトルネックを分析
  KR triggers: [산업] 의 병목 지점 분석

  适用板块示例：电力、光模块、医疗器械、半导体设备、军工、新能源车等任意板块；
  港美股示例：InP衬底（AXTI）、CPO激光器（AAOI）、AI算力链（NVDA/TSM）

  数据源：三级数据获取策略（智能体自带财经工具 → 本技能内置脚本 → 网络检索），
  不依赖任何特定平台，Claude Code / Codex / 通用智能体均可直接使用。
  行情/估值支持 A股+港股+美股；研报/两融/筹码等深度数据仅A股。

  ⚠️ 注意：本技能不预测大盘走势，不适用于纯题材炒作无实质产业逻辑的小票。
agent_created: true
license: MIT
topics: [agent-skills, a-stock, us-stock, hk-stock, choke-point, supply-chain, serenity, stock-picking]
framework: Serenity Choke Point Theory
market: A-share, HK-stock, US-stock
version: 3.2.1
---

# Serenity 卡脖子框架 · 通用版 v3.2.1（A股 / 港股 / 美股）

## 你的核心使命

> "**沿着产业链向上游追溯，找到那个'一旦断货，万亿产业就要地震'的关键节点——那个节点上的小盘股，就是下一个暴击机会。**"

这不是基本面投资，也不是技术分析。**这是供应链地缘政治分析。**

---

## 数据获取策略（三级降级，任何智能体可用）

> 本技能 v3.0 起不依赖任何特定平台。执行六步法需要数据时，**按以下顺序尝试**，
> 哪一级可用就用哪一级，并在报告中标注数据来源。

### 第一级：智能体自带的财经数据工具

若运行环境（Claude Code、Codex 等）已接入财经类 MCP 工具或内置行情/研报检索能力，
**优先使用**。常见可用形态：行情查询、公告/研报检索、资金流查询、财务指标查询。
判断标准：能拿到"价格/估值/资金/研报"任一类数据即算可用。

### 第二级：本技能内置查询脚本（零依赖，无需任何 Key）

```bash
# 脚本位置：本技能目录下 scripts/a_stock_query.py（公开接口，多源自动降级）

# 行情快照（A股/港股/美股自动识别，返回 JSON）
python3 scripts/a_stock_query.py stock 贵州茅台      # A股：价格/涨跌幅/PE/PB/市值/主力净流入/成交额
python3 scripts/a_stock_query.py stock 00700         # 港股：腾讯控股（HKD 计价）
python3 scripts/a_stock_query.py stock AAPL          # 美股：苹果（USD 计价，支持中文名如"特斯拉"）
python3 scripts/a_stock_query.py search 英伟达        # 名称联想（A股+港股+美股+板块）
python3 scripts/a_stock_query.py sector 电力          # A股板块近5日K线+区间涨跌幅（--days 10 可调）
python3 scripts/a_stock_query.py valuation 600519    # 历史估值分位：PE/PB 百分位（仅A股）
python3 scripts/a_stock_query.py kline 300308         # 风险统计：动量/年化波动/最大回撤（三市场）
python3 scripts/a_stock_query.py business 600519     # 主营构成：收入占比/毛利率（仅A股）

# A股专属深度数据
python3 scripts/a_stock_query.py reports 600519      # 券商研报：评级/机构/盈利预测（仅A股）
python3 scripts/a_stock_query.py margin 600519       # 融资融券余额近5日（仅A股）
python3 scripts/a_stock_query.py chip 600519         # 筹码分布（需 pip install akshare，仅A股）
python3 scripts/a_stock_query.py block 600519        # 大宗交易（需 pip install akshare，仅A股）
```

所有命令输出 JSON。脚本内置多源冗余（东方财富→腾讯行情自动切换），
某数据源不可达时会返回带替代建议的错误提示。

### 第三级：网络检索兜底模板

脚本和工具都拿不到的数据，用智能体的联网搜索能力，按以下模板检索：

| 数据需求 | 检索模板 |
|---------|---------|
| 板块行情/资金 | `[板块名] 板块 行情 主力资金流向` |
| 供需缺口 | `[材料/元器件] 供需缺口 国产替代 扩产周期` |
| 政策催化 | `[板块] 政府工作报告 政策文件 十四五/十五五` |
| 研报信号 | `[公司名] 券商研报 评级 目标价` |
| 竞争格局 | `[环节] 竞争格局 市场份额 寡头` |
| 筹码/大宗 | `[代码] 筹码分布 股东人数` / `[代码] 大宗交易 折价率` |
| 美股机构动向 | `TICKER 13F holdings`（滞后45天，季度频）/ `TICKER short interest`（半月频） |
| 港股资金 | `[代码] 南向资金 持股` / `[代码] 沽空比率 short selling` |

---

## 通用推理链路（六步法）

> 无论用户给出哪个板块，按以下六步顺序执行。

### 第一步：定位板块所处周期阶段

```
用户输入板块名称 → 判断属于哪条产业链 → 确认该产业链当前所处周期
```

**三种周期类型**：

| 类型 | 特征 | 信号 | 典型板块 |
|------|------|------|---------|
| **需求爆发期** | 终端需求暴增，中游扩产来不及 | 价格上涨，订单排到几年后 | AI算力、固态电池（2024-2026） |
| **技术跃迁期** | 新技术替代旧技术，旧技术突然被禁 | 政策打压旧技术，补贴新技术 | CPO替代可插拔、HJT替代PERC |
| **供给受限期** | 关键原材料被卡/产能有限 | 报价暴涨，供应商份额成壁垒 | InP衬底、氦气、高纯石英 |

**数据动作**：按三级策略查 "[板块] 供需缺口" / "[板块] 扩产周期"
（第二级用 `search`+`sector` 命令，第三级用上表模板）

### 第二步：溯源供应链，定位"卡脖子"节点

```
列出该板块完整的供应链层级 → 逐层排查哪个环节最容易被卡
```

**溯源模板**（每分析一个板块都要过一遍）：

```
终端产品
  ↓
[最终组装/集成]         ← 是否有产能集中度风险？
  ↓
[核心零部件]           ← 是否有技术壁垒？
  ↓
[关键材料/元器件]       ← 是否有原料依赖？（国内能否自产？）
  ↓
[上游化工/矿产/稀有气体]  ← 是否有资源垄断？
```

**判断标准：什么环节容易成为卡脖子？**

- ✅ 技术壁垒极高（专利林立、know-how积累深厚）
- ✅ 产能建设周期长（2-5年扩产窗口）
- ✅ 国内自给率低（依赖进口）
- ✅ 单一供应商或寡头垄断
- ✅ 不可替代性高（无备选方案）
- ✅ 地缘政治风险（出口管制、制裁）

**数据动作**：按三级策略查 "[具体环节] 国产替代 产能" + 政策文件检索

### 第三步：找A股对应标的，建立"卡脖子定位"标签

```
瓶颈环节 → 有哪些A股公司覆盖？ → 一句话定位其"卡脖子"价值
```

**标的四维信号卡**（每个候选股都要填）：

| 维度 | 要查什么 | 数据动作（按三级策略） |
|------|---------|----------------------|
| **卡脖子定位** | 在这个环节的份额/技术壁垒/专利 | 检索公司概况/主营构成 |
| **估值水位** | P/E、P/B、市值、**历史分位** | `stock` + `valuation` 命令或行情工具 |
| **资本信号** | 主力净流入、融资融券余额变化 | `stock`+`margin` 命令或资金流工具 |
| **机构关注度** | 近期研报覆盖、评级、目标价 | `reports` 命令或研报检索 |

**输出格式**：

```
## 候选标的
[公司简称] [代码]
- 卡脖子定位：（一句话）
- 今日走势：（价格/涨跌幅）
- 估值分位：（P/E/P/B 在板块内位置）
- 主力信号：（净流入/融资余额变化）
- 风险：（潜在利空）
```

### 第四步：筛选"真瓶颈"与"伪概念"

**七条排除规则**（严格执行，有一条就剔除）：

| # | 排除条件 | 判定方法 |
|---|---------|---------|
| 1 | 有业务但不是主营（蹭热点） | `business` 查主营构成：相关业务收入占比<15%且无毛利优势 |
| 2 | 国内竞争格局分散，无护城河 | 竞争格局检索 |
| 3 | 产能扩张太容易（壁垒低） | 供需检索：通用型原材料 |
| 4 | 进口替代逻辑不成立（国外也无货） | 供需检索 |
| 5 | 估值已充分反映（过于知名） | `valuation` 分位 >80% 剔除 |
| 6 | 无机构关注（流动性陷阱） | 日均成交额<5000万（`stock` 的 amount_today）或研报为零（`reports`） |
| 7 | ST/退市风险警示股 | `stock` 返回 is_st 直接剔除；小盘"卡脖子"是 ST 高发区 |

**数据动作**：检索公司主营构成（判断是否蹭热点）+ 竞争格局检索

### 第五步：多空双向确认（不做单边多头）

| 做多信号 | 做空/观望信号 |
|---------|-------------|
| ✅ 板块主力净流入持续 | ❌ 板块主力净流出 |
| ✅ 机构开始覆盖（研报出现） | ❌ 无研报、无人问津 |
| ✅ 论点公开后 5–60 交易日内出现订单/文件/机构持仓验证 | ❌ 只有上涨与媒体报道、无验证（victory lap = 周期后段） |
| ✅ 产能建设周期>2年（壁垒高） | ❌ 产能半年可达 |
| ✅ 政策明确支持（文件/补贴） | ❌ 政策压制 |
| ✅ 筹码集中度提升（股东户数下降） | ❌ 股东人数暴增 |
| ✅ 融资余额**低位**回升（多头确认） | ❌ 融资余额**高位暴增**（拥挤预警，警惕反转）或连续下降 |
| ✅ 估值分位低于板块平均 | ❌ P/E > 历史80%分位 |

**数据动作**：`margin`（融资余额）、`reports`（研报覆盖）、`chip`（筹码，可选），
板块资金流按三级策略获取。

### 第六步：输出结构化分析报告

**强制包含以下八个部分**：

```
## [板块名称] 卡脖子分析报告

### 1. 板块所处周期判断
[需求爆发/技术跃迁/供给受限 + 依据]

### 2. 供应链卡脖子地图
[该板块供应链层级图 + 卡脖子环节标注]

### 3. 候选标的四维信号卡
[每个候选股按四维信号卡格式填写]

### 4. 筛选结论
[哪些是"真瓶颈"标的，哪些已排除及原因（引用七条规则编号）]

### 5. 多空信号对照
[列出3-5条做多信号 + 2-3条风险信号]

### 6. 资金面
[主力净流入/融资余额变化（注意位置：高位暴增=拥挤）；数据不可得时标注来源限制]

### 7. 操作建议
[短线/中线/长线各一句，风险提示（引用 kline 的波动/回撤数据）]

### 8. 催化剂日历与组合约束
[未来90天关键催化事件+日期：扩产投产/订单落地/出口管制/业绩披露/政策会议]
[组合约束：单一环节仓位上限；同一环节关联标的合并计算敞口（高相关=同一beta）；明确止损位]
```

---

## Serenity 原版框架（参考）

> Serenity（@aleabitoreddit）是 Reddit WallStreetBets 传奇人物，以"RISC-V+AI"框架在2019-2024年间实现约3800%收益率（自报数据，未经独立审计）。他的核心方法论：

### 核心逻辑

```
AI大爆发 → 上游硬件需求暴增 →
供应链某些环节产能跟不上 →
瓶颈环节掌握定价权 →
其中小盘股弹性最大
```

### 霍尔木兹海峡类比

> "**霍尔木兹海峡是全球石油的咽喉。一旦封锁，所有人受影响。但如果你在霍尔木兹海峡拥有股份，你就拥有了定价权。**"

→ 翻译到A股：**哪个环节是某个大赛道的"霍尔木兹"？谁控制它？**

### Serenity 经典战例

| 标的 | 代码 | 卡脖子定位 | 核心逻辑 |
|------|------|-----------|---------|
| AXT Inc | AXTI.US | InP衬底全球唯三产商 | 6英寸InP产能全球稀缺 |
| Applied Optoelectronics | AAOI.US | CPO激光器主力供应商 | 微软/谷歌核心供应商 |
| Sivers Semiconductors | SIVE.SE | CPO激光器+硅光子 | 德国K受益产线 |
| X-FAB | XFAB.EU | 特色工艺晶圆代工 | 工业/汽车晶圆不可替代 |

> ⚠️ **幸存者偏差声明**：上表为事后视角的幸存者样本，仅用于说明框架逻辑，不代表框架的期望收益。同一时期存在大量同逻辑但未兑现的标的未被展示。

### Serenity 的风险提示

1. **波动极大**：小盘股一天可以涨跌20-30%
2. **流动性风险**：建仓/清仓时股价波动剧烈
3. **时间成本**：逻辑验证可能需要1-3年
4. **信号噪音**：供应链消息真真假假，需要独立验证

### 框架 2026 进化（推文语料蒸馏，2025-07 → 2026-09）

Serenity 至今高度活跃。第三方语料库
[yan-labs/serenity-aleabitoreddit](https://github.com/yan-labs/serenity-aleabitoreddit)
将其 6,592 条推文与 4 篇长文蒸馏后，可提炼出三点新进化（已吸收进本技能）：

1. **瓶颈地图扩圈**：从 InP 衬底/CPO 激光器等硬件，扩展到 **存储/HBM/NAND、
   AI 电力/电网约束、neocloud（新兴云厂商）融资质量、机器人/物理 AI**。
   本技能"电力板块"示例即命中其 2026 年主线——分析新板块时按同样思路延展即可。
2. **帖子四分类**（判断信号权重，从高到低）：
   **新瓶颈论点**（依赖关系新鲜+未被定价+有客户/产能/政策/文件证据）
   > 重申/回调买入 > 供给图/观察名单（仅作研究输入）
   > **庆祝行情 victory lap（主流媒体开始集中报道 = 往往是周期后段）**
   —— 看到"理论被吹爆"本身就该转向谨慎，这与本技能拥挤度预警同源。
3. **时效窗口**：论点公开到被验证（订单/文件/机构持仓出现）通常需
   **5–60 个交易日**——卡脖子是左侧逻辑，不是"明天就涨"；没有验证迹象的
   单边上涨按第五步做空信号处理。

---

## 跨市场支持（A股 / 港股 / 美股）

> 六步法核心（周期判断 → 供应链溯源 → 卡脖子定位 → 真伪筛选 → 多空确认）是**市场无关**的。
> Serenity 理论的原版战例本来就在美股（AXTI/AAOI/SIVE/XFAB）。差别在数据信号层。

### 各命令适用范围

| 命令 | A股 | 港股 | 美股 |
|------|-----|------|------|
| `search` / `stock`（行情快照） | ✅ | ✅ | ✅ |
| `sector`（板块K线） | ✅ | ❌ | ❌ |
| `reports`（券商研报） | ✅ | ❌ | ❌ |
| `margin`（融资融券） | ✅ | ❌ | ❌ |
| `chip` / `block`（筹码/大宗） | ✅ | ❌ | ❌ |

港美股深度数据不可得时，命令会返回明确的第三级网络检索建议。

### 港美股专属信号维度（替代A股的龙虎榜/两融/主力资金）

| 市场 | 做多信号（检索获取） | 对应A股信号 |
|------|---------------------|------------|
| **美股** | 13F 机构增持（滞后45天，季度频）、short interest 下降（半月频）、分析师目标价上调、期权看涨异动 | 主力净流入 + 融资余额 |
| **港股** | 南向资金持续净买入、沽空比率下降、恒生科技指数成分调整纳入 | 主力净流入 + 融资余额 |
| **通用** | 供应链公告（新订单/扩产/长协）、专利与出口管制动态 | 政策催化 |

### 港美股分析示例触发

```
用 serenity-stock-choke 分析美股 AI 算力供应链      → InP衬底/HBM/CoWoS 瓶颈
用 serenity-stock-choke 分析港股 半导体设备         → 中芯国际产业链+南向资金
找 CPO 激光器的美股卡脖子标的                       → 对标 AAOI/LITE/COHR
```

---

## A股特色适配

### Serenity 框架在A股的特殊性

| 维度 | 美股原版 | A股适配 |
|------|---------|---------|
| 政策权重 | 较低（市场主导） | **极高**（政策直接催化板块） |
| 主力资金 | 对冲基金/机构 | **公募+私募+游资**，游资炒作凶猛 |
| 散户结构 | 较少 | **散户占比高**，情绪波动大 |
| 壳资源 | 无此概念 | 小市值有**壳价值**溢价 |
| 国产替代 | 非核心 | **核心逻辑之一**（卡脖子清单） |

### A股独有的信号维度

1. **龙虎榜**：营业部游资席位暴露短线情绪
2. **融资融券**：杠杆资金的态度（融资余额暴涨=看多情绪）
3. **主力净流入**：单日主力净流入>5亿=机构明显建仓
4. **政府工作报告**：每年3月更新，重大方向性信号
5. **卡脖子清单**：国务院发布，指引国产替代方向

---

## 使用限制与风险提示

1. **不适用于**：纯题材炒作（无实质产业逻辑的小票）
2. **不适用于**：需要预测大盘走势的场景
3. **不适用于**：需要精确估值（市盈率法不适用于亏损/早期公司）
4. **数据时效**：内置脚本提供的是公开接口的实时/近实时数据，深度供应链情报
   （扩产进度、订单排期）必须通过第三级网络检索交叉验证，**不可只依赖单一来源**
5. **重要提醒**：本技能的分析结果仅供参考，不构成投资建议。A股市场受政策影响极大，需密切关注监管动态。
````

## File: README.md
size: 11067
sha: 550d9b7edb793ccebb3b33d06a9068d52f7b1e98
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/README.md

````text

<div align="right">
  <details>
    <summary >🌐 Language</summary>
    <div>
      <div align="center">
        <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=en">English</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=zh-CN">简体中文</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=zh-TW">繁體中文</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=ja">日本語</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=ko">한국어</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=hi">हिन्दी</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=th">ไทย</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=fr">Français</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=de">Deutsch</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=es">Español</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=it">Italiano</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=ru">Русский</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=pt">Português</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=nl">Nederlands</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=pl">Polski</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=ar">العربية</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=fa">فارسی</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=tr">Türkçe</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=vi">Tiếng Việt</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=id">Bahasa Indonesia</a>
        | <a href="https://openaitx.github.io/view.html?user=fadewalk&project=serenity-stock-choke&lang=as">অসমীয়া</
      </div>
    </div>
  </details>
</div>

# Serenity Stock Choke · A股/港股/美股 卡脖子选股框架

<p align="center"><b>简体中文</b> · <a href="README.en.md">English</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a></p>

> "**沿着产业链向上游追溯，找到那个'一旦断货，万亿产业就要地震'的关键节点——那个节点上的小盘股，就是下一个暴击机会。**"

本 Skill 基于 Reddit 传奇人物 **Serenity（@aleabitoreddit）** 的供应链瓶颈理论，覆盖 **A 股、港股、美股**三大市场，形成一套通用的产业链分析框架（Serenity 原版战例本就在美股，A股为本土化适配）。

---

## 核心方法论

### 霍尔木兹海峡类比

> "霍尔木兹海峡是全球石油的咽喉。一旦封锁，所有人受影响。但如果你在霍尔木兹海峡拥有股份，你就拥有了定价权。"

**翻译到投资**：哪个环节是某个大赛道的"霍尔木兹"？哪些公司（A股/港股/美股）控制它？

### 三步核心逻辑

```
① AI大爆发 / 政策驱动 / 技术跃迁
    ↓
② 上游硬件/原材料需求暴增，供应链某些环节产能跟不上
    ↓
③ 瓶颈环节掌握定价权 → 其中小盘股弹性最大
```

### Serenity 原版战绩（美股）

| 标的 | 代码 | 涨幅 | 卡脖子定位 |
|------|------|------|-----------|
| AXT Inc | AXTI.US | +525%（YTD） | InP 衬底全球唯三产商 |
| Applied Optoelectronics | AAOI.US | +348%（YTD） | CPO 激光器主力供应商 |
| Sivers Semiconductors | SIVE.SE | — | CPO 激光器 + 硅光子 |
| X-FAB | XFAB.EU | — | 特色工艺晶圆代工 |

> ⚠️ 上表为**事后视角的幸存者样本**，仅用于说明框架逻辑，不代表框架的期望收益。

---

## 六步分析链路

| 步骤 | 核心问题 | 产出 |
|------|---------|------|
| 1️⃣ 定位板块周期 | 需求爆发 / 技术跃迁 / 供给受限？ | 板块所处阶段 |
| 2️⃣ 溯源供应链 | 瓶颈在哪一层？ | 供应链层级图 |
| 3️⃣ 找 A 股标的 | 哪些公司卡在这个节点？ | 四维信号卡 |
| 4️⃣ 真伪筛选 | 哪些是"真瓶颈"，哪些是蹭热点？ | 筛选结论 |
| 5️⃣ 多空确认 | 做多信号 vs 做空信号？ | 信号对照表 |
| 6️⃣ 输出报告 | 含操作建议 + 风险提示 | 结构化报告 |

---

## 适用市场与板块示例

**A 股**：电力、光模块/CPO、半导体设备、军工、新能源车、医疗器械、创新药、农药、OLED……任意板块均可分析。
**美股**：AI 算力链（InP 衬底/HBM/CoWoS）、半导体设备、稀土、特种化工……
**港股**：半导体代工、创新药、高股息资源股……

| 板块 | 卡脖子节点 | 代表标的 |
|------|-----------|---------|
| **电力** | 特高压换流变压器 / 智能调度 | 国电南瑞(600406)、特变电工(600089) |
| **光模块/CPO** | EAM 激光器 / MPO 连接器 | 源杰科技(688498)、炬光科技(688167) |
| **半导体设备** | 薄膜沉积 / 光刻机核心零部件 | 中微公司(688012)、北方华创(002371) |
| **军工** | 特种合金 / 高端复合材料 | 中简科技(300777)、光威复材(300699) |
| **新能源车** | 碳纳米管导电剂 / 固态电池材料 | 天奈科技(688116)、当升科技(300073) |

---

## 快速开始

### 安装方式

#### 方式零：一句话扔给 AI 智能体（最简单）

把下面这段话直接粘贴给 Claude Code / Codex / 任意能执行命令的智能体，
它会自己克隆、安装、验证并告诉你怎么用：

```
帮我安装 https://github.com/fadewalk/serenity-stock-choke 这个技能：
克隆仓库到当前智能体的技能目录（Claude Code 是 ~/.claude/skills/，
Codex 等其他智能体是 .agents/skills/，拿不准就参考仓库 README），
装好后运行 python3 <技能目录>/scripts/a_stock_query.py stock 600519 验证，
然后告诉我这个技能怎么触发、能干什么。
```

#### 方式一：Claude Code 插件市场

```
/plugin marketplace add fadewalk/serenity-stock-choke
/plugin install serenity-stock-choke@serenity-stock-choke
```

#### 方式二：skills.sh 安装器（Claude Code / Codex / Cursor 等通用）

```bash
npx skills add fadewalk/serenity-stock-choke
```

#### 方式三：手动 git clone

```bash
git clone https://github.com/fadewalk/serenity-stock-choke.git ~/.claude/skills/serenity-stock-choke
```

手动安装时也可复制到项目目录 `.claude/skills/`（Claude Code）或
`.agents/skills/`（Codex 等其他智能体）。内置查询脚本仅用 Python 标准库，
无需安装依赖、无需 API Key（`akshare` 为可选增强：`pip install akshare`）。

### 支持市场

| 市场 | 行情/估值（stock/search） | 板块K线 | 研报/两融/筹码 |
|------|:---:|:---:|:---:|
| **A股** | ✅ 含主力净流入 | ✅ | ✅ |
| **港股** | ✅ HKD 计价 | — | 网络检索兜底 |
| **美股** | ✅ USD 计价，支持中文名 | — | 网络检索兜底 |

六步法分析框架市场无关；港股/美股的机构信号（13F、short interest、南向资金、
沽空比率）通过 SKILL.md 中的检索模板获取。

### 触发方式

对智能体直接说：

```
用 serenity-stock-choke 分析 [板块名]
例：用 serenity-stock-choke 分析军工板块
用 serenity-stock-choke 分析美股 AI 算力供应链
```

或者：

```
分析 [产业链] 的卡脖子机会
找 [赛道] 的瓶颈环节
帮我用 Serenity 框架分析 [板块]
```

### 数据获取（三级降级，任何环境可用）

1. **智能体自带财经工具**：若环境已接入行情/研报类 MCP 工具，优先使用
2. **内置脚本**（`scripts/a_stock_query.py`，公开接口零依赖，多源自动降级）：
   ```bash
   python3 scripts/a_stock_query.py stock 贵州茅台   # A股快照：价格/PE/PB/市值/主力净流入/成交额
   python3 scripts/a_stock_query.py stock 00700      # 港股：腾讯控股（HKD）
   python3 scripts/a_stock_query.py stock AAPL       # 美股：苹果（USD）
   python3 scripts/a_stock_query.py valuation 600519 # A股历史估值分位（PE/PB百分位）
   python3 scripts/a_stock_query.py kline 300308     # 风险统计：动量/波动/最大回撤
   python3 scripts/a_stock_query.py business 600519  # A股主营构成（蹭热点判定）
   python3 scripts/a_stock_query.py sector 电力       # A股板块K线+区间涨跌幅
   python3 scripts/a_stock_query.py reports 600519   # A股券商研报评级
   python3 scripts/a_stock_query.py margin 600519    # A股融资融券余额
   ```
3. **网络检索兜底**：按 SKILL.md 中的检索模板查询供需缺口/政策/筹码/13F/沽空等数据

---

## 文件结构

```
serenity-stock-choke/
├── SKILL.md                    # 主提示词（六步推理链路 + 三级数据策略 + 跨市场支持）
├── README.md                   # 本文件（简体中文）
├── README.en.md                # English
├── README.ja.md                # 日本語
├── README.ko.md                # 한국어
├── .claude-plugin/             # Claude Code 插件市场一键安装
│   ├── plugin.json
│   └── marketplace.json
├── scripts/
│   └── a_stock_query.py        # 独立数据查询脚本（零依赖，多源冗余，A股/港股/美股）
└── references/
    └── user_guide.md          # 使用指南 + 常见板块参考表
```

---

## 风险提示

1. 本 Skill 仅供参考，不构成投资建议
2. 小盘股波动极大，单日涨跌 20-30% 并不罕见
3. A 股受政策影响显著，需密切关注监管动态
4. 供应链信息真伪难辨，需独立验证
5. 逻辑验证可能需要 1-3 年，需有耐心

---

## 参考资料

- [yan-labs/serenity-aleabitoreddit](https://github.com/yan-labs/serenity-aleabitoreddit) — Serenity 推文语料蒸馏（2025-07→2026-09：6,592 条推文 + 4 篇长文，含方法论与战绩时间线）
- [Serenity 原版 Skill（英文）](https://github.com/leslieyeo/aleabitoreddit-skill)
- [semiconstocks.com 追踪器](https://semiconstocks.com/zh)
- [Singularity Research Fund](https://singularityresearchfund.substack.com)
- [知乎：Serenity 卡脖子理论详解](https://zhuanlan.zhihu.com/p/2039362476144341796)
````

## File: scripts/a_stock_query.py
size: 24862
sha: 31777ad5e076d51220b856f2e391126016e5af3c
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/scripts/a_stock_query.py

```text
#!/usr/bin/env python3
"""
Serenity 卡脖子框架 · 独立数据查询脚本（A股/港股/美股，零依赖，多源冗余）

不依赖任何智能体平台（WorkBuddy/Claude Code/Codex 均可调用），无需 API Key，
仅用 Python 标准库 + 公开财经接口；akshare 为可选增强（筹码/大宗）。

数据源（按稳定性排序，自动降级）：
  行情快照   东方财富 push2 → 腾讯 qt.gtimg.cn（A股/港股/美股均支持）
  估值分位   东方财富 datacenter 估值分析（PE/PB/PS 日度历史 → 百分位，仅A股）
  K线风险    东方财富 push2his（三市场通用；不可用时提示改用网络检索）
  主营构成   东方财富 F10（收入占比/毛利率，仅A股）
  名称联想   东方财富 searchapi（自动识别 A股/港股/美股）
  券商研报   东方财富 reportapi（仅A股）
  融资融券   东方财富 datacenter-web（仅A股）
  筹码/大宗  akshare（可选安装，仅A股）

用法（结果均为 JSON，可直接被智能体解析；成功输出均带 as_of 数据时点）:
  python3 scripts/a_stock_query.py stock 贵州茅台     # A股快照: 价格/涨跌幅/PE/PB/市值/主力净流入/成交额
  python3 scripts/a_stock_query.py stock 00700        # 港股: 腾讯控股(HKD)
  python3 scripts/a_stock_query.py stock AAPL         # 美股: 苹果(USD)
  python3 scripts/a_stock_query.py search 英伟达       # 名称联想（A股+港股+美股+板块）
  python3 scripts/a_stock_query.py valuation 600519   # 历史估值分位: PE/PB百分位（仅A股）
  python3 scripts/a_stock_query.py kline 300308 [--days 250]  # 动量/年化波动/最大回撤（三市场）
  python3 scripts/a_stock_query.py business 600519    # 主营构成: 收入占比/毛利率（仅A股）
  python3 scripts/a_stock_query.py sector 电力 [--days 5]   # A股板块近N日K线+区间涨跌幅
  python3 scripts/a_stock_query.py reports 600519     # A股券商研报: 评级/机构/盈利预测
  python3 scripts/a_stock_query.py margin 600519      # A股融资融券余额近5日
  python3 scripts/a_stock_query.py chip 600519        # A股筹码分布（需 akshare）
  python3 scripts/a_stock_query.py block 600519       # A股大宗交易（需 akshare）
"""

import argparse
import datetime
import json
import subprocess
import sys
import urllib.parse
import urllib.request

UA = ("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
      "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36")
TIMEOUT = 15

# ---------------- 数据源端点 ----------------
SUGGEST_URL = ("https://searchapi.eastmoney.com/api/suggest/get"
               "?input={kw}&type=14&token=D43BF722C8E33BDC906FB84D85E326E8")
EM_STOCK = ("https://push2.eastmoney.com/api/qt/stock/get"
            "?secid={secid}&fltt=2&invt=2&fields=f43,f57,f58,f169,f170,f162,f167,f116,f117,f62,f6,f8")
EM_KLINE = ("https://push2his.eastmoney.com/api/qt/stock/kline/get"
            "?secid={secid}&klt=101&fqt=1&lmt={lmt}&end=20500101"
            "&fields1=f1,f2,f3&fields2=f51,f53,f56,f57")
VALUATION_URL = ("https://datacenter-web.eastmoney.com/api/data/v1/get"
                 "?reportName=RPT_VALUEANALYSIS_DET&columns=ALL"
                 "&filter=(SECURITY_CODE%3D%22{code}%22)&sortColumns=TRADE_DATE&sortTypes=-1"
                 "&pageSize={n}&pageNumber=1&source=WEB&client=WEB")
F10_URL = "https://emweb.securities.eastmoney.com/PC_HSF10/BusinessAnalysis/PageAjax?code={code}"
TX_QUOTE = "https://qt.gtimg.cn/q={symbol}"
REPORT_URL = ("https://reportapi.eastmoney.com/report/list"
              "?pageSize={n}&pageNo=1&code={code}&industryCode=*&industry=*"
              "&rating=*&ratingchange=*&beginTime={begin}&endTime={end}&qType=0")
MARGIN_URL = ("https://datacenter-web.eastmoney.com/api/data/v1/get"
              "?reportName=RPTA_WEB_RZRQ_GGMX&columns=ALL"
              "&filter=(scode%3D%22{code}%22)&sortColumns=DATE&sortTypes=-1"
              "&pageSize={n}&pageNumber=1")

NET_HINT = ("数据源暂不可达（可能为网络/地域限制或临时限流）。"
            "请改用：1) 智能体自带的财经 MCP 工具；2) 网络检索该关键词（见 SKILL.md 三级数据策略）。")

# ---------------- 传输层：urllib → curl 自动降级 + 重试 ----------------
def _fetch_once(url: str, decode: str):
    try:
        req = urllib.request.Request(url, headers={"User-Agent": UA,
                                                   "Referer": "https://quote.eastmoney.com/"})
        with urllib.request.urlopen(req, timeout=TIMEOUT) as resp:
            return resp.read().decode(decode, "ignore")
    except Exception as e:  # noqa: BLE001
        print(f"[warn] urllib: {e}，降级 curl", file=sys.stderr)
    try:
        out = subprocess.run(["curl", "-s", "--max-time", str(TIMEOUT), "-A", UA, url],
                             capture_output=True, timeout=TIMEOUT + 5)
        if out.returncode == 0 and out.stdout:
            return out.stdout.decode(decode, "ignore")
    except Exception as e:  # noqa: BLE001
        print(f"[warn] curl: {e}", file=sys.stderr)
    return None

def _fetch(url: str, decode="utf-8", retries=3):
    """GET 并按指定编码解码文本。urllib 失败（TLS拦截等）自动降级系统 curl，
    并对间歇性网络失败做最多 retries 次重试（1s 退避）。"""
    import time
    for i in range(retries):
        text = _fetch_once(url, decode)
        if text:
            return text
        if i < retries - 1:
            time.sleep(1)
    return None

def _get_json(url: str):
    text = _fetch(url)
    if not text:
        return None
    try:
        return json.loads(text)
    except json.JSONDecodeError:
        return None

def _fail(result=None):
    print(json.dumps(result or {"error": NET_HINT}, ensure_ascii=False))
    sys.exit(2)

def _fmt_amount(v):
    if v is None:
        return None
    v = float(v)
    if abs(v) >= 1e8:
        return f"{v / 1e8:.2f}亿"
    if abs(v) >= 1e4:
        return f"{v / 1e4:.2f}万"
    return f"{v:.0f}"

def _percentile(values, current):
    """当前值在历史序列中的分位（%的历史交易日低于当前值）"""
    below = sum(1 for v in values if v is not None and v < current)
    return round(below / len(values) * 100, 1) if values else None

# ---------------- 名称/代码解析 ----------------
def _market_of(quote_id: str) -> str:
    """东财 QuoteID 前缀 → 市场标识"""
    prefix = quote_id.split(".")[0] if "." in quote_id else ""
    return {"1": "cn", "0": "cn", "116": "hk",
            "105": "us", "106": "us", "107": "us"}.get(prefix, "cn" if prefix else "cn")

def _guess_secid(code: str):
    """联想接口不可用时的纯规则兜底（仅A股/港股代码可推断）"""
    if code.isdigit() and len(code) == 6:
        mkt = "sh" if code.startswith(("6", "9")) else "sz"
        prefix = "1" if mkt == "sh" else "0"
        return {"code": code, "name": None, "quote_id": f"{prefix}.{code}",
                "is_board": False, "market": "cn", "tx_symbol": f"{mkt}{code}"}
    if code.isdigit() and 4 <= len(code) <= 5:
        c = code.zfill(5)
        return {"code": c, "name": None, "quote_id": f"116.{c}",
                "is_board": False, "market": "hk", "tx_symbol": f"hk{c}"}
    return None

def _tx_symbol_of(t: dict) -> str:
    """统一标识 → 腾讯行情 symbol（A股 sh/sz、港股 hk、美股 us）"""
    if t.get("tx_symbol"):
        return t["tx_symbol"]
    market, qid = t.get("market"), t.get("quote_id", "")
    code = t.get("code", "")
    if market == "hk":
        return f"hk{code}"
    if market == "us":
        return f"us{code}"
    return ("sh" if qid.startswith("1.") else "sz") + code

def resolve(keyword: str):
    """名称/代码/拼音 → 统一标识 {code,name,quote_id,is_board,market,tx_symbol}"""
    d = _get_json(SUGGEST_URL.format(kw=urllib.parse.quote(keyword)))
    rows = (d or {}).get("QuotationCodeTable", {}).get("Data") or []
    hit = None
    for r in rows:                      # 优先精确代码命中
        if r.get("Code") == keyword:
            hit = r
            break
    hit = hit or (rows[0] if rows else None)
    if hit:
        qid = hit.get("QuoteID", "")
        t = {"code": hit.get("Code"), "name": hit.get("Name"), "quote_id": qid,
             "is_board": qid.startswith("90."), "market": _market_of(qid)}
        t["tx_symbol"] = _tx_symbol_of(t)
        return t
    return _guess_secid(keyword) if keyword.replace(".", "").isalnum() else None

# ---------------- 命令实现 ----------------
def _tx_parse_hk_us(f: list, market: str, t: dict):
    """腾讯港/美股字段映射：[3]现价 [31]涨跌 [32]涨跌幅% [39]PE [44/45]市值亿 [46]英文名 [48/49]52周"""
    if len(f) < 50 or not f[3]:
        return None
    currency = "HKD" if market == "hk" else "USD"
    mv = f[45] if market == "us" and f[45] else f[44]
    return {"source": "tencent", "market": market, "code": t["code"],
            "name": f[1], "name_en": f[46] if len(f) > 46 and f[46] else None,
            "currency": currency,
            "price": float(f[3]), "pct_change": float(f[32]),
            "pe_ttm": float(f[39]) if f[39] else None,
            "pb": None,
            "total_mv": f"{mv}亿{currency}" if mv else None,
            "week52_high": float(f[48]) if f[48] else None,
            "week52_low": float(f[49]) if f[49] else None,
            "note": "港美股公开接口不提供PB与主力资金流；"
                    "估值与资金信号请用第三级网络检索（13F/沽空比率/南向资金等）"}

def cmd_stock(keyword: str):
    t = resolve(keyword)
    if not t or t["is_board"]:
        _fail({"error": f"未找到个股: {keyword}，请先用 search 命令确认代码"})

    # 主源：东方财富（A股含主力净流入；港美股同样支持 secid 查询）
    d = (_get_json(EM_STOCK.format(secid=t["quote_id"])) or {}).get("data")
    if d and d.get("f43") is not None:
        out = {"source": "eastmoney", "market": t["market"], "code": d.get("f57"),
               "name": d.get("f58"), "price": d.get("f43"), "pct_change": d.get("f170"),
               "pe_ttm": d.get("f162"), "pb": d.get("f167"),
               "total_mv": _fmt_amount(d.get("f116")),
               "float_mv": _fmt_amount(d.get("f117"))}
        if t["market"] == "cn":
            out["main_inflow_today"] = _fmt_amount(d.get("f62"))
            out["amount_today"] = _fmt_amount(d.get("f6"))
            out["turnover_pct"] = d.get("f8")
        else:
            out["currency"] = "HKD" if t["market"] == "hk" else "USD"
            out["note"] = "港美股公开接口不提供主力资金流；信号获取见 SKILL.md 跨市场章节"
        _mark_st(out)
        return out

    # 降级源：腾讯行情（A股/港股/美股）
    text = _fetch(TX_QUOTE.format(symbol=t["tx_symbol"]), decode="gbk")
    if text and "~" in text:
        f = text.split('"')[1].split("~")
        if t["market"] == "cn":
            if len(f) > 53 and f[3]:
                out = {"source": "tencent", "market": "cn", "code": t["code"],
                       "name": f[1], "price": float(f[3]), "pct_change": float(f[32]),
                       "pe_ttm": float(f[39]), "pb": float(f[46]),
                       "total_mv": f"{f[45]}亿", "float_mv": f"{f[44]}亿",
                       "turnover_pct": float(f[38]), "volume_hand": float(f[36]),
                       "amount_today": _fmt_amount(float(f[37]) * 1e4) if f[37] else None,
                       "main_inflow_today": None,
                       "note": "主力净流入本源不提供，可用 margin 命令或网络检索补充"}
                _mark_st(out)
                return out
        else:
            out = _tx_parse_hk_us(f, t["market"], t)
            if out:
                return out
    _fail()

def _mark_st(out: dict):
    """ST/退市风险警示标注（排除规则7）"""
    if out.get("name") and "ST" in str(out["name"]).upper():
        out["is_st"] = True
        out["st_warning"] = "ST风险警示股：按六步法排除规则7直接剔除"

def cmd_sector(keyword: str, days: int = 5):
    t = resolve(keyword)
    if not t:
        _fail({"error": f"未找到板块: {keyword}，请先用 search 命令确认"})
    if not t["is_board"]:
        t = {"quote_id": t["quote_id"], "code": t["code"], "name": t["name"]}  # 个股也照查K线
    d = (_get_json(EM_KLINE.format(secid=t["quote_id"], lmt=days)) or {}).get("data")
    klines = []
    if d and d.get("klines"):
        for line in d["klines"]:
            dt, close, vol, amt = line.split(",")
            klines.append({"date": dt, "close": float(close), "volume_hand": int(vol),
                           "amount": _fmt_amount(float(amt))})
    if not klines:
        _fail({"error": "板块K线数据源（东财 push2his）暂不可达。"
                        "请改用智能体财经工具或网络检索『{kw} 板块 行情 资金流向』".format(kw=keyword)})
    pct = round((klines[-1]["close"] / klines[0]["close"] - 1) * 100, 2) if len(klines) >= 2 else None
    return {"code": d.get("code"), "name": d.get("name"), "window_days": days,
            "range_pct": pct, "klines": klines,
            "note": "range_pct 为区间涨跌幅；板块实时资金流请配合网络检索"}

def _require_cn_stock(keyword: str):
    t = resolve(keyword)
    if not t or t["is_board"]:
        _fail({"error": f"未找到个股: {keyword}，请先用 search 命令确认代码"})
    if t["market"] != "cn":
        _fail({"error": f"{t.get('name') or keyword} 属于{'港股' if t['market'] == 'hk' else '美股'}，"
                        "本命令仅支持A股。港美股对应数据请用第三级网络检索："
                        "美股『TICKER 13F holdings short interest』；港股『代码 南向资金 沽空比率』"})
    return t

def cmd_reports(keyword: str, n: int = 8):
    t = _require_cn_stock(keyword)
    end = datetime.date.today()
    begin = end - datetime.timedelta(days=180)
    d = _get_json(REPORT_URL.format(code=t["code"], n=n, begin=begin, end=end))
    rows = [{"date": (r.get("publishDate") or "")[:10], "title": r.get("title"),
             "org": r.get("orgSName"),
             "rating": r.get("emRatingName") or r.get("sRatingName"),
             "eps_forecast": r.get("predictThisYearEps"),
             "pe_forecast": r.get("predictThisYearPe")}
            for r in (d or {}).get("data") or []]
    if not rows:
        _fail({"error": "研报数据暂不可达，请网络检索『公司名 券商研报 评级 目标价』"})
    return {"code": t["code"], "name": t["name"], "count": len(rows), "reports": rows,
            "note": "研报开始覆盖 = 机构关注度信号（六步法第五步做多信号）"}

def cmd_margin(keyword: str, n: int = 5):
    t = _require_cn_stock(keyword)
    d = _get_json(MARGIN_URL.format(code=t["code"], n=n))
    rows = [{"date": (r.get("DATE") or "")[:10],
             "margin_balance": _fmt_amount(r.get("RZYE")),
             "margin_net_buy": _fmt_amount(r.get("RZJME")),
             "rzrq_total": _fmt_amount(r.get("RZRQYE"))}
            for r in ((d or {}).get("result") or {}).get("data") or []]
    if not rows:
        _fail({"error": "两融数据暂不可达，请网络检索『代码 融资余额』"})
    return {"code": t["code"], "name": t["name"], "count": len(rows), "rows": rows,
            "note": "两融解读要结合股价位置：低位回升=多头确认；"
                    "高位暴增=拥挤预警（警惕反转）；连续下降=杠杆退潮"}

def cmd_search(keyword: str):
    d = _get_json(SUGGEST_URL.format(kw=urllib.parse.quote(keyword)))
    rows = []
    for r in ((d or {}).get("QuotationCodeTable") or {}).get("Data") or []:
        qid = r.get("QuoteID", "")
        if qid.startswith("90."):
            mtype = "板块"
        else:
            mtype = {"cn": "A股", "hk": "港股", "us": "美股"}[_market_of(qid)]
        rows.append({"code": r.get("Code"), "name": r.get("Name"),
                     "type": mtype, "quote_id": qid})
    if not rows:
        _fail({"error": f"无匹配或接口不可达: {keyword}。"
                        "可能是俗称/概念叫法与东财板块库不一致，建议：1) 换近义关键词重试"
                        "（如 光模块→CPO、光通信）；2) 用网络检索『{kw} 板块 行情』兜底".format(kw=keyword)})
    return {"keyword": keyword, "matches": rows}

def cmd_valuation(keyword: str, years: int = 3):
    """历史估值分位（PE/PB/PS）——第四步规则5、第五步估值分位信号的定量支撑"""
    t = _require_cn_stock(keyword)
    n = min(int(years) * 250 + 30, 2000)
    d = _get_json(VALUATION_URL.format(code=t["code"], n=n))
    rows = ((d or {}).get("result") or {}).get("data") or []
    if not rows:
        _fail({"error": "估值历史数据暂不可达，请网络检索『{c} 市盈率 历史分位』".format(c=t["code"])})
    rows = sorted(rows, key=lambda r: r.get("TRADE_DATE") or "", reverse=True)
    cur = rows[0]

    def stat(field):
        series = [r.get(field) for r in rows if isinstance(r.get(field), (int, float))]
        if not series or cur.get(field) is None:
            return None
        s = sorted(series)
        return {"current": round(cur[field], 2),
                "percentile": _percentile(series, cur[field]),
                "median": round(s[len(s) // 2], 2),
                "min": round(min(series), 2), "max": round(max(series), 2)}

    return {"code": t["code"], "name": t["name"],
            "data_date": (cur.get("TRADE_DATE") or "")[:10],
            "history_span": f"{(rows[-1].get('TRADE_DATE') or '')[:10]} ~ "
                            f"{(rows[0].get('TRADE_DATE') or '')[:10]}",
            "samples": len(rows),
            "pe_ttm": stat("PE_TTM"), "pb": stat("PB_MRQ"), "ps_ttm": stat("PS_TTM"),
            "note": "percentile = %的历史交易日低于当前值（分位数）。"
                    "<30% 偏低估；>80% 触发第五步做空信号『估值已充分反映』"}

def cmd_kline(keyword: str, days: int = 250):
    """历史K线风险统计：区间涨跌/年化波动/最大回撤/动量（A股/港股/美股通用）"""
    t = resolve(keyword)
    if not t:
        _fail({"error": f"未找到标的: {keyword}，请先用 search 命令确认"})
    d = (_get_json(EM_KLINE.format(secid=t["quote_id"], lmt=days)) or {}).get("data")
    closes = [float(line.split(",")[1]) for line in (d or {}).get("klines") or []]
    if len(closes) < 5:
        _fail({"error": "K线数据源暂不可达（东财 push2his 限流/地域限制）。"
                        "请改用智能体行情工具或网络检索『{kw} 股价 历史走势』".format(kw=keyword)})
    rets = [closes[i] / closes[i - 1] - 1 for i in range(1, len(closes))]
    mean = sum(rets) / len(rets)
    var = sum((r - mean) ** 2 for r in rets) / (len(rets) - 1) if len(rets) > 1 else 0.0
    peak, mdd = closes[0], 0.0
    for c in closes:
        peak = max(peak, c)
        mdd = min(mdd, c / peak - 1)
    out = {"code": t["code"], "name": t["name"], "market": t["market"],
           "bars": len(closes),
           "range_pct": round((closes[-1] / closes[0] - 1) * 100, 2),
           "ann_vol_pct": round((var ** 0.5) * (250 ** 0.5) * 100, 2),
           "max_drawdown_pct": round(mdd * 100, 2),
           "mom_20d_pct": round((closes[-1] / closes[-21] - 1) * 100, 2) if len(closes) > 20 else None,
           "mom_60d_pct": round((closes[-1] / closes[-61] - 1) * 100, 2) if len(closes) > 60 else None,
           "last_close": closes[-1],
           "note": "风险统计基于前复权日线。年化波动>60%或最大回撤>50%的小盘标的，"
                   "仓位须按报告第八部分组合约束打折"}
    if t["market"] != "cn":
        out["currency"] = "HKD" if t["market"] == "hk" else "USD"
    return out

_F10_TYPE = {"1": "按行业", "2": "按产品", "3": "按地区"}

def _f10_code(t: dict) -> str:
    return ("SH" if t["quote_id"].startswith("1.") else "SZ") + str(t["code"])

def cmd_business(keyword: str):
    """主营构成（F10）——第四步排除规则1『是否蹭热点』的定量支撑"""
    t = _require_cn_stock(keyword)
    d = _get_json(F10_URL.format(code=_f10_code(t)))
    rows = (d or {}).get("zygcfx") or []
    if not rows:
        _fail({"error": "主营构成数据暂不可达，请网络检索『{n} 主营构成 收入占比』".format(n=t["name"] or t["code"])})
    latest = max((r.get("REPORT_DATE") or "")[:10] for r in rows)
    by_type = {}
    for r in rows:
        if (r.get("REPORT_DATE") or "")[:10] != latest:
            continue
        mtype = _F10_TYPE.get(r.get("MAINOP_TYPE"), r.get("MAINOP_TYPE"))
        by_type.setdefault(mtype, []).append({
            "item": r.get("ITEM_NAME"),
            "income_ratio_pct": round(r["MBI_RATIO"] * 100, 2) if r.get("MBI_RATIO") is not None else None,
            "gross_margin_pct": round(r["GROSS_RPOFIT_RATIO"] * 100, 2) if r.get("GROSS_RPOFIT_RATIO") is not None else None,
        })
    for v in by_type.values():
        v.sort(key=lambda x: x["income_ratio_pct"] or 0, reverse=True)
        del v[8:]
    return {"code": t["code"], "name": t["name"], "report_date": latest,
            "composition": by_type,
            "note": "『蹭热点』判定：卡脖子相关业务收入占比<15%且无毛利优势 → 排除规则1剔除"}

# ---------------- akshare 可选增强 ----------------
def _ak_available():
    try:
        import akshare  # noqa: F401
        return True
    except ImportError:
        return False

def cmd_chip(keyword: str):
    if not _ak_available():
        _fail({"error": "筹码分布需可选依赖 akshare：pip install akshare；"
                        "或网络检索『代码 筹码分布 股东人数』"})
    import akshare as ak
    t = _require_cn_stock(keyword)
    df = ak.stock_cyq_em(symbol=t["code"], adjust="")
    return {"code": t["code"], "name": t["name"],
            "chip_distribution": json.loads(df.to_json(orient="records", force_ascii=False)),
            "note": "获利盘比例升高+筹码集中 = 主力控盘信号"}

def cmd_block(keyword: str):
    if not _ak_available():
        _fail({"error": "大宗交易需可选依赖 akshare：pip install akshare；"
                        "或网络检索『代码 大宗交易 折价率』"})
    import akshare as ak
    t = _require_cn_stock(keyword)
    df = ak.stock_dzjy_mrmx(symbol=t["code"])
    return {"code": t["code"], "name": t["name"],
            "block_trades": json.loads(df.tail(20).to_json(orient="records", force_ascii=False)),
            "note": "机构专用席位接货+低折价 = 建仓信号"}

def main():
    parser = argparse.ArgumentParser(
        description="Serenity 卡脖子框架 · 独立数据查询（A股/港股/美股，零依赖，多源冗余）")
    sub = parser.add_subparsers(dest="command", required=True)
    specs = [("stock", cmd_stock, "个股名称/代码/拼音（三市场）"),
             ("sector", cmd_sector, "板块名称（A股）"),
             ("valuation", cmd_valuation, "个股名称/代码（A股）"),
             ("kline", cmd_kline, "个股或板块名称（三市场）"),
             ("business", cmd_business, "个股名称/代码（A股）"),
             ("reports", cmd_reports, "个股名称/代码（A股）"),
             ("margin", cmd_margin, "个股名称/代码（A股）"),
             ("search", cmd_search, "任意关键词"),
             ("chip", cmd_chip, "个股代码（A股）"),
             ("block", cmd_block, "个股代码（A股）")]
    for name, _, help_ in specs:
        sub.add_parser(name).add_argument("target", help=help_)
    sub.choices["sector"].add_argument("--days", type=int, default=5, help="K线天数，默认5")
    sub.choices["kline"].add_argument("--days", type=int, default=250, help="K线天数，默认250")
    sub.choices["valuation"].add_argument("--years", type=int, default=3, help="分位回看年数，默认3")
    args = parser.parse_args()

    kwargs = {}
    if args.command in ("sector", "kline") and getattr(args, "days", None):
        kwargs["days"] = args.days
    elif args.command == "valuation" and getattr(args, "years", None):
        kwargs["years"] = args.years
    handlers = {name: fn for name, fn, _ in specs}
    print(f"[查询] {args.command} {args.target}", file=sys.stderr)
    result = handlers[args.command](args.target, **kwargs)
    result.setdefault("as_of", datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S"))
    print(json.dumps(result, ensure_ascii=False, indent=2))

if __name__ == "__main__":
    main()
```

## File: references/user_guide.md
size: 5733
sha: 60ddcd5348da57a39cf28d3b707ec432a85afd57
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/references/user_guide.md

````text
# Serenity 卡脖子框架 · 使用指南（A股/港股/美股）

## 如何触发本技能

直接说以下任意表达即可：

- "用 serenity-stock-choke 分析 [板块名]"
- "分析 [产业链] 的卡脖子机会"
- "找 [赛道] 的瓶颈环节"
- "这个板块有哪些卡脖子的公司"
- "帮我用 Serenity 框架分析 [板块]"

## 分析示例

### 示例1：电力板块

```
用户：分析电力板块
→ Serenity框架分析步骤：
  1. 定位周期：需求爆发期（夏季用电高峰+AI算力需求）
  2. 溯源供应链：煤炭→火电/水电→电网输配→用户
     → 卡脖子节点：特高压输电设备、电网调度系统
  3. 找标的：国电南瑞(600406)、特变电工(600089)、华能国际(600011)
  4. 四维信号验证
  5. 多空确认
  6. 输出报告
```

### 示例2：光模块/CPO板块

```
用户：分析CPO板块
→ Serenity框架分析步骤：
  1. 定位周期：技术跃迁期（CPO替代可插拔光模块）
  2. 溯源供应链：光芯片→光器件→光模块→交换机→数据中心
     → 卡脖子节点：EAM/EA-VCSEL激光器、MPO连接器
  3. 找标的：源杰科技(688498)、炬光科技(688167)、三安光电(600703)
  4. 四维信号验证
  5. 多空确认
  6. 输出报告
```

## 六步法速查卡

| 步骤 | 问题 | 回答 |
|------|------|------|
| 1 | 这个板块现在处于什么周期？ | 需求爆发/技术跃迁/供给受限 |
| 2 | 供应链的瓶颈在哪一层？ | [具体环节] |
| 3 | 哪几家公司在这个瓶颈上？（A股/港股/美股） | [名单] |
| 4 | 哪些是真正的瓶颈，哪些是伪概念？ | 应用排除规则 |
| 5 | 多空信号是什么？ | 做多3-5条 vs 做空2-3条 |
| 6 | 今天资金面怎么样？ | 主力净流入/融资余额（注意高位拥挤） |

## 常见板块卡脖子定位参考

| 板块 | 卡脖子节点 | 代表公司 | 对标逻辑 |
|------|-----------|---------|---------|
| **电力** | 特高压换流变压器/智能调度 | 国电南瑞、特变电工、华能国际 | 算电协同+迎峰度夏 |
| **光模块/CPO** | EAM激光器/MPO连接器 | 源杰科技、炬光科技、三安光电 | AI算力→光互连需求暴涨 |
| **半导体设备** | 薄膜沉积/光刻机核心零部件 | 中微公司、北方华创 | 国产替代+制程突破 |
| **军工** | 特种合金/高端复合材料 | 中简科技、光威复材 | 军贸+装备升级 |
| **新能源车** | 碳纳米管导电剂/固态电池材料 | 天奈科技、当升科技 | 能量密度提升 |
| **创新药** | 创新靶点+CDMO | 恒瑞医药、药明康德 | 国产创新药出海 |
| **农业** | 转基因种子/高端农机 | 隆平高科、大北农 | 粮食安全 |

## 数据查询快捷指令

> 按三级策略降级使用：智能体自带财经工具 → 本技能脚本 → 网络检索。
> 脚本位置：`scripts/a_stock_query.py`，零依赖，无需 API Key。

### 内置脚本命令

```bash
python3 scripts/a_stock_query.py search [关键词]    # 名称联想（A股+港股+美股+板块）
python3 scripts/a_stock_query.py stock [名称/代码]  # 个股：价格/涨跌幅/PE/PB/市值/主力净流入/成交额
python3 scripts/a_stock_query.py valuation [代码]   # A股历史估值分位：PE/PB百分位
python3 scripts/a_stock_query.py kline [名称/代码]  # 风险统计：动量/年化波动/最大回撤（三市场）
python3 scripts/a_stock_query.py business [代码]    # A股主营构成：收入占比/毛利率（蹭热点判定）
python3 scripts/a_stock_query.py sector [板块名]    # A股板块近5日K线+区间涨跌幅（--days 可调）
python3 scripts/a_stock_query.py reports [代码]     # A股券商研报：评级/机构/盈利预测
python3 scripts/a_stock_query.py margin [代码]      # A股融资融券余额近5日
python3 scripts/a_stock_query.py chip [代码]        # 筹码分布（可选：pip install akshare）
python3 scripts/a_stock_query.py block [代码]       # 大宗交易（可选：pip install akshare）
```

### 网络检索兜底模板

```
[板块名] 板块 行情 主力资金流向          # A股板块行情/资金
[关键材料] 供需缺口 国产替代 扩产周期    # 供应链卡脖子
[板块] 政府工作报告 政策文件             # 政策催化
[公司名] 券商研报 评级 目标价           # 研报信号
[代码] 筹码分布 股东人数                # A股筹码信号
[代码] 大宗交易 折价率                  # A股大宗信号
TICKER 13F holdings / short interest   # 美股机构动向/空头比例
[港股代码] 南向资金 沽空比率            # 港股资金信号
```

### 港美股快速上手

```bash
python3 scripts/a_stock_query.py stock 00700    # 腾讯控股（HKD）
python3 scripts/a_stock_query.py stock NVDA     # 英伟达（USD）
python3 scripts/a_stock_query.py stock 台积电    # 支持中文名解析
python3 scripts/a_stock_query.py search 苹果     # 联想返回 A股/港股/美股候选
```

六步法分析流程与 A 股完全一致；差异在信号层——港美股用
13F/short interest（美股）、南向资金/沽空比率（港股）替代龙虎榜/两融/主力资金。

### 与六步法的对应关系

| 六步法步骤 | 用到的命令/检索 |
|-----------|---------------|
| 1 定位周期 | `sector` + 供需缺口检索 |
| 2 溯源供应链 | 供应链检索模板 |
| 3 四维信号卡 | `stock` + `valuation`（估值分位）+ `reports` + `margin` |
| 4 真伪筛选 | `business`（主营占比/毛利）+ 竞争格局检索 |
| 5 多空确认 | `margin` + `chip`（可选）+ 资金流检索 |
| 6 输出报告 | 汇总以上 + `kline`（波动/回撤）+ 催化剂日历 + 组合约束 |
````

## File: .claude-plugin/marketplace.json
size: 470
sha: e565ebad28a3228c8bd01e7d6a38e67056d3b11f
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/.claude-plugin/marketplace.json

```text
{
  "name": "serenity-stock-choke",
  "owner": {
    "name": "fadewalk"
  },
  "metadata": {
    "description": "Serenity 卡脖子选股技能（A股/港股/美股）",
    "version": "3.2.1"
  },
  "plugins": [
    {
      "name": "serenity-stock-choke",
      "description": "A股/港股/美股卡脖子选股技能：Serenity 供应链瓶颈理论六步法，含零依赖行情脚本",
      "source": "./",
      "strict": false,
      "skills": ["./"]
    }
  ]
}
```

## File: .claude-plugin/plugin.json
size: 547
sha: 0ba402eb6de0670495392daa5be55550a8a216ec
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/.claude-plugin/plugin.json

```text
{
  "name": "serenity-stock-choke",
  "description": "A股/港股/美股卡脖子选股技能：Serenity 供应链瓶颈理论六步法，含零依赖行情脚本",
  "version": "3.2.1",
  "author": {
    "name": "fadewalk"
  },
  "homepage": "https://github.com/fadewalk/serenity-stock-choke",
  "repository": "https://github.com/fadewalk/serenity-stock-choke",
  "license": "MIT",
  "keywords": [
    "agent-skills",
    "stock-picking",
    "supply-chain",
    "choke-point",
    "serenity",
    "a-stock",
    "us-stock",
    "hk-stock"
  ]
}
```

## File: LICENSE
size: 1070
sha: 2bea90cb4348af0a30c1f6ffe19e3a3641301e18
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/LICENSE

```text
MIT License

Copyright (c) 2025-2026 fadewalk

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## File: README.en.md
size: 6986
sha: c63716ec51574b0f3e2ac1b54db84ffeb0734796
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/README.en.md

````text
# Serenity Stock Choke · A-Share / HK / US Choke-Point Stock Picking Framework

<p align="center"><b>English</b> · <a href="README.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a></p>

> "**Trace the supply chain upstream to the node where, if it ever runs dry, a trillion-dollar industry grinds to a halt — the small caps sitting on that node are the next big strike.**"

This Skill applies the supply-chain bottleneck theory of Reddit legend **Serenity (@aleabitoreddit)** across **A-shares, Hong Kong and US markets**, forming a universal industry-chain analysis framework. Serenity's original trades were US stocks (AXTI, AAOI); the A-share version is the localized adaptation.

---

## Core Methodology

### The Strait of Hormuz Analogy

> "The Strait of Hormuz is the throat of global oil. Block it, and everyone suffers. But if you own equity in the Strait of Hormuz itself, you own pricing power."

**Translated to investing**: which node is the "Hormuz" of a major track — and which listed companies (A-share / HK / US) control it?

### Three-Step Core Logic

```
① AI boom / policy drive / technology leapfrogging
    ↓
② Upstream hardware & materials demand explodes; some supply-chain nodes can't keep up
    ↓
③ The bottleneck node gains pricing power → small caps there have the most torque
```

### Serenity's Original Track Record (US)

| Stock | Ticker | Choke-point position |
|------|--------|---------------------|
| AXT Inc | AXTI.US | One of only ~3 global InP substrate makers |
| Applied Optoelectronics | AAOI.US | Key CPO laser supplier |
| Sivers Semiconductors | SIVE.SE | CPO lasers + silicon photonics |
| X-FAB | XFAB.EU | Specialty-process foundry |

> ⚠️ The table above is a **survivorship-biased, ex-post sample** used to illustrate the framework only. It does not represent the expected return of the framework.

---

## Six-Step Analysis Pipeline

| Step | Question | Output |
|------|---------|--------|
| 1️⃣ Cycle stage | Demand explosion / tech leapfrog / supply constrained? | Sector stage |
| 2️⃣ Trace supply chain | Which layer is the bottleneck? | Supply-chain map |
| 3️⃣ Find listed names | Who sits on the node? (A/HK/US) | Four-factor signal card |
| 4️⃣ True vs fake | Real bottleneck or hot-money riding? | Screening verdict (7 exclusion rules) |
| 5️⃣ Two-sided check | Bull vs bear signals? | Signal table |
| 6️⃣ Report | Position sizing + risk | Structured report (8 sections) |

---

## Supported Markets

| Market | Quote/valuation (`stock`/`search`) | Sector K-line | Reports/margin/chips |
|------|:---:|:---:|:---:|
| **A-share** | ✅ incl. main fund flow | ✅ | ✅ |
| **Hong Kong** | ✅ HKD | — | web-search fallback |
| **US** | ✅ USD, Chinese name lookup | — | web-search fallback |

The six-step framework itself is market-agnostic. For HK/US institutional signals (13F, short interest, southbound flow, short-selling ratio), use the search templates in SKILL.md. Note: 13F lags 45 days (quarterly); short interest is bi-weekly.

---

## Quick Start

### Install (pick one)

**Option 0 — paste one message to your AI agent (easiest).** Give the text below to Claude Code / Codex / any agent that can run commands, and it will install and verify itself:

```
Install the skill at https://github.com/fadewalk/serenity-stock-choke :
clone it into this agent's skills directory (Claude Code: ~/.claude/skills/,
other agents: .agents/skills/; if unsure, follow the repo README), then verify
with python3 <skill-dir>/scripts/a_stock_query.py stock 600519 and tell me how
to invoke this skill and what it can do.
```

**Option 1 — Claude Code plugin marketplace:**

```
/plugin marketplace add fadewalk/serenity-stock-choke
/plugin install serenity-stock-choke@serenity-stock-choke
```

**Option 2 — skills.sh installer:**

```bash
npx skills add fadewalk/serenity-stock-choke
```

**Option 3 — manual clone:**

```bash
git clone https://github.com/fadewalk/serenity-stock-choke.git ~/.claude/skills/serenity-stock-choke
```

The bundled query script uses only the Python standard library — no dependencies, no API key (`akshare` optional: `pip install akshare`).

### How to Trigger

```
Use serenity-stock-choke to analyze [sector]
e.g. Use serenity-stock-choke to analyze the US AI compute supply chain
Find the choke points in [industry]
```

### Data Access (3-tier fallback, works in any environment)

1. **Agent's own finance tools** (MCP market-data/research tools) — prefer these if available
2. **Bundled script** (`scripts/a_stock_query.py`, zero-dependency, multi-source fallback):
   ```bash
   python3 scripts/a_stock_query.py stock 600519     # A-share snapshot: price/PE/PB/mcap/fund flow
   python3 scripts/a_stock_query.py stock 00700      # HK: Tencent (HKD)
   python3 scripts/a_stock_query.py stock AAPL       # US: Apple (USD)
   python3 scripts/a_stock_query.py valuation 600519 # A-share PE/PB historical percentile
   python3 scripts/a_stock_query.py kline 300308     # momentum / annualized vol / max drawdown
   python3 scripts/a_stock_query.py business 600519  # A-share revenue mix (hot-money check)
   python3 scripts/a_stock_query.py sector 电力       # A-share sector K-line
   python3 scripts/a_stock_query.py reports 600519   # A-share broker reports
   python3 scripts/a_stock_query.py margin 600519    # A-share margin balance
   ```
3. **Web-search fallback**: use the templates in SKILL.md for supply gaps, policy, chips, 13F, short interest, etc.

## File Structure

```
serenity-stock-choke/
├── SKILL.md                    # Main prompt (6-step pipeline + 3-tier data strategy)
├── README.md                   # 简体中文版
├── README.en.md                # This file
├── README.ja.md                # 日本語版
├── README.ko.md                # 한국어版
├── .claude-plugin/             # Claude Code plugin marketplace (one-click install)
├── scripts/
│   └── a_stock_query.py        # Standalone data script (zero-dep, multi-source, A/HK/US)
└── references/
    └── user_guide.md          # Usage guide + sector reference table (Chinese)
```

---

## Risk Disclosure

1. For research reference only. Not investment advice.
2. Small caps can swing 20-30% in a single day.
3. A-shares are heavily policy-driven; watch regulatory moves closely.
4. Supply-chain information is noisy; verify independently.
5. Thesis validation may take 1-3 years.

---

## References

- [yan-labs/serenity-aleabitoreddit](https://github.com/yan-labs/serenity-aleabitoreddit) — distillation of Serenity's tweets (2025-07 → 2026-09: 6,592 tweets + 4 articles, methodology + track record)
- [Original Serenity Skill (EN)](https://github.com/leslieyeo/aleabitoreddit-skill)
- [semiconstocks.com tracker](https://semiconstocks.com/zh)
- [Singularity Research Fund](https://singularityresearchfund.substack.com)
````

## File: README.ja.md
size: 8366
sha: 267bb9b7af5c318cb5368ff06497dc4f07f01c92
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/README.ja.md

````text
# Serenity Stock Choke · A株/香港株/米国株 ボトルネック（チョークポイント）投資フレームワーク

<p align="center"><a href="README.md">简体中文</a> · <a href="README.en.md">English</a> · <b>日本語</b> · <a href="README.ko.md">한국어</a></p>

> "**サプライチェーンを上流に遡り、『そこが途絶えたら兆円産業が停止する』中核ノードを見つける——そのノードに座る小型株こそ、次の大打撃のチャンスだ。**"

本スキルは、Redditの伝説的トレーダー **Serenity（@aleabitoreddit）** のサプライチェーン・ボトルネック理論を、**A株・香港株・米国株**の3市場に展開する汎用フレームワークです。Serenityの元祖の戦例は米国株（AXTI・AAOI）であり、A株版はそのローカライズです。

---

## コアメソドロジー

### 「ホルムズ海峡」のアナロジー

> 「ホルムズ海峡は世界の石油の喉元だ。封鎖されれば皆が影響を受ける。しかし、ホルムズ海峡そのものに株式を持っていれば、価格決定権を握れる。」

**投資への翻訳**：ある巨大トラックの「ホルムズ」とはどのノードか——それを支配する上場企業（A株/香港株/米国株）はどこか？

### 3段階のコアロジック

```
① AI爆発 / 政策ドライブ / 技術の飛躍
    ↓
② 上流のハードウェア・素材需要が急増し、供給網の一部が追いつかない
    ↓
③ ボトルネック・ノードが価格決定権を獲得 → そこにある小型株の値動きが最大
```

### Serenityの実績（米国株・ 参考）

| 銘柄 | ティッカー | チョークポイントの位置づけ |
|------|-----------|--------------------------|
| AXT Inc | AXTI.US | InP基板の世界トップ3メーカーの一つ |
| Applied Optoelectronics | AAOI.US | CPOレーザーの主要サプライヤー |
| Sivers Semiconductors | SIVE.SE | CPOレーザー + シリコンフォトニクス |
| X-FAB | XFAB.EU | 特殊プロセスファウンドリ |

> ⚠️ 上表は**事後視点のサバイバーシップ（生存者）サンプル**であり、フレームワークのロジック説明用です。フレームワークの期待リターンを表すものではありません。

---

## 6ステップ分析パイプライン

| ステップ | 問い | アウトプット |
|---------|------|------------|
| 1️⃣ 循環段階 | 需要爆発 / 技術躍進 / 供給制約のどれか？ | セクターの段階判定 |
| 2️⃣ サプライチェーン追跡 | どの層がボトルネックか？ | 階層マップ |
| 3️⃣ 上場銘柄の特定 | そのノードに座るのは誰か？（A/香港/米） | 4要素シグナルカード |
| 4️⃣ 真贋スクリーニング | 本物のボトルネックか、テーマ便乗か？ | 7つの除外ルールで判定 |
| 5️⃣ 双方向確認 | 強気シグナル vs 弱気シグナル？ | シグナル対照表 |
| 6️⃣ レポート | ポジション設計 + リスク | 構造化レポート（8セクション） |

---

## 対応市場

| 市場 | 行情・評価（`stock`/`search`） | セクターK線 | レポート/信用/チップ |
|------|:---:|:---:|:---:|
| **A株** | ✅ 主力資金流込み | ✅ | ✅ |
| **香港株** | ✅ HKD建て | — | Web検索で補完 |
| **米国株** | ✅ USD建て・中国語名対応 | — | Web検索で補完 |

6ステップのフレームワーク自体は市場非依存です。香港株・米国株の機関シグナル（13F、空売り残高、南向き資金、空売り比率）はSKILL.mdの検索テンプレートを使用。**13Fは45日遅延（四半期）、空売り残高は半月频**である点に注意。

---

## クイックスタート

### インストール（いずれか一つ）

**方法0 — AIエージェントに一言投げる（最簡単）**。以下の文をClaude Code / Codex等のコマンド実行可能なエージェントに貼り付ければ、自動でクローン・インストール・検証まで行います：

```
https://github.com/fadewalk/serenity-stock-choke のスキルをインストールして：
このエージェントのスキルディレクトリ（Claude Code: ~/.claude/skills/、
その他: .agents/skills/、不明ならリポジトリのREADME参照）にクローンし、
python3 <skill-dir>/scripts/a_stock_query.py stock 600519 で動作確認、
その後このスキルの使い方とできることを教えて。
```

**方法1 — Claude Codeプラグインマーケット：**

```
/plugin marketplace add fadewalk/serenity-stock-choke
/plugin install serenity-stock-choke@serenity-stock-choke
```

**方法2 — skills.shインストーラ：**

```bash
npx skills add fadewalk/serenity-stock-choke
```

**方法3 — 手動クローン：**

```bash
git clone https://github.com/fadewalk/serenity-stock-choke.git ~/.claude/skills/serenity-stock-choke
```

同梱のクエリスクリプトはPython標準ライブラリのみ使用——依存関係なし・APIキー不要（`akshare`はオプション：`pip install akshare`）。

### トリガー方法

```
serenity-stock-choke で [セクター] を分析して
例：serenity-stock-choke で米国AIコンピュート・サプライチェーンを分析して
[業界] のボトルネックを見つけて
```

### データアクセス（3段階フォールバック、どの環境でも動作）

1. **エージェント内蔵の金融ツール**（MCP市況・レポートツール）——あれば最優先
2. **同梱スクリプト**（`scripts/a_stock_query.py`、ゼロ依存・マルチソース自動切替）：
   ```bash
   python3 scripts/a_stock_query.py stock 600519     # A株スナップショット：価格/PER/PB/時価総額/資金流
   python3 scripts/a_stock_query.py stock 00700      # 香港株：テンセント（HKD）
   python3 scripts/a_stock_query.py stock AAPL       # 米国株：アップル（USD）
   python3 scripts/a_stock_query.py valuation 600519 # A株 PER/PB の歴史パーセンタイル
   python3 scripts/a_stock_query.py kline 300308     # モメンタム/年率ボラ/最大ドローダウン
   python3 scripts/a_stock_query.py business 600519  # A株 売上構成（テーマ便乗チェック）
   python3 scripts/a_stock_query.py sector 电力       # A株 セクターK線
   python3 scripts/a_stock_query.py reports 600519   # A株 券商レポート
   python3 scripts/a_stock_query.py margin 600519    # A株 信用残高
   ```
3. **Web検索フォールバック**：供給ギャップ・政策・チップ分布・13F・空売り等はSKILL.mdのテンプレートで

## ファイル構成

```
serenity-stock-choke/
├── SKILL.md                    # メインプロンプト（6ステップ + 3段階データ戦略）
├── README.md                   # 简体中文版
├── README.en.md                # English
├── README.ja.md                # このファイル
├── README.ko.md                # 한국어版
├── .claude-plugin/             # Claude Codeプラグイン（ワンクリック導入）
├── scripts/
│   └── a_stock_query.py        # 独立データスクリプト（ゼロ依存・A/香港/米対応）
└── references/
    └── user_guide.md          # 使用ガイド（中国語）
```

---

## リスク開示

1. 研究参考用であり、投資助言ではありません。
2. 小型株は1日で20〜30%動くことがあります。
3. A株は政策影響が極めて大きく、規制動向に要注意。
4. サプライチェーン情報はノイズが多く、独自検証が必須。
5. ロジックの検証には1〜3年かかる場合があります。

---

## 参考文献

- [yan-labs/serenity-aleabitoreddit](https://github.com/yan-labs/serenity-aleabitoreddit) — Serenityツイートのコーパス蒸留（2025-07→2026-09：6,592ツイート＋4記事、メソドロジーと戦績タイムライン）
- [SerenityオリジナルSkill（英語）](https://github.com/leslieyeo/aleabitoreddit-skill)
- [semiconstocks.com トラッカー](https://semiconstocks.com/zh)
- [Singularity Research Fund](https://singularityresearchfund.substack.com)
````

## File: README.ko.md
size: 7564
sha: e32f82710de2c4ce8ac7fe987b702302ccb9a604
upstream: https://github.com/fadewalk/serenity-stock-choke/blob/HEAD/README.ko.md

````text
# Serenity Stock Choke · A주식/홍콩주/미국주 공급망 병목(초크포인트) 투자 프레임워크

<p align="center"><a href="README.md">简体中文</a> · <a href="README.en.md">English</a> · <a href="README.ja.md">日本語</a> · <b>한국어</b></p>

> "**공급망을 상류로 거슬러 올라가 '그곳이 끊기면 조 단위 산업이 멈추는' 핵심 노드를 찾아라 — 그 노드에 앉아 있는 소형주가 다음 대박의 기회다.**"

이 스킬은 Reddit의 전설적인 트레이더 **Serenity(@aleabitoreddit)** 의 공급망 병목 이론을 **A주식·홍콩주·미국주** 3개 시장에 적용한 범용 산업 분석 프레임워크입니다. Serenity의 원조 전적은 미국주(AXTI, AAOI)이며, A주식 버전은 그 현지화입니다.

---

## 핵심 방법론

### "호르무즈 해협" 아날로지

> "호르무즈 해협은 세계 석유의 목구멍이다. 봉쇄되면 모두가 영향을 받는다. 하지만 호르무즈 해협 자체에 주식을 갖고 있다면, 가격 결정권을 쥐게 된다."

**투자로의 번역**: 어떤 거대 트랙의 "호르무즈"는 어느 노드인가 — 그것을 지배하는 상장사(A주/홍콩주/미국주)는 어디인가?

### 3단계 핵심 로직

```
① AI 폭발 / 정책 드라이브 / 기술 도약
    ↓
② 상류 하드웨어·소재 수요 폭증, 공급망 일부가 따라가지 못함
    ↓
③ 병목 노드가 가격 결정권 확보 → 그곳의 소형주 변동성(상승 탄력)이 최대
```

### Serenity의 실적 (미국주 · 참고)

| 종목 | 티커 | 초크포인트 포지셔닝 |
|------|------|-------------------|
| AXT Inc | AXTI.US | InP 기판 글로벌 톱3 제조사 중 하나 |
| Applied Optoelectronics | AAOI.US | CPO 레이저 주요 공급사 |
| Sivers Semiconductors | SIVE.SE | CPO 레이저 + 실리콘 포토닉스 |
| X-FAB | XFAB.EU | 특수공정 파운드리 |

> ⚠️ 위 표는 **사후 관점의 생존 편향 샘플**로, 프레임워크 로직 설명용입니다. 프레임워크의 기대수익률을 대표하지 않습니다.

---

## 6단계 분석 파이프라인

| 단계 | 질문 | 산출물 |
|------|------|--------|
| 1️⃣ 사이클 단계 | 수요 폭발 / 기술 도약 / 공급 제약 중 무엇인가? | 섹터 단계 판정 |
| 2️⃣ 공급망 추적 | 어느 층이 병목인가? | 공급망 계층 지도 |
| 3️⃣ 상장사 발굴 | 그 노드에 앉은 기업은 누구인가? (A/홍콩/미) | 4요소 시그널 카드 |
| 4️⃣ 진위 스크리닝 | 진짜 병목인가, 테마 편승인가? | 7대 제외 규칙으로 판정 |
| 5️⃣ 양방향 확인 | 강세 시그널 vs 약세 시그널? | 시그널 대조표 |
| 6️⃣ 리포트 | 포지션 설계 + 리스크 | 구조화 리포트 (8섹션) |

---

## 지원 시장

| 시장 | 시세·밸류에이션 (`stock`/`search`) | 섹터 K라인 | 리서치/신용융자/칩 |
|------|:---:|:---:|:---:|
| **A주식** | ✅ 주력 자금유입 포함 | ✅ | ✅ |
| **홍콩주** | ✅ HKD 표기 | — | 웹 검색으로 대체 |
| **미국주** | ✅ USD 표기 · 중국어명 지원 | — | 웹 검색으로 대체 |

6단계 프레임워크 자체는 시장 비의존적입니다. 홍콩·미국 기관 시그널(13F, 공매도 잔고, 남향 자금, 공매도 비율)은 SKILL.md의 검색 템플릿을 사용하세요. **13F는 45일 지연(분기), 공매도 잔고는 격주 발표**임에 유의하세요.

---

## 빠른 시작

### 설치 (하나만 선택)

**방법 0 — AI 에이전트에 한마디 던지기 (가장 간단)**. 아래 문장을 Claude Code / Codex 등 명령 실행 가능한 에이전트에 붙여넣으면, 자동으로 클론·설치·검증까지 수행합니다:

```
https://github.com/fadewalk/serenity-stock-choke 스킬을 설치해줘:
이 에이전트의 스킬 디렉터리(Claude Code: ~/.claude/skills/,
기타: .agents/skills/, 불확실하면 저장소 README 참조)에 클론하고,
python3 <skill-dir>/scripts/a_stock_query.py stock 600519 로 동작 확인 후,
이 스킬 사용법과 할 수 있는 일을 알려줘.
```

**방법 1 — Claude Code 플러그인 마켓:**

```
/plugin marketplace add fadewalk/serenity-stock-choke
/plugin install serenity-stock-choke@serenity-stock-choke
```

**방법 2 — skills.sh 설치기:**

```bash
npx skills add fadewalk/serenity-stock-choke
```

**방법 3 — 수동 클론:**

```bash
git clone https://github.com/fadewalk/serenity-stock-choke.git ~/.claude/skills/serenity-stock-choke
```

번들 쿼리 스크립트는 Python 표준 라이브러리만 사용 — 의존성 없음, API 키 불필요 (`akshare` 선택: `pip install akshare`).

### 트리거 방법

```
serenity-stock-choke 로 [섹터] 분석해줘
예: serenity-stock-choke 로 미국 AI 컴퓨트 공급망 분석해줘
[산업] 의 병목 지점을 찾아줘
```

### 데이터 접근 (3단계 폴백, 어느 환경에서든 동작)

1. **에이전트 내장 금융 도구** (MCP 시세·리서치 도구) — 있으면 최우선
2. **번들 스크립트** (`scripts/a_stock_query.py`, 제로 의존성·멀티소스 자동 전환):
   ```bash
   python3 scripts/a_stock_query.py stock 600519     # A주 스냅샷: 가격/PER/PB/시총/자금유입
   python3 scripts/a_stock_query.py stock 00700      # 홍콩주: 텐센트 (HKD)
   python3 scripts/a_stock_query.py stock AAPL       # 미국주: 애플 (USD)
   python3 scripts/a_stock_query.py valuation 600519 # A주 PER/PB 역사 백분위
   python3 scripts/a_stock_query.py kline 300308     # 모멘텀/연율 변동성/최대 낙폭
   python3 scripts/a_stock_query.py business 600519  # A주 매출 구성 (테마 편승 체크)
   python3 scripts/a_stock_query.py sector 电力       # A주 섹터 K라인
   python3 scripts/a_stock_query.py reports 600519   # A주 증권사 리서치
   python3 scripts/a_stock_query.py margin 600519    # A주 신용융자 잔고
   ```
3. **웹 검색 폴백**: 공급 갭·정책·칩 분포·13F·공매도 등은 SKILL.md 템플릿 사용

## 파일 구조

```
serenity-stock-choke/
├── SKILL.md                    # 메인 프롬프트 (6단계 + 3단계 데이터 전략)
├── README.md                   # 简体中文版
├── README.en.md                # English
├── README.ja.md                # 日本語版
├── README.ko.md                # 이 파일
├── .claude-plugin/             # Claude Code 플러그인 (원클릭 설치)
├── scripts/
│   └── a_stock_query.py        # 독립 데이터 스크립트 (제로 의존성·A/홍콩/미 지원)
└── references/
    └── user_guide.md          # 사용 가이드 (중국어)
```

---

## 리스크 고지

1. 연구 참고용이며 투자 자문이 아닙니다.
2. 소형주는 하루에 20~30% 움직일 수 있습니다.
3. A주식은 정책 영향이 매우 크므로 규제 동향에 주의하세요.
4. 공급망 정보는 노이즈가 많아 독자적 검증이 필수입니다.
5. 로직 검증에는 1~3년이 걸릴 수 있습니다.

---

## 참고 자료

- [yan-labs/serenity-aleabitoreddit](https://github.com/yan-labs/serenity-aleabitoreddit) — Serenity 트윗 코퍼스 증류 (2025-07→2026-09: 6,592개 트윗 + 4편 아티클, 방법론·전적 타임라인)
- [Serenity 오리지널 Skill (영어)](https://github.com/leslieyeo/aleabitoreddit-skill)
- [semiconstocks.com 트래커](https://semiconstocks.com/zh)
- [Singularity Research Fund](https://singularityresearchfund.substack.com)
````
