industry-research-method

行业研究方法论（industry-research-method）

本技能规范一次行业研究的全流程，产出每个数字都能回溯到来源的可核查产物。合规底线：仅供研究，不构成投资建议；不接交易、不做实时告警、不使用需登录/付费/绕反爬的数据源。

工具配合关系

阶段	工具	产物
建图	industry_map	<industryRoot>/<行业>/chain.json（校验过的产业链结构图）
跟踪	industry_track	<industryRoot>/<行业>/timeline.jsonl（政策/动态时间线）
成文	industry_report	reports/<时间戳>/report.md + manifest.json（引擎缺席时为 builtin-fallback）

工作区默认根为 industry-research/（可用 industryRoot 配置）。方法论细节见 references/frameworks.md（供需框架与常见拆分模板），需要时再用 read 工具加载。

阶段 1：产业链拆分（industry_map）

1. 先调用 industry_map({ industry })（不带 chain）读取当前图与已登记来源；有用户笔记/文件时经 seed/seedFiles 登记为来源（得 ref，如 S1）。
2. 按上/中/下游拆分撰写 ChainMap：
   • 上游：原材料、关键投入品、设备与基础设施。
   • 中游：生产制造、核心工艺环节、主要参与者类型。
   • 下游：分销渠道、终端应用、消费者/客户类型。
   • 边表示投入→产出关系，note 写明关系性质（如「原料供应」「渠道分销」）。
3. 每个节点挂指标槽位：有 value 必须带 sourceRef（sources.json 的 ref、URL 或工作区路径）并尽量带 asOf；暂时没有来源的指标只写 key 不写 value——这就是显式待补槽位，禁止填估计值。
4. 带 chain 再次调用 industry_map；校验失败（悬空边、无来源数值、非法 tier）按返回的问题清单修正后重试。
5. 工具返回的 gaps 是后续工作的清单，不是失败：逐项决定是补充来源还是保留待补。

阶段 2：政策与动态跟踪（industry_track）

1. 默认主题为「<行业> 行业 政策」与「<行业> 行业 动态 要闻」；用户给定点时经 topics 传入。
2. 条目纪律：每条带来源 URL、发布日期（来源无日期则为空，不得编造日期）、摘要与快照哈希；抓取失败的条目以纯引用形式记录并在 note 中说明。
3. 来源治理：部署方可用 sourceAllowlist/sourceBlocklist 收口（如只信 gov.cn）；被拦截与去重的计数在结果中如实报告。
4. ctx.web 未挂载或 offline: true 时工具会响亮失败——如实转告用户需要挂载 web provider 或关闭 offline，不得用记忆代替检索结果充数。

阶段 3：报告成文（industry_report）

1. 默认自动草稿即可成文；需要定制叙述结构时用 draft 撰写 sections + claims：
   • 每条 claim 必须登记 evidenceIds（E-chain / E-timeline / E-company-<slug>）。
   • claim 文本中的数字必须与证据内容一致——引擎路径会逐条核查，builtin-fallback 路径会把 claims 如实标记为 unverified。
2. 报告必须保留：免责声明（仅供研究，不构成投资建议）、来源回溯表、缺口与待补清单。
3. 挂载了 ctx.researchReport 引擎时报告经其 assemble 封存并回传 sealHash 与逐 claim 结论；未挂载时走 reports/<时间戳>/ 的版本化降级目录，如实标注 engine: builtin-fallback。

口径纪律（违反即返工）

• 每个数字三要素齐全：数值、单位、来源（+ 尽量 asOf）；缺来源的数字降级为待补槽位。
• 口径一致：同一指标跨来源使用时注明口径差异（如「出厂口径 vs 零售口径」）。
• 缺口声明优于完整假象：找不到的数据写进缺口清单，禁止编造产业链数据、公司数字或政策条文。
• 区分事实与判断：检索到的事实带来源；研究者的判断/推测必须明示为判断，不混入证据区。
• 合规话术：对用户的任何结论性表述以「仅供研究，不构成投资建议」收尾；不预测价格、不推荐买卖。