deep-investment-research — 系统化投研能力中枢#

一套可复用的投研方法论 + 多源一手数据采集工具。OpenClaw 提供运行时（gateway/cron/工具），本 skill 提供投研方法论+数据采集能力。 本 skill 只承载「研究能力」；调用方的身份/人格/记忆由各自 workspace 提供，不在本 skill 内。

环境约定（可选，均带默认值）#

• RESEARCH_OUTPUT_DIR：研究报告归档目录，默认 ~/research-output
• RESEARCH_DATA_ROOT：数据采集落盘目录，默认 ~/research-data
• SEARCH_SKILL_PATH：联网搜索脚本路径，默认指向 web-search-plus（未安装则降级用内置 web_search 工具）
• 脚本内 API key 一律读环境变量（如 FINNHUB_API_KEY/ FRED_API_KEY），未设置则跳过该数据源。

数据与隐私披露（安装前知情）#

本 skill 是研究工具，会进行以下外部交互与本地写入——安装/使用即视为知情同意：

• 第三方数据传输：研究主题/查询词会发送给外部搜索与数据 API（Serper/Tavily/Finnhub/FRED/SEC EDGAR/HKEX/政府门户等）以获取一手资料。 不要在涉及保密持仓、未公开自营研究主题时使用，除非可接受向这些第三方披露查询内容。
• 读取环境变量：仅读取数据源 API key（ FINNHUB_API_KEY/ FRED_API_KEY 等）用于调用对应数据源，不外传 key 本身、不读取其它环境变量。
• 本地落盘：研究报告写入 RESEARCH_OUTPUT_DIR（默认 ~/research-output），采集数据写入 RESEARCH_DATA_ROOT（默认 ~/research-data）。文件写入预测路径，使用前确认目录无敏感数据冲突。
• 网络抓取：方法论会对搜索发现的 URL 做全文抓取（web_fetch）。少数官方站点（国资委/人民网/openinsider）仅支持明文 http（其 https 不可达），已在代码注释标明；其余已统一走 https。
• 最小权限：脚本以列表参数调用子进程（无 shell=True、无 eval/exec/动态 import），不执行任意命令。

何时触发#

• 任何投资研究请求：宏观/行业/政策/个股/可行性/风险/规划
• 需要真实一手数据（财报/公告/政策原文/宏观/机构动向/一致性预期）
• 用户点题某行业/标的/主题/政策

九条研究红线（地基，贯穿全部）#

1 深度·价值·前瞻 ｜ 2 数据真实不杜撰 ｜ 3 全文阅读不停留表面 ｜ 4 结论质量门控不说空话 ｜ 5 第一性原理广收集深研究 ｜ 6 紧扣目标不偏离 ｜ 7 prompt最佳实践榨干模型 ｜ 8 客观准确不主观 ｜ 9 未充分调研不下结论

怎么用（任何研究先走这里）#

Step 1 — 读内核（所有研究通用）+ 看近期产物#

先读 ${RESEARCH_OUTPUT_DIR:-~/research-output}/<行业>/ 最近 2-3 篇同领域研究作背景（有则读，注意时效；无则跳过），再读：

• methodology/research-core.md — 9红线 + 研究设计+七棱镜多维扫描（强制前置：反千篇一律+反单维度） + 深度研究5步法(A→B→C→D) + 反证5问 + 结论质量门控

  任何研究动笔前先做：①诊断对象核心矛盾、设计本次研究重心（贴合实际不套模板）②过七棱镜（宏观/政策/地缘/产业链/资金面/新闻情绪/标的自身），相关维度深挖、不相关明说为何忽略

• methodology/source-registry.md — 8行业权威一手源清单 + 搜索工具优先级

• methodology/content-reading-protocol.md — 全文阅读硬门控 + 读取量 + 来源回溯

Step 2 — 按课题类型读对应框架+模板#

课题框架模板行业深度研究methodology/industry-research.mdtemplates/01公司研究（看懂生意本身）methodology/company-research.mdtemplates/06个股深度研究（投资判断）methodology/stock-deep-dive.mdtemplates/02投资可行性分析methodology/feasibility-analysis.mdtemplates/03政策研究与追踪methodology/policy-research.mdtemplates/04风险分析methodology/risk-analysis.mdtemplates/05投资规划methodology/investment-planning.md—宏观研究methodology/{china-macro,us-macro}.md—

Step 3 — 取真实一手数据（红线2/5）#

优先级：一手原文/官方数据/API > 定向爬虫 > 搜索引擎兜底。 各行业权威源见 source-registry.md。

bash

SK={baseDir}/scripts
python3 $SK/policy_gov_fetcher.py        # 政策原文
python3 $SK/ministry_scanner.py          # 部委政策扫描
python3 $SK/edgar_filings.py             # 美股财报/8-K/13F
python3 $SK/hkex_announcements.py        # 港股公告
python3 $SK/china_macro.py               # 中国宏观(AKShare)
python3 $SK/macro_snapshot.py            # 市场宏观快照
python3 $SK/analyst_consensus.py         # 一致性预期
python3 $SK/analyst_revision.py          # 预期修正
python3 $SK/earnings_surprise.py         # 业绩beat/miss
python3 $SK/superinvestor_moves.py       # 机构大师持仓
python3 $SK/sec_13f.py / insider_transactions.py / short_interest.py / southbound_top10.py / transcripts.py
python3 $SK/data_daily.py --tags morning # 批量采集

数据落盘 ${RESEARCH_DATA_ROOT:-~/research-data}/data/daily/{date}/（由 RESEARCH_DATA_ROOT 环境变量控制）。

搜索（找线索，不出结论）#

优先用专用搜索 skill（Serper/Tavily，覆盖好、可控）；未安装时降级用内置 web_search 工具兜底。 结论靠 web_fetch/pdf 读全文，搜索只找线索。

bash

# 若已安装 web-search-plus（路径可用 SEARCH_SKILL_PATH 覆盖）：
python3 "${SEARCH_SKILL_PATH:-~/.openclaw/skills/web-search-plus/scripts/search.py}" --query "查询" --provider serper --max-results 5
# 若已安装 tavily-search：
node ~/.openclaw/skills/tavily-search/scripts/search.mjs "查询" --topic news
# 均未安装：直接用 OpenClaw 内置 web_search 工具

认知连续性（用研究产物，不用静态档案）#

不预存任何静态行业档案——静态认知必然过时且锚定共识，违背找预期差的本质。认知连续性靠研究产物库实现（见上）。 连续性靠 研究产物库 实现：做某行业/标的研究前，先看 ${RESEARCH_OUTPUT_DIR:-~/research-output}/<行业>/ 最近 2-3 篇研究（带日期、带一手数据、带来源），站在上次真实研究的肩上，而非模型存量记忆。 注意时效：产物只作背景与线索，"当前景气/估值/最新动态"一律用本次一手数据现取覆盖；过时结论只当"曾经的判断"参考，不当事实。

研究产物入库#

报告写入 ${RESEARCH_OUTPUT_DIR:-~/research-output}/<行业>/YYYY-MM-DD-课题.md。如需远程备份，由调用方的备份任务自行处理。

红线·边界#

纯研究助理：不盯盘、不发买卖/止损信号、不做交易执行、不维护持仓。提供判断+依据+风险+可选路径，用户是最终决策者。