finai-research: Instructions file for Claude Code

论文-研报工作流 · FinResearch Agent

📌 占位符约定：本文档中提及的 MCP 总数使用 {{MCP_COUNT}} 占位符。 实际数字由 python scripts/count_mcp.py 自动扫描 mcp_servers/user_* 目录后写入 .docs-cache/MCP_COUNT.txt。新增/删除 MCP 目录后，跑一次该脚本即可让所有引用保持准确。

CI 状态：PR-1 ~ PR-7 全部 merge，16/16 CI 全绿（3165d09）。

经济金融领域 AI 研究助手。生成论文草稿，集成 MCP 数据获取、因果推断、LaTeX 排版和 AI 辅助 review。

⚠️ 重要声明：本工具生成的论文草稿必须经研究者逐字审阅后方可投稿。所有因果识别策略、统计结果和引用必须由研究者独立核实。

适用工具: Claude Code · GitHub Copilot · Cursor（通用 AI 编码工具均可）

---

一句话

"告诉我研究主题，我帮你：从文献综述 → 想法生成 → 实证设计 → 论文草稿 → LaTeX 编译。（草稿需研究者审阅后投稿。）"

---

快速开始

不需要记命令。直接说研究方向：

"我想研究关税政策对A股出口型企业创新的影响，设计一篇发表在经济研究的实证论文"
"帮我做数字金融领域的文献综述"
"有什么新的研究想法关于企业ESG表现和融资成本"

或用脚本直接运行：

# 写作轨
python scripts/agent_pipeline.py --topic "碳排放权交易对企业绿色创新的影响" --use-hitl
# 实证轨（现代 DID）
python -m scripts.research_framework.enhanced_pipeline --topic "碳排放权交易对企业绿色创新的影响"
pytest tests/ -v

---

自动启动流程（每次对话必须执行）

用户打开对话
        ↓
① 问候 + 能力介绍（固定文案，不跳过）
        ↓
② 快速诊断：python scripts/startup_check.py（轻量，<3秒）
        ↓
③ 详细诊断（可选）：python scripts/health_check.py --verify
        ↓
④ MCP 注册检查：python scripts/register_mcp_servers.py --list
        ↓
  ┌─ API Key 缺失 → 简短提示（不阻塞）
  ├─ LLM 不可用 → 询问是否继续
  ├─ MCP 未注册 → 提示运行 `python scripts/register_mcp_servers.py`
  └─ LaTeX 缺失 → 提示安装 tectonic / MacTeX
        ↓
⑤ 等待研究方向 → 用户描述 → 开始研究
        ↓
⑥ 推荐路径（两条，勿混用文档死链）：
     · 新用户澄清：python scripts/start_research.py --topic "..."
       （锁定 research_profile.json；默认不自动开跑）
       可选：加 --continue --use-hitl 进入写作流水线
     · 直接写作：python scripts/agent_pipeline.py --topic "..." [--use-hitl]
       （--use-hitl 默认停 outline/literature/draft）
     · HITL：agent_pipeline 的 HITLGate；InteractivePipelineCheckpoint
       仅供技能/脚本手动 import，不自动挂入主流水线

第一步问候是强制要求，不要跳过。直接开始工作会显得突兀。

---

核心能力

数据获取（MCP，{{MCP_COUNT}} 个服务器目录）

重要说明：{{MCP_COUNT}} 个 MCP 目录中，28 个完全免费（无需 API Key），12 个需要 API Key，3 个为 opt-in 法律风险。详见 python scripts/count_assets.py。

你要什么	用这个 MCP
A股行情/财务/融资融券	user-tushare（需 TUSHARE_TOKEN）
中国宏观（GDP/CPI/M2）	user-financial
美联储/FOMC	user-fed-data
世界银行宏观	user-wb-data
IMF数据	user-imf-data
OECD数据	user-oecd-data
美国经济分析局GDP	user-bea-data
国债收益率/经济日历	user-eodhd（需Key）或 user-fed-data
美股/ETF/期权/财务	user-yfinance
研报/新闻/板块/分析师	user-eastmoney-reports
公募基金	user-eastmoney-fund
债券数据	user-eastmoney-bond
期权数据	user-eastmoney-option
外汇/航运/大宗商品	user-enhanced-finance
加密货币	user-cryptocompare
SEC 10-K/10-Q/8-K	user-sec-edgar
学术论文（全文）	user-openalex、user-arxiv、user-context7、user-semantic-scholar
NBER工作论文	user-nber-wp
中文文献（CSSCI/CNKI）	user-chinese-literature、user-wanfang、user-csmar
中国专利数据	user-sipo
中国海关数据	user-chinese-customs
Wind数据	user-wind（需账号）
CSMAR国泰安	user-csmar（需Key）
CEIC宏观	user-macro-ceic
省级/市级统计	user-province-stats、user-hubei-stats、user-wuhan-stats
新闻搜索	user-newsapi（需Key）、user-brave-search（需Key）
云端代码执行	user-e2b-mcp（需Key）
浏览器自动化	user-playwright-mcp
数据处理	user-pandas-mcp
LaTeX排版检查	user-latex-mcp
文件系统操作	user-filesystem-mcp