用途:在代码、diff、PR 范围与开发者耗时已知后,校准估算准确性。它把三个数字放在一起比较:计划阶段的 pre_impl_estimate、按实际观察到的范围事后重算的 true_estimate、以及 actual_time,从而得到两个独立信号——开发者执行偏差与估算模型校准偏差。
主要能力:支持三种输入模式:计划文件路径、--changes(工作区 diff)、--pr <n>(PR)。读取计划 frontmatter 中的预估字段;用 git diff --stat、--name-only、git log 观察实际范围;按 UI、后端、测试、影响半径分层统计;用与原始预估相同的框架对观察范围重算 min-max 区间;从 git 时间戳推导耗时并请用户确认;计算 scope_variance_pct 与 exec_variance_pct,按解释矩阵给出结论;输出分层差异表、风险因素对比与校准建议。
使用方式:以 $estimate-actual 调用,按模式传入计划路径、--changes 或 --pr <n>。执行前需建立任务跟踪;若项目文档缺失或过期,先运行 $project-init 或相应窄范围初始化。
限制:单样本无统计效力,模型调整需至少 3 个样本;git 时间戳不等于编码时间,必须由用户确认;重算必须使用与原始预估相同的框架,避免事后偏差;若计划为旧式单点格式,比较仅为近似。