Alpha research recorder - serves as the data persistence layer for the research workflow. Core features: 1. Reference the corresponding template file based on record type (session_meta/round/final_summary) 2. Accept structured data and validate required fields 3. Create/update YAML or Markdown log files Usage: - Specify record_type and session_id when invoking - Inspect template files to see the full field structure: templates/{record_type}.template - Merge the provided data into the template to produce the final file
本技能是 Alpha 研究流程中的数据持久化层，负责将研究过程的结构化数据保存为可追溯的日志文件。
研究流程：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 知识检索/输入 │ ───▶ │ Alpha 生成/回测 │ ───▶ │ 因子评估 │
│ (其他技能) │ │ (其他技能) │ │ (其他技能) │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
└────────────────────────┼────────────────────────┘
▼
┌─────────────────────────┐
│ alpha-research-recorder │ ◀── 本技能
│ (数据持久化 + 文件管理) │
└─────────────────────────┘
│
┌─────────────┴─────────────┐
▼ ▼
session_metadata.yml round_NNNN.yml
(会话配置) (轮次记录)
│ │
└─────────────┬─────────────┘
▼
final_summary.md
(最终总结报告)
本技能支持三种独立的记录类型，按需调用，无固定顺序：
| 记录类型 | 文件格式 | 使用场景 | 输出文件 | 模板文件 |
|---------|---------|---------|---------|---------|
| session_meta | YAML | 研究开始时记录配置和约束 | session_metadata.yml | templates/session_metadata.yml.template |
| round | YAML | 单轮研究结束后记录完整过程 | round_NNNN.yml | templates/round_NNNN.yml.template |
| final_summary | Markdown | 研究完成后生成总结报告 | final_summary.md | templates/final_summary.md.template |
调用方式：
session_meta，不创建 roundround，延迟创建 final_summarysession_meta 直接创建 round| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| record_type | string | 是 | - | 记录类型："session_meta" / "round" / "final_summary" |
| root_dir | string | 否 | "logs/" | 研究日志根目录 |
| session_id | string | 是 | - | 会话唯一标识，格式：YYYYMMDD_<主题>_<LLM> |
每种记录类型的完整字段定义请查看对应的模板文件：
| 记录类型 | 模板文件路径 | 查看方式 |
|---------|-------------|---------|
| session_meta | ./templates/session_metadata.yml.template | 包含注释说明哪些是必填字段 |
| round | ./templates/round_NNNN.yml.template | 包含注释说明哪些是必填字段 |
| final_summary | ./templates/final_summary.md.template | 包含注释说明哪些是必填字段 |
技能操作：
templates/session_metadata.yml.template{root_dir}/{session_id}/session_metadata.yml技能操作：
session_metadata.yml步骤：
templates/round_NNNN.yml.template[必填] 字段{root_dir}/ # 默认: logs/
└── {session_id}/ # 例如: 20260108_analyst_sonnet/
├── session_metadata.yml # 会话配置（可逐步完善）
├── round_0001.yml # 第1轮（可逐步完善）
├── round_0002.yml # 第2轮（可逐步完善）
├── ... # 更多轮次
└── final_summary.md # 最终总结（可选）
以下字段在任何阶段都应优先填写（在模板中标注为 ⭐）：
economic_analysis.hypothesis（经济学假设）economic_interpretation（经济学解释）economic_insights（经济学洞察）| 维度 | 标准 | 验证方法 |
|------|------|---------|
| 可追溯性 | 每个决策都有明确记录 | 检查 rationale、hypothesis 字段 |
| 渐进性 | 支持分阶段填写 | 验证可选字段可后续补充 |
| 经济学深度 | 核心经济学字段完整 | 检查 3 个 economic_* 字段 |
| 可解析性 | YAML 可被程序提取 | 使用 yaml.safe_load() 验证 |
| 灵活性 | 支持按需调用 | 验证可单独创建任意记录类型 |
| 模板文件 | 记录类型 | 格式 | 行数 | 说明 |
|---------|---------|------|------|------|
| session_metadata.yml.template | session_meta | YAML | ~60 | 会话配置完整模板 |
| round_NNNN.yml.template | round | YAML | ~90 | 轮次记录完整模板 |
| final_summary.md.template | final_summary | Markdown | ~406 | 最终总结完整模板 |
| README.md | 使用文档 | Markdown | ~447 | 详细使用指南 |
查看方式：
# 查看特定模板
cat templates/session_metadata.yml.template
# 或在 IDE 中打开
open templates/round_NNNN.yml.template
其他技能 ──────▶ alpha-research-recorder ──────▶ YAML/MD 文件
(生成数据) (引用模板 + 数据合并) (持久化存储)
│
▼
查看模板文件
templates/{type}.template
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer