fin-brief-generator

fin-brief-generator

根据用户输入或已有研究输出（文献综述/想法报告/新颖性报告），自动生成或更新FIN_BRIEF.md，减少用户填写负担。

触发条件

• 关键词: 生成简报 FIN_BRIEF brief 研究简报 简报 研究概要
• Skill语法: Skill: fin-brief-generator
• 前置条件: 可选 — 已有研究输出文件

三种工作模式

模式一：推理模式 (Inference Mode)

当项目中已有研究输出文件时，从现有文件中自动推断字段值。

输入文件优先级:

1. output/fin-literature/LIT_REVIEW.md       → 提取研究领域、方法、文献缺口
2. output/fin-ideas/IDEA_REPORT.md           → 提取候选想法、评分
3. output/fin-novelty/NOVELTY_REPORT.md      → 提取定位策略
4. output/fin-refinement/REFINED_DESIGN.md  → 提取研究设计细节

执行流程:

from scripts.brief_generator import BriefGenerator, InferenceMode

generator = BriefGenerator(project_root=".")

# 推理模式：从现有文件推断
brief = generator.generate_from_outputs(mode=InferenceMode)

# 仅向用户展示未知字段
unknown_fields = brief.get_unknown_fields()
print(f"需要您补充 {len(unknown_fields)} 个字段:")
for field in unknown_fields:
    print(f"  - {field}")

示例:

已推断字段: 12/17
- 研究主题: 碳排放权交易对企业绿色创新的影响 ✅
- 因果推断方法: 双重差分法 (DID) ✅
- 目标期刊: 经济研究 ✅

需补充字段: 5/17
- 主要作者: ?
- 协作者: ?
- 资助机构: ?
- 文献综述截止日期: ?
- 初稿截止日期: ?

模式二：问卷模式 (Questionnaire Mode)

当有部分信息时，通过结构化问卷收集缺失信息。

问卷流程:

from scripts.brief_generator import QuestionnaireMode

generator = BriefGenerator(project_root=".")

# 运行问卷
answers = generator.run_questionnaire(
    questions=[
        {
            "id": "topic",
            "question": "研究主题是什么？请用一句话描述",
            "type": "text",
            "required": True,
        },
        {
            "id": "journal",
            "question": "目标期刊是哪个？",
            "type": "choice",
            "options": ["JF", "JFE", "RFS", "经济研究", "金融研究", "管理世界", "其他"],
            "required": True,
        },
        {
            "id": "data_source",
            "question": "主要数据来源是什么？",
            "type": "choice",
            "options": ["Tushare/A股", "CSMAR", "Wind", "Yfinance/美股", "手动收集", "其他"],
            "required": True,
        },
        {
            "id": "method",
            "question": "有偏好的研究方法吗？",
            "type": "choice",
            "options": ["DID", "IV/2SLS", "RDD", "合成控制", "PSM", "面板GMM", "无偏好"],
            "required": False,
        },
    ],
    interactive=True,  # 对话式问卷
)