流水线命令
/research-analysis
/research-analysis——按照预注册计划分析原始数据:计划内的检验、带置信区间的效应量、稳健性检查,以及已披露的偏离。
角色: 首席研究者(分析) 流水线位置: 链路中段
按照预注册计划分析原始数据——运行计划内的统计检验,报告带置信区间的效应量(而非仅有 p 值),在适用之处应用多重比较校正,运行稳健性/敏感性检查,并披露与预注册的每一处偏离。
规范调用
/research-analysis带参数:
/research-analysis [path/to/research-suite/]输入
实验阶段在宿主自然位置记录的原始数据,外加 _inputs/preregistration.md(冻结的分析计划)。
输出
_outputs/analysis.md(带效应量和置信区间的预注册检验、多重比较校正、稳健性检查,以及已披露的偏离)+宿主自然位置的图表/表格。
下游
/research-paper(下游消费者)
工作流阶段
该命令遵循标准的 /research 流水线工作流:
- 加载上下文——读取原始数据和预注册。
- 验证序列门——确认实验输出已存在;否则以
Blocked: run /research-experiment first停止。 - 分析——运行预注册的检验;报告效应量+置信区间;对多重比较进行校正;运行稳健性/敏感性检查。
- 披露偏离——记录与预注册计划的每一处偏差。
- 更新交接清单——记录分析路径和图表/表格。
- 发出分析——
_outputs/analysis.md+图表/表格。
严谨性强制底线
随机结果以跨重复的最佳、平均、中位数、标准差和最差报告,并附收敛曲线和分布图。比较使用非参数检验——两两之间用配对符号秩检验,跨方法用带事后校正的总体秩检验——并报告随机优越性效应量和一张临界差异图。一个结果只有在清越晋级门时才进入论文:它令人信服且显著地胜过其对照者,且该清越被记入一份可审计的执行手册。
失败模式
| 症状 | 原因 | 恢复 |
|---|---|---|
| Blocked: run /research-experiment first | 没有原始数据 | 运行 /research-experiment 以产出数据+日志 |
| 报告了 p 值但没有效应量 | 统计报告不完整 | 报告效应量+置信区间 |
| 未披露的分析偏离 | 计划被悄然偏离 | 披露相对于预注册的偏离 |
示例
# 按照预注册计划分析原始数据
/research-analysis path/to/research-suite/