| name | transport-regression-keeper |
| description | 管理 Julia_RelaxTime 中 transport / relaxtime 相关改动的回归验证、基线漂移判断与证据汇报。适用于截面、散射率、弛豫时间、输运工作流、固定点基线、smoke/core/full 分层回归。关键词：transport, relaxtime, regression, baseline, drift, tests/regression |
transport-regression-keeper
Purpose
将 transport / relaxtime 改动从“代码改了”收束到“数值影响已定位、测试层已选定、漂移证据已汇报”。
本 Skill 是 baseline-regression-governance 在本仓库 relaxtime 主链路上的窄化版本，优先服务局部改动的快速判断与最小验证闭环。
Apply When
- 修改
src/relaxtime/、src/models/ 中会影响 transport 输出的实现。
- 调整截面、散射率、弛豫时间、输运系数工作流。
- 需要判断该补
unit、integration、regression 还是 validation。
- 需要解释“数值变了”到底是修复、可接受漂移，还是回归退化。
Do Not Use
- 任务核心是建立全仓通用 baseline 治理规则时：转
baseline-regression-governance。
- 任务核心是性能 profiling 或 benchmark 设计时：优先仓库脚本与
benchmark/ 流程。
Hard Rules
- 不得为了让测试通过而先放宽容差。
- 不得无说明更新 baseline 文件。
- 先选测试层，再选命令；不要默认全量跑。
- 若改动触及统一入口或求解链路，必须检查
Models 契约是否仍成立。
Repository Defaults
- 代码入口优先看：
src/models/entrypoints.jl、src/relaxtime/
- 测试层：
tests/unit/relaxtime/tests/integration/relaxtime/tests/regression/relaxtime/tests/validation/relaxtime/
- 常见基线位置：
tests/baselines/relaxtime/
- 常见命令：
julia --project=. -e 'ENV["UNIT_PROFILE"]="smoke"; include("tests/unit/runtests.jl")'julia --project=. -e 'ENV["INTEGRATION_PROFILE"]="smoke"; include("tests/integration/runtests.jl")'julia --project=. -e 'ENV["REGRESSION_PROFILE"]="smoke"; include("tests/regression/runtests.jl")'
Standard Workflow
- Map impact
- 记录改动模块、影响输出量、可能波及的脚本或入口。
- 区分“局部公式变动”“工作流拼装变动”“统一入口变动”。
- Choose the narrowest sufficient test layer
- 公式或 helper 级：先
unit
- 跨模块链路：补
integration
- 固定点数值承诺：补
regression
- 对外物理参考或文献映射：补
validation
- Run focused verification
- 优先单文件或 selector 跑法。
- 只有在局部结果不足以判断风险时，才扩大到 profile 级测试。
- Judge drift
- 对比 baseline、既有测试预期或固定点输出。
- 先判断漂移来源，再决定是否允许更新基线。
- Summarize evidence
- 说明改动影响面、执行命令、变化点位、容差判断、残余风险。
Decision Heuristics
- 改动只影响局部数值 helper，但调用链广：先跑对应
unit，再选 1 个最短 integration smoke。
- 改动影响 CSV 输出、固定点表或回归断言：默认补或运行
regression。
- 改动同时影响
legacy 与 Models 桥接：检查现有 bridge smoke，不要只看单边实现。
Output Contract
汇报至少包含：
- 改动模块
- 选择的测试层与理由
- 实际执行命令
- 是否观察到数值漂移
- 漂移是否在现有容差/物理预期内
- 是否需要更新 baseline、文档或后续 validation
