finai-research: Instructions file for GitHub Copilot

Copilot Instructions for 论文-研报工作流

This file provides GitHub Copilot with project context and instructions. Place in .github/copilot-instructions.md at the repository root.

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

项目概述

论文-研报工作流 (FinResearch Agent) 是经济金融领域的 AI 研究助手，自动化从文献综述到可投稿论文的全流程。

• 语言: Python 3.10+
• 数据: MCP (Model Context Protocol) 服务器，{{MCP_COUNT}} 个数据源（见 scripts/count_mcp.py）
• 关键: 大部分数据源无需 API Key（世界银行、IMF、OECD 等免费数据）

---

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

用户打开对话
        ↓
① 问候 + 能力介绍（固定文案，不跳过）
        ↓
② 后台运行 python scripts/health_check.py --json
        ↓
  ┌─ API Key 缺失 → 简短提示（不阻塞）
  ├─ LLM 不可用 → 询问是否继续
  └─ 系统就绪 → 等待研究方向
        ↓
③ 询问研究方向 → 用户描述 → 开始研究

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

诊断交互（三平台统一）

1. 运行诊断脚本，打印四类问题分类报告
2. 读取 InteractionResult 结构
3. 在对话中向用户展示问题，等待回复
4. 根据用户回复执行操作

API Key 缺失：AI 在对话中询问，用户回复后执行配置或继续 LLM 不可用：AI 在对话中展示问题 + 修复步骤，询问是否继续

Claude Code 和 Codex 不支持 input()，必须通过对话交互。

---

项目结构

scripts/
├── health_check.py           # 系统诊断（每次启动时运行）
├── setup_wizard.py          # 交互式配置向导
├── agent_pipeline.py        # 主编排器
├── research_framework/      # 研究执行层（30个模块）
│   ├── pipeline.py         # 研究执行
│   ├── modern_did.py       # 现代 DID
│   ├── regression_engine.py  # OLS/DID/PSM/IV/GMM
│   ├── fin_charts.py      # matplotlib 图表（≥300 DPI）
│   └── data_fetcher.py    # MCP 数据获取
├── core/                   # Agent 编排模块
├── research_directions/     # 研究方向（12个）
mcp_servers/               # `{{MCP_COUNT}}` 个 MCP 数据服务器
knowledge/skills/           # 17 个技能文档（真相源）

---

关键能力

数据获取（MCP）

数据类型	MCP 服务器	需要 Key
A股行情/财务	user-tushare	TUSHARE_TOKEN
中国宏观	user-financial	无
美联储/FOMC	user-fed-data	无
世界银行	user-wb-data	无
IMF	user-imf-data	无
OECD	user-oecd-data	无
国债收益率	user-eodhd	EODHD_API_KEY
研报/新闻	user-eastmoney-reports	无
外汇/大宗	user-enhanced-finance	无
NBER Working Papers	user-nber-wp	无