| name | momentum-strategy-research |
| description | Momentum 工程的策略研究执行规范（ETF/场外基金/期货组合策略）。在 research.html 或 analysis/ 引擎里新增或修改任何策略段、基准、NAV、归因、图表/报表时使用。 触发词："新增策略"、"修改策略研究"、"加一个策略段"、"strategy research"、 "research.html 策略"、"基准 NAV"、"baseline 图表"、"次日计划"、"固定策略库/MIX"。 本技能是 AGENTS.md 相关强约束条款的可执行入口，不取代条款本身。
|
Momentum 策略研究技能
权威定义以仓库根目录 AGENTS.md（§ Maintenance and evolves）与 SOUL.md 为准。
本技能把这些强约束转成"何时触发 + 执行步骤 + 检查清单 + 交付证据"。冲突时以
SOUL.md / AGENTS.md 为准。
何时使用
- 在
src/etf_momentum/web/research.html 新增或修改任何策略研究段。
- 在
src/etf_momentum/analysis/ 修改策略引擎（rotation.py / trend.py /
bt_trend.py / baseline.py / calendar_timing_strategy.py 等）。
- 改动基准、NAV、执行时点、归因、图表/报表、参数持久化、分组绑定、MIX。
关键文件
- 引擎：
src/etf_momentum/analysis/rotation.py、trend.py、bt_trend.py、
baseline.py（含 hfq_close_buy_hold_returns、
hfq_close_daily_equal_weight_returns）、calendar_timing_strategy.py。
- 前端：
src/etf_momentum/web/research.html、共享样式 web/terminal.css。
- 路由：
src/etf_momentum/api/routes.py。
执行步骤（规划 → 拆解 → 执行 → 审查 → 复盘）
- 规划：用
brainstorming 明确策略语义（候选池/分组、执行时点、成本、基准）。
- 拆解：列出受影响引擎、API、前端段、测试。
- 执行：实现引擎 → API（Pydantic 模型）→ research.html 段 → 测试。
- 审查：跑下方检查清单 +
code-review。
- 复盘：记录新出现的语义到
AGENTS.md，必要时用 self-improving。
检查清单（交付前逐条核对）
研究段三件套（research.html 每个策略段必须同时具备）：
参数与分组：
基准 NAV（始终用 hfq close；区分场景）：
执行时点 NAV（执行日，pre/post-trade 权重显式切换）：
引擎一致性：
Baseline 图表/报表集（17 项，benchmark 部分仅在有基准时显示）：
API 合同测试：
交付证据（写入回复/PR）
公式核对项、检查的 scope、跑过的测试、基准/执行时点语义说明、已知非可加语义。
