用途:科研流水线第 5 节点,把 idea-critique 放行的 idea 与数据可行性拆成能执行、能写进论文、能复现的研究方案,产出 question/estimand、实验矩阵与预注册包。
主要能力:冻结目标链(question→estimand→hypothesis→primary endpoint→analysis family→falsifier→action);填实验矩阵四要素(假设→变量→指标→停止条件);对照公平与可证伪 critical 门;消融隔离与统计功效 warn;失败树/guardrail 门;预注册包与可复现清单;派生评测集规格;完整计划包交付门。
使用方式:脚本位于 scripts/。对照公平/可证伪门:python scripts/plan_gate.py --spec plan_spec.json --report plan_findings.json;目标链:python scripts/target_chain.py --input templates/target-chain.example.json;失败树:python scripts/failure_tree_gate.py --input failure-tree.json --as-of 2026-07-05 --json-out .light/failure_tree_report.json;矩阵自查:python scripts/plan_lint.py --file experiments/experiment_matrix.md;功效:python scripts/power_check.py --effect 0.5 --n 5;交付门:python scripts/research_package_gate.py --manifest plan_package.json --final --json-out research_package_report.json。Windows 先 set PYTHONUTF8=1。
适用场景:idea 通过审查要落地;设计实验、消融、对比、敏感性、泛化、鲁棒性、统计显著性、种子与算力预算、复现论文;怀疑 baseline 放水或假设不可证伪;下游 result-analysis 判结果不支撑假设(7→5)或 review-rebuttal 拒稿(13→5)时回炉重规划。
限制:plan_lint 为启发式 linter,不证明对照绝对公平或假设绝对可证伪;fair_baseline 依赖声明,等量调参是否真等量需人核;falsifiable 只查有无反证条件;power_check 仅适用双独立样本均值近似,复杂设计需 simulation/MDE;不内置实验追踪/版本工具,仅给选型与命令;预注册提交需用户账号与不可逆确认,未提交标 DRAFT。