第 9 课 · 报告管理

批量管理投研报告

前面 8 讲把研究跑通了;
今晚把它们收成能打开、能一起管的 HTML 报告。

主案例 reports/catalog.html
报告
管理
跑通研究
九个章节
Research
Report
index.html
catalog
先看现状

从报告目录查看研究结果

本地 reports/catalog.html 已将四份策略报告放在同一个目录里。

研究报告目录截图:四份报告的名称、样本区间、夏普比率、最大回撤和查看报告链接
点击图片查看原始尺寸。
1 · 九个章节

完整报告要写满这九章

模板里就是这九个标题。少一章,别人就没法复核。

1研究问题这次在问什么。没有它,读者只看到一条曲线。
2数据与样本标的、频率、起止、有没有切 IS/OOS。
3假设与方法规则、因子或模型到底是什么。
4执行约定什么时候成交、lag、佣金、滑点。
5证据与指标收益、回撤、换手、成本从哪来。
6图表净值、回撤,以及和问题对得上的图。
7对照与稳健性和谁比过。没做就写「本报告未做」。
8限制与下一步哪些结论推不出来,下一步想做什么。
9复现与产物怎么重跑,文件都在哪。
对照可以没做,第 7 章还是要写「本报告未做」。不要另加一章「投资建议」。
2 · 现有 skill

report skill 从结果到网页怎么走

上游交研究结果,charts 负责画图;网页走哪条路径,取决于要预览还是要交付完整报告。

研究结果→charts 画图→选择网页用途

只看指标和曲线:预览页

调 ReportRenderer→预览页

方便马上看结果,尚不是完整研究报告。

交付研究:九章报告

填 ResearchReport→write_research_bundle→index.html

问题、样本、方法、指标与限制写全;另调 write_research_catalog 才会生成目录页。

3 · 同一条写出路径

完整报告都走同一条路:字段 → 函数 → 模板 → 固定目录

字段ResearchReport同一套内容
→
写出函数write_research_bundle文件名函数自己定
→
模板research_report.html九个中文标题
→
保存位置namespace/slugindex.html
约束做法漏了会怎样
字段缺 question 或 metrics_source 就报错写不出 HTML
版式九个中文 <h2> 写在同一份模板里测试会检查标题齐不齐
图只收 PNG,嵌进页面不会出现有的图要外链才能看
路径函数自己拼 reports/<namespace>/<slug>/index.html目录页才能稳定扫到
编目同时有 index.html 和 params.json 才算一份 study旧的 CSV 堆不会混进总览
分类靠文件夹和 params.json,不上数据库。默认 private,不要提交。公开示例是薄 HTML 卡片,不是九章档案。
统一写出路径 · 单步播放

ResearchReport 怎样变成 HTML?

4 · 谁写 HTML

别的 skill 不要自己写研究报告

上游只交结果→Agent 填 ResearchReport

字段缺失或自己拼 HTML

关键字段不全→报错,不写文件

上游 skill 不负责拼报告页面。

字段齐全,走统一入口

write_research_bundle→index.html + params.json

同一套字段校验、模板和写出路径。

只看这一份

打开报告的 index.html。

还要总览

另调 write_research_catalog,生成 catalog.html。

完整报告只走 write_research_bundle。report skill 不算因子、不跑回测。
5 · 课堂例子

用第 5 课的 IF 规则出一份 HTML

这课不新开研究,不调参,也不报具体收益。规则第 5 课已经讲过。

空仓、且 MA10 / ATR14 算得出来时,close < MA10 就满仓;
止损只上移;close 跌破止损就空仓。
字段课堂上怎么填
路径namespace=lesson_09,slug=if_ma10_atr → reports/lesson_09/if_ma10_atr/index.html
品种 / 频率["CFFEX.IF99"] · 1d
成交约定和第 5 课课堂上说的一致,写进报告正文
visibilityprivate(默认不要提交)
metrics_sourceBacktestResult.metrics,或写清 parquet / csv 路径
问题怎么写写成「看这条规则在给定成本下的历史表现」,不要写成「这是稳赚策略」。
数字怎么对报告里的关键数字,要能在 metrics_source 或 params.json 里找到同一来源。
图怎么验把 index.html 单独拷到桌面再打开。图还在,才算嵌进去了。
6 · 编目

目录页要另调一次,不会跟着 bundle 自动生成

做完 8 讲,本地会有一堆实验文件夹。没有总览,就只能凭记忆去翻。

write_research_catalog()
    → 扫描 reports/(跳过 README、catalog 自己)
    → 同时有 params.json 和 index.html → 收成一条
    → 只有 CSV/PNG → 还没写成报告,不进目录
    → 写出 reports/catalog.html 和 reports/catalog.json
目录里至少列出namespace、slug、标题、样本起止、有指标就展示(没有就空着,不要编)、visibility,以及点进该 index.html 的链接。
不是数据库catalog.json 只是把扫描结果存成文件,方便 Agent 读。下次生成会整份覆盖。报告几十到几百份时,扫目录足够快。
旧目录不会自动升级没有 index.html 的 CSV 堆,不会混进总览。有人补写成报告之后才会出现。
公开示例短页不进目录strategy_examples 没有 params.json 和 index.html,不会自动编进来。
编目录是为了好找,不是宣布这些实验都有效。不要把指标排序讲成排行榜。catalog 默认也不要提交。
课后作业 · 发给 AI 的 Prompt

请 AI 生成策略报告,prompt示例:

请用 report skill,把本地股指期货均线回归加 ATR 止损策略(或其它曾经开发出的策略,包括但不限于现金流指数时序策略、ETF截面多因子策略、ETF截面机器学习策略)的研究结果整理成一份报告,并核对收益、回撤和买入持有对照。请保存报告、更新本地报告目录,然后告诉我报告在哪里。