编码规范 · Vibe-Trading Wiki

每个技能目录必须包含 SKILL.md，并使用 YAML front matter 声明 name、description、category 三个字段。
数据源类技能的接口文档统一放在 references/ 子目录下，按业务主题（资金面、龙虎榜、财务报表等）再分子文件夹。
可执行示例统一放在 scripts/ 目录，文件名以 _example.py 结尾，演示如何调用对应工具或 API。
信号引擎示例统一命名为 example_signal_engine.py，实现 SignalEngine 类并提供 generate(data_map) 方法，返回值为 dict[code, Series]，信号约定为 1/-1/0。
文档内对 references/ 的链接使用 <技能名>/references/... 形式，以便上层 read_file 工具以 skills/ 为根正确解析。
多因子组合引擎通过 ZooSignalEngine.from_zoo(alpha_ids, ...) 构造，并对每个 alpha 做横截面 z-score 标准化后再加权求和，失败 alpha 自动跳过并重分配权重。