# Sm Industry Database

> 产业数据库搭建 skill。用于把公开市场数据、公司披露、卖方报告、行业数据库（如 EDB / iFind EDB / 第三方产业库）整理成可追溯的 Excel 数据库，既支持产业数据库，也支持公司数据库、指标库和长期跟踪底表。

- Skill: `joansongjr/sm-industry-database` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joansongjr/sm-industry-database`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joansongjr/sm-industry-database/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: joansongjr (https://skillmd.com/u/joansongjr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joansongjr/sm-industry-database

---


# SM Industry Database

这个 skill 用来搭建“能长期维护、能追溯来源、能直接继续分析”的数据库底表，而不是一次性摘数字。

## 强制流程（v0.9.2 硬约束）

> ⛔ **任何分析输出之前**，必须严格执行 [`../../core/preamble.md`](../../core/preamble.md) 的 6 步开始前流程
>
> ⛔ **任何输出完成之前**，必须严格执行 [`../../core/postamble.md`](../../core/postamble.md) 的 8 步结束后流程
>
> 输出归档按 [`../../core/output-archive.md`](../../core/output-archive.md) 命名规范
> 输出验收按 [`../../core/acceptance.md`](../../core/acceptance.md) 清单逐条自检

Industry Database 特别注意：

- **主交付必须是 `.xlsx`**，不能只交 `.md`
- **同时必须写一份同名 `.md` 说明文件**，用于归档说明、字段字典、缺口清单和刷新建议
- **每一条数据都要有完整中文证据等级 + 具体来源**
- **卖方报告可以入库，但必须单独标注来源类型，且不能伪装成公司公开披露**

## 适用场景

- “帮我搭一个光模块行业数据库”
- “把 AI 眼镜产业链做成数据库”
- “给这家公司搭一个长期更新的经营指标库”
- “把公开市场、卖方拆分和行业数据库里的核心指标整理到 Excel”

## 这类任务的默认交付

1. **一个 Excel 主文件**：结构化字段齐全，可继续维护
2. **一个 Markdown 归档说明**：说明这次库的范围、口径、来源和缺口
3. **一个刷新清单**：后续哪些字段按周 / 月 / 季更新

## Excel 结构（默认四张 sheet）

### 1. `README`

记录：

- 数据库名称
- 覆盖范围（行业库 / 公司库 / 指标库）
- 时间跨度
- 口径说明
- 本次使用的数据源链
- 最近刷新日期

### 2. `database`

这是主表，默认使用**长表结构**。每一行只表达一个数据点。

**必备列**：

| 列名 | 用途 |
|---|---|
| `record_id` | 唯一行号 |
| `database_type` | `industry` / `company` / `theme` |
| `entity` | 公司 / 子行业 / 区域 / 指标对象 |
| `indicator_group` | 收入 / 出货 / 价格 / 产能 / 份额 / 资本开支等 |
| `indicator_name` | 具体指标名 |
| `period` | 年 / 季 / 月 / 周 / 日期 |
| `frequency` | annual / quarterly / monthly / weekly / event |
| `value` | 数值 |
| `unit` | 台 / 片 / 美元 / 百分比等 |
| `currency` | CNY / USD / HKD / JPY / KRW / NA |
| `source_type` | 公司披露 / 行业数据库 / 卖方报告 / 公开市场 / 新闻 / 自行测算 |
| `source_name` | 数据库名 / 报告名 / 公告名 / 网站名 |
| `source_detail` | 页码 / 表名 / query / URL / 报告标题 |
| `source_date` | 源材料日期 |
| `captured_at` | 本次入库日期 |
| `evidence_label` | 公开事实 / 财报披露 / 市场共识 / 合理推演 / 待核验假设 |
| `public_reuse` | `yes` / `no`，是否适合未来外发复用 |
| `derivation_note` | 如果是估算或换算，写清公式或推导链 |
| `status` | confirmed / provisional / missing |
| `note` | 备注 |

### 3. `source_log`

按“源”而不是按“数据点”记一张来源日志，便于后续回看和刷新：

| 列名 | 用途 |
|---|---|
| `source_id` | 唯一来源编号 |
| `source_type` | 公司披露 / 行业数据库 / 卖方报告 / 公开网页等 |
| `source_name` | 来源名称 |
| `source_date` | 来源日期 |
| `coverage_scope` | 覆盖了哪些指标 |
| `usage_limit` | 可外发 / 仅内部 / 待核验 |
| `refresh_hint` | 下次应从哪里继续更新 |

### 4. `evidence_guide`

这张 sheet 专门把证据等级写成**完整中文**，不再使用字母缩写：

| 证据等级 | 说明 | 能否作为核心结论依据 |
|---|---|---|
| `公开事实` | 公开、稳定、可直接验证的事实 | 可以 |
| `财报披露` | 财报、公告、官方披露、权威数据库中的明确数字或事实 | 可以 |
| `市场共识` | 卖方一致预期、市场普遍看法、可验证的共识口径 | 只能辅助 |
| `合理推演` | 基于已知事实做出的推导或换算，必须写出链路 | 只能辅助 |
| `待核验假设` | 传闻、渠道、初步线索或尚未核验的判断 | 不能单独作结论 |

## 数据源使用纪律

### 优先级

1. 公司公告 / 年报 / 季报 / 业绩会
2. 权威行业数据库 / EDB / iFind EDB / 第三方产业数据库
3. 公开市场数据
4. 卖方报告
5. 自行测算

### 卖方报告的特殊规则

- 可以作为**内部数据库来源**
- 必须在 `source_type` 明确写 `卖方报告`
- 必须在 `public_reuse` 标 `no`，除非同一数据点已被公开披露复核
- 不得把卖方报告数据冒充成“财报披露”或“公开事实”

## 执行步骤

### 1. 先定义数据库边界

必须先明确：

- 是产业库还是公司库
- 最终要覆盖哪些指标
- 时间频率是年 / 季 / 月 / 周 / 事件
- 未来谁会继续更新这张表

没有边界就不要直接抓数。

### 2. 先出字段清单，再抓数

先列字段，不要一边搜一边乱填。

默认字段先按四层拆：

1. **对象层**：公司、子行业、区域、客户、产品
2. **经营层**：收入、出货、产能、份额、库存、订单
3. **市场层**：价格、估值、交易、市场预期
4. **来源层**：来源类型、日期、页码、证据等级、是否可外发

### 3. 抓数时先保留“原口径”

- 原始数字和换算数字不要混在一起
- 只要做了估算，就在 `derivation_note` 里写明公式
- 不要把月度值自动年化后覆盖原始值

### 4. 缺失值必须显式记录

数据库里允许存在 `missing`，但不允许“留空却不解释”。

拿不到的数据：

- `value` 留空
- `status` 写 `missing`
- `note` 写明建议来源或为什么当前拿不到

### 5. 最终交付要同时给“库”和“说明”

`.xlsx` 里放结构化数据；
`.md` 里必须写：

- 本次数据库范围
- 关键字段定义
- 已覆盖来源
- 仍需补的资料
- 刷新节奏建议

## 默认输出结构（对话 + 归档说明）

```markdown
# {数据库名称}

## 本次数据库范围
- ...

## 字段设计
- ...

## 已覆盖的数据源
- ...

## 关键发现
- ...

## 仍需补的资料
**必需**：
- ...

**建议**：
- ...

**不确定但影响判断**：
- ...

---

⚠️ 合规声明：本数据库用于研究辅助，不构成投资建议。
```

## 输出归档路径

### 公司数据库

```
{coverage_root}/{ticker}_{name}/database/{YYYY-MM-DD}-database.xlsx
{coverage_root}/{ticker}_{name}/database/{YYYY-MM-DD}-database.md
```

### 行业 / 主题数据库

```
{workspace_root}/themes/{theme-slug}/database/{YYYY-MM-DD}-database.xlsx
{workspace_root}/themes/{theme-slug}/database/{YYYY-MM-DD}-database.md
```

## 约束

- ❌ 不只交文字总结，不交 Excel
- ❌ 不把不同来源的数据直接混成一个“唯一正确答案”
- ❌ 不省略来源日期、页码、query、报告标题这些追溯字段
- ❌ 不再使用 `F1/F2/M1/C1/H1` 这类字母缩写
- ✅ 必须用完整中文证据等级
- ✅ 必须单独记录卖方报告和行业数据库来源
- ✅ 必须给出未来刷新建议

## 与其他 skill 的关系

| 关系 | 说明 |
|---|---|
| **上游** | 可先用 `sm-industry-map` 定义产业链框架 |
| **平行** | `sm-company-deepdive` 负责写研究，`sm-industry-database` 负责搭长期底表 |
| **下游** | 数据库可以继续供 `sm-thesis` / `sm-consensus-watch` / `sm-pm-brief` 调用 |

## 参考

- [../../core/adapters.md](../../core/adapters.md)
- [../../core/evidence.md](../../core/evidence.md)
- [../../core/output-archive.md](../../core/output-archive.md)
- [../../core/acceptance.md](../../core/acceptance.md)