ota-equity-factor-screening-brief

name	ota_equity_factor_screening_brief
description	解读 tool_screen_equity_factors / tool_finalize_screening_nightly：universe、因子、success/quality_score/degraded/config_hash、申万映射与熔断；与旧 tool_quantitative_screening 的迁移说明。

OTA：tool_screen_equity_factors 多因子筛选口径

何时使用

• 调用或解释 tool_screen_equity_factors（主实现：openclaw-data-china-stock → plugins/analysis/equity_factor_screening.py，助手经 plugins/analysis/equity_factor_screening.py 动态加载）。
• 夜盘收尾、落盘与观察池：tool_finalize_screening_nightly（src/screening_ops.py），门禁见 config/data_quality_policy.yaml → screening 与 src/screening_quality_gate.py。
• 用户问「震荡选股」「A 股多因子」「申万行业动量」「观察池」。

与旧工具的差异（迁移）

旧	新
tool_quantitative_screening（candidates、status success/error）	tool_screen_equity_factors（success 布尔、universe、factors、regime_hint）
动量/波动/流动性/估值四因子	默认 reversal_5d / fund_flow_3d / sector_momentum_5d（震荡模板权重在插件内）
无统一质量分	返回 quality_score、config_hash、sw_mapping（申万映射覆盖率）

旧规程 Skill ota_quantitative_screening_brief 已 deprecated，请改用本 Skill。

返回契约（要点）

• 成功：success: true，data: 列表，元素含 symbol / score / factors。
• 失败：success: false，message。
• 必看：quality_score、degraded、degraded_notes、elapsed_ms、plugin_version。

熔断与观察池

• config/weekly_calibration.json：regime: pause 时收尾工具跳过观察池写入。
• data/screening/emergency_pause.json：由 tool_set_screening_emergency_pause 或工作流 screening_emergency_stop.yaml 维护。
• 审计落盘：data/screening/YYYY-MM-DD.json（含完整 screening 副本与门禁结果）。

权威路径

• 插件：openclaw-data-china-stock/plugins/analysis/equity_factor_screening.py
• 助手收尾：etf-options-ai-assistant/src/screening_ops.py
• Manifest：config/tools_manifest.yaml → tool_screen_equity_factors、tool_finalize_screening_nightly

证据表（可复现）

字段	证据来源
success / quality_score / degraded / config_hash	原始 tool_screen_equity_factors 或等价别名 tool_screen_by_factors 返回 JSON（两者信封一致）
夜盘落盘路径	tool_finalize_screening_nightly 返回中的 artifact_path
估值/代码口径（若叙事涉及 PE/PB 等）	tool_l4_valuation_context / tool_l4_pe_ttm_percentile 或 Chart /api/semantic/l4_* 映射的落盘视图

叙事中不可出现「正文独有的数值」却无任何工具 JSON 与之对应。