By name: workflow-pyperformance-regression description: Use when 需要 L3/L4 正式 pyperformance、CPython/CinderX A/B 对比、提交前后性能回归、speedup.json 或报告级性能确认。
pyperformance Regression Workflow
定位
Supporting Workflow：正式性能验证分支。由主 Workflow 在 L3/L4 阶段调用。
Agent 分派
| 阶段 | Agent | 技能 |
|---|---|---|
| 环境确认 | cinderx-environment-verifier |
cinderx-env-validate |
| A/B slot | cinderx-orchestrator |
cinderx-ab-run-slot |
| baseline | pyperformance-baseline-runner |
pyperformance-suite-run |
| candidate | pyperformance-candidate-runner |
pyperformance-suite-run |
| 分析 | pyperformance-benchmark-analyst |
pyperformance-result-compare |
| 报告 | pyperformance-benchmark-analyst |
cinderx-optimization-report |
Gate
baseline/candidate 必须说明口径 baseline 和提交 baseline。并行前 CPU set、绑核、结果目录、容器线不冲突。
正式 A/B 前必须引用 ../using-cpython-optimize/references/baseline-source-contract.md，确认 baseline source 是 baseline_source_verified。远程环境或容器可用只能证明执行环境可跑，不能自动把远程 workspace 当前源码当 baseline；若返回 baseline_source_untrusted，先让用户指定 baseline、创建干净 worktree 或重建 cpython-baseline。
正式运行前必须让 baseline/candidate runner 共同引用 ../using-cpython-optimize/references/pyperformance-affinity-guidance.md，确认用户命令里的 --affinity 已按当前 nproc / lscpu / taskset -pc $$ / 容器 cpuset 映射到可用 CPU；不能逐字照抄不可用高核号。
正式运行前必须让 baseline/candidate runner 共同引用 ../using-cpython-optimize/references/pyperformance-env-contract.md，确认 --inherit-environ、driver/worker env、helper 变量和唯一差异轴一致；CinderX JIT 口径还要确认 worker 可见的 .pth、pyvenv.cfg / include-system-site-packages、cinderx.is_initialized() 等证据。环境契约缺失时不能进入正式 pyperf compare_to 结论。