| name | sm-industry-database |
| description | 产业数据库搭建 skill。用于把公开市场数据、公司披露、卖方报告、行业数据库（如 EDB / iFind EDB / 第三方产业库）整理成可追溯的 Excel 数据库，既支持产业数据库，也支持公司数据库、指标库和长期跟踪底表。 |
| inputs | ["行业 / 赛道 / 公司 / 指标范围","可选：时间跨度、市场范围、现有字段清单、已有 Excel 底表"] |
| outputs | ["Excel 数据库主文件（.xlsx）","同名归档说明（.md）","缺口清单与刷新建议"] |
| data_sources | ["见 ../../core/adapters.md","公司公告 / 年报 / 业绩会材料","卖方报告（仅作内部数据库来源，不直接等同于外发可引事实）","行业数据库 / EDB / iFind EDB / 第三方产业库","公开市场价格与成交数据"] |
| markets | ["CN-A","CN-FUND","HK","US","GLOBAL"] |
| trigger | 用户明示“数据库 / 产业数据库 / 公司数据库 / 数据底表 / 指标库 / 数据库搭建” |
SM Industry Database
这个 skill 用来搭建“能长期维护、能追溯来源、能直接继续分析”的数据库底表，而不是一次性摘数字。
强制流程（v0.9.2 硬约束）
⛔ 任何分析输出之前，必须严格执行 ../../core/preamble.md 的 6 步开始前流程
⛔ 任何输出完成之前，必须严格执行 ../../core/postamble.md 的 8 步结束后流程
输出归档按 ../../core/output-archive.md 命名规范
输出验收按 ../../core/acceptance.md 清单逐条自检
Industry Database 特别注意：
- 主交付必须是
.xlsx，不能只交 .md
- 同时必须写一份同名
.md 说明文件，用于归档说明、字段字典、缺口清单和刷新建议
- 每一条数据都要有完整中文证据等级 + 具体来源
- 卖方报告可以入库，但必须单独标注来源类型，且不能伪装成公司公开披露
适用场景
- “帮我搭一个光模块行业数据库”
- “把 AI 眼镜产业链做成数据库”
- “给这家公司搭一个长期更新的经营指标库”
- “把公开市场、卖方拆分和行业数据库里的核心指标整理到 Excel”
这类任务的默认交付
- 一个 Excel 主文件：结构化字段齐全，可继续维护
- 一个 Markdown 归档说明：说明这次库的范围、口径、来源和缺口
- 一个刷新清单：后续哪些字段按周 / 月 / 季更新
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 专门把证据等级写成完整中文，不再使用字母缩写：
| 证据等级 | 说明 | 能否作为核心结论依据 |
|---|
公开事实 | 公开、稳定、可直接验证的事实 | 可以 |
财报披露 | 财报、公告、官方披露、权威数据库中的明确数字或事实 | 可以 |
市场共识 | 卖方一致预期、市场普遍看法、可验证的共识口径 | 只能辅助 |
合理推演 | 基于已知事实做出的推导或换算，必须写出链路 | 只能辅助 |
待核验假设 | 传闻、渠道、初步线索或尚未核验的判断 | 不能单独作结论 |
数据源使用纪律
优先级
- 公司公告 / 年报 / 季报 / 业绩会
- 权威行业数据库 / EDB / iFind EDB / 第三方产业数据库
- 公开市场数据
- 卖方报告
- 自行测算
卖方报告的特殊规则
- 可以作为内部数据库来源
- 必须在
source_type 明确写 卖方报告
- 必须在
public_reuse 标 no，除非同一数据点已被公开披露复核
- 不得把卖方报告数据冒充成“财报披露”或“公开事实”
执行步骤
1. 先定义数据库边界
必须先明确：
- 是产业库还是公司库
- 最终要覆盖哪些指标
- 时间频率是年 / 季 / 月 / 周 / 事件
- 未来谁会继续更新这张表
没有边界就不要直接抓数。
2. 先出字段清单，再抓数
先列字段，不要一边搜一边乱填。
默认字段先按四层拆：
- 对象层：公司、子行业、区域、客户、产品
- 经营层：收入、出货、产能、份额、库存、订单
- 市场层：价格、估值、交易、市场预期
- 来源层：来源类型、日期、页码、证据等级、是否可外发
3. 抓数时先保留“原口径”
- 原始数字和换算数字不要混在一起
- 只要做了估算，就在
derivation_note 里写明公式
- 不要把月度值自动年化后覆盖原始值
4. 缺失值必须显式记录
数据库里允许存在 missing，但不允许“留空却不解释”。
拿不到的数据：
value 留空status 写 missingnote 写明建议来源或为什么当前拿不到
5. 最终交付要同时给“库”和“说明”
.xlsx 里放结构化数据；
.md 里必须写：
- 本次数据库范围
- 关键字段定义
- 已覆盖来源
- 仍需补的资料
- 刷新节奏建议
默认输出结构（对话 + 归档说明）
# {数据库名称}
## 本次数据库范围
- ...
## 字段设计
- ...
## 已覆盖的数据源
- ...
## 关键发现
- ...
## 仍需补的资料
**必需**：
- ...
**建议**：
- ...
**不确定但影响判断**：
- ...
---
⚠️ 合规声明：本数据库用于研究辅助，不构成投资建议。
输出归档路径
公司数据库
{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 调用 |
参考
