| name | qros-csf-signal-ready-review |
| description | Codex review skill for CSF Signal Ready stage verification. |
CSF Signal Ready 审查
用途
将已冻结的截面研究语义实例化为可比较、可复现的因子面板合同
Runtime Stage Admission
开始本 stage-specific review 工作前，必须先在当前 research repo 运行：
./.qros/bin/qros-check-stage-entry --stage csf_signal_ready --lane review
若命令失败，必须停止；不得继续 review，不得启动 reviewer，不得运行 qros-review-cycle prepare。按输出中的 qros-research-session --lineage-id ... 恢复 runtime state 后再重进本 skill。
共享审查协议
执行本 stage review 前，必须先阅读并遵守 docs/guides/qros-review-shared-protocol.md。
该共享审查协议统一定义：
- adversarial reviewer-agent 合同
adversarial_review_request.yaml / adversarial_review_result.yaml / closure artifacts 要求FIX_REQUIRED 与 closure-ready adverse verdict 语义- 只有 closure-ready 后才允许运行
./.qros/bin/qros-review
独立 reviewer 子代理要求
- 本 skill 是用户显式进入的 stage-specific review 入口；不再要求你手动再开一个独立 review session
- 进入本 skill 后，必须在当前会话里用
spawn_agent 拉起独立 reviewer 子代理，且 fork_context 必须是 false
- 先用一个最小初始化消息创建 reviewer 子代理，要求它先等待 binding / handoff，不要在 receipt 写出前擅自写文件
- reviewer 子代理创建后，主线程优先运行
./.qros/bin/qros-review-cycle prepare --reviewer-agent-id <child_agent_id> --reviewer-id <reviewer_identity> --reviewer-session-id <child_agent_id> --host codex
qros-review-cycle prepare 负责注册 active review cycle，写出 review/request/* 与 reviewer_receipt.yaml，并输出 reviewer handoff prompt 与 closer command- 主线程随后必须用
send_input 把 request / handoff manifest / stage-specific gate 交给 reviewer 子代理
- reviewer 子代理只允许读取
review/request/* 与 author/formal/*
- reviewer 子代理只允许写入
review/result/reviewer_findings.raw.yaml
- reviewer 子代理不得修改
author/formal/*
- reviewer 子代理完成后，主线程必须运行
./.qros/bin/qros-review；它负责 canonical result、audit 与 closure
主线程交接前提
- 主线程在发起 review 之前必须先完成
review-ready 自查，不要把 reviewer 当成第一轮 artifact completeness checker
- 主线程交给 reviewer 子代理的 scope 必须是当前 author outputs，而不是旧 request、旧 digest 或修复前的 stale artifacts
- handoff 必须明确这轮声称已完成的 outputs、希望 reviewer 验证的 formal gate、已知限制 / 未决假设，而不是盲交 reviewer
- handoff 必须与
launcher_review_ready_status、launcher_checked_artifact_paths、launcher_checked_provenance_paths、launcher_handoff_context_paths 一致
- 如果上一轮 verdict 是
FIX_REQUIRED，主线程必须先读取 review/result/adversarial_review_result.yaml 与 review/result/review_findings.yaml，只在 author lane 修复，再显式重新进入本 stage review skill
- 如果你发现 handoff scope 过期、必需输出缺失、machine-readable artifacts 只是 placeholder，应该明确写成 blocking findings /
FIX_REQUIRED，而不是替主线程猜测或补齐上下文
- reviewer 不替 runtime 重定义字段；artifact shape 以
contracts/artifacts/csf_signal_ready_artifacts.yaml 与 deterministic preflight 为准
- 进入 reviewer lane 前必须已经运行
qros-validate-stage --stage csf_signal_ready，并通过 deterministic preflight
- preflight 中的
ARTIFACT-CONTRACT-001 与 CSF-SIGNAL-SEMANTIC-001 都是 review 前阻断项
- preflight 覆盖 artifact contract validation、semantic validation 与 upstream binding validation；reviewer 仍需审查机制和残留风险
共用输入
contracts/stages/workflow_stage_gates.yamlcontracts/review/review_checklist_master.yamlartifact_catalog.mdfield_dictionary.md or *_fields.mdrun_manifest.json
必需输入
必需输入:
- 已冻结的 csf_data_ready 输出
- 因子表达式或多因子组合草案
- 因子方向与时间语义提案
必需输出
必需输出:
- factor_panel.parquet
- factor_manifest.yaml
- component_factor_manifest.yaml
- route_inheritance_contract.yaml
- factor_field_dictionary.md
- factor_coverage_report.parquet
- factor_group_context.parquet
- factor_contract.md
- csf_signal_ready_gate_decision.md
- run_manifest.json
- artifact_catalog.md
- field_dictionary.md
正式门禁
阶段：CSF Signal Ready
正式门禁摘要：
必须全部满足：
- factor_id / factor_version / factor_direction 已冻结
- factor_panel 可唯一表示同一时点不同资产的因子值
- 所有输入字段都来自 csf_data_ready
- 多因子组合公式是确定性的
- 缺失值、coverage、eligibility 传递规则已写清
- 因子方向明确，不允许到 test/backtest 再解释
以下任一情况都不得出现：
- 因子定义依赖 train/test/backtest 结果回写
- factor_panel 无法稳定重建
- 多因子组合权重在后续阶段才学习
- factor_direction 不清楚
- eligibility 与 factor computation 混成一团
- test 才知道的 quantile / cutoff 被偷写回 signal
审查清单
阶段检查项：
- [blocking] factor_role、factor_structure、portfolio_expression、neutralization_policy 均来自 mandate 冻结；non-standalone 具备 target_strategy_reference，group_neutral 具备 group_taxonomy_reference
- [blocking] factor_id、factor_version、factor_direction 已冻结
- [blocking] factor_panel 以统一面板主键唯一表示同一时点不同资产的因子值
- [blocking] raw_factor_fields、derived_factor_fields 和 final_score_field 已写清
- [blocking] 多因子组合公式是确定性的，不依赖 train-learned weights
- [blocking] 缺失值策略、coverage contract 和 eligibility 传递规则已冻结
- [blocking] 若需要组内排序或组中性化，factor group context 已冻结
- [blocking] 不得把过滤器语义伪装成独立 alpha 语义
- [blocking] factor_direction、panel_primary_key、final_score_field 与 score_combination_formula 均已冻结，且不允许保持空缺
- [blocking] factor_panel 非空，且在 (date, asset) 上唯一
仅审计项
仅审计项:
本阶段 Rollback 规则
- 默认 rollback stage：csf_signal_ready
- 允许修改：澄清文档表述
- 允许修改：补全缺失 artifact
- 允许修改：修正因子方向与组合公式
- 以下情况必须开 child lineage：因子结构从截面改为时序
- 以下情况必须开 child lineage：因子角色发生实质变化
本阶段下游权限
- 可进入下游阶段：csf_train_freeze
- 下游可直接消费的冻结产物：factor_panel.parquet
- 下游可直接消费的冻结产物：factor_manifest.yaml
- 下游可直接消费的冻结产物：factor_coverage_report.parquet
- 下游不得消费 / 重估：未冻结的 train 尺子
执行顺序
- 在当前会话中完成
review-ready 自查，并确认 handoff 与 launcher 字段一致
- 用
spawn_agent 创建独立 reviewer 子代理
- 运行
./.qros/bin/qros-review-cycle prepare 写出 active request / handoff / receipt，并复用输出的 reviewer handoff prompt
- 用
send_input 向 reviewer 子代理交付 request / handoff 与本 stage 的 formal gate
- 等待 reviewer 子代理只写
review/result/reviewer_findings.raw.yaml
- 运行
./.qros/bin/qros-review 完成 canonical result、audit 与 closure
- 再用本 skill 的 formal gate、checklist 和 audit-only 规则解释 stage-specific verdict
- 若 verdict 需要 rollback 或 downstream 解释，以本文件的 stage-specific 规则为准
