Alpha Research Recorder

Alpha 研究记录器 Skill

技能定位

本技能是 Alpha 研究流程中的数据持久化层，负责将研究过程的结构化数据保存为可追溯的日志文件。

在研究流程中的地位

Copy code
研究流程：
┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│ 知识检索/输入    │ ───▶ │  Alpha 生成/回测 │ ───▶ │   因子评估       │
│ (其他技能)       │      │  (其他技能)      │      │  (其他技能)      │
└────────┬────────┘      └────────┬────────┘      └────────┬────────┘
         │                        │                        │
         └────────────────────────┼────────────────────────┘
                                  ▼
                    ┌─────────────────────────┐
                    │  alpha-research-recorder │ ◀── 本技能
                    │  (数据持久化 + 文件管理)  │
                    └─────────────────────────┘
                                  │
                    ┌─────────────┴─────────────┐
                    ▼                           ▼
              session_metadata.yml        round_NNNN.yml
              (会话配置)                  (轮次记录)
                    │                           │
                    └─────────────┬─────────────┘
                                  ▼
                          final_summary.md
                         (最终总结报告)

记录类型

本技能支持三种独立的记录类型，按需调用，无固定顺序：

调用方式：

• ✅ 可以只调用 session_meta，不创建 round
• ✅ 可以创建多个 round，延迟创建 final_summary
• ✅ 可以中途补充或修改任何记录
• ❌ 禁止跳过 session_meta 直接创建 round

参数规范

通用参数（所有记录类型共用）

数据参数（根据 record_type 引用对应模板）

每种记录类型的完整字段定义请查看对应的模板文件：

典型场景

场景 1：研究开始时快速创建 session_meta

技能操作：

• 读取 templates/session_metadata.yml.template
• 将传入数据合并到模板
• 保留未填写的可选字段为空或注释
• 创建 {root_dir}/{session_id}/session_metadata.yml

场景 2：研究进行中补充 session_meta

技能操作：

• 读取已存在的 session_metadata.yml
• 合并新数据到已有字段
• 不覆盖已填写的内容
• 更新文件

场景 3：创建 round 记录

步骤：

1. 查看 templates/round_NNNN.yml.template
2. 识别 [必填] 字段
3. 传入数据

文件结构

Copy code
{root_dir}/                        # 默认: logs/
└── {session_id}/                  # 例如: 20260108_analyst_sonnet/
    ├── session_metadata.yml       # 会话配置（可逐步完善）
    ├── round_0001.yml             # 第1轮（可逐步完善）
    ├── round_0002.yml             # 第2轮（可逐步完善）
    ├── ...                        # 更多轮次
    └── final_summary.md           # 最终总结（可选）

核心原则

1. 经济学分析优先 ⭐⭐⭐⭐⭐

以下字段在任何阶段都应优先填写（在模板中标注为 ⭐）：

• economic_analysis.hypothesis（经济学假设）
• economic_interpretation（经济学解释）
• economic_insights（经济学洞察）

2. 结构化优先

• ✅ 使用 YAML 确保数据可解析
• ✅ 避免自由文本，便于程序化提取
• ✅ 标准化字段命名

成功标准

模板文件

模板文件索引

查看方式：

bashCopy code
# 查看特定模板
cat templates/session_metadata.yml.template

# 或在 IDE 中打开
open templates/round_NNNN.yml.template

数据流向

Copy code
其他技能 ──────▶ alpha-research-recorder ──────▶ YAML/MD 文件
(生成数据)         (引用模板 + 数据合并)            (持久化存储)
                       │
                       ▼
                  查看模板文件
             templates/{type}.template