workflow-jit-optimization-analysis

Use when 从单个 CinderX benchmark 开始,判定 JIT/解释执行路径并定位优化点。

SKILL.md

GitHub

JIT / Interpreter Case Analysis Workflow

定位

Supporting Workflow:单 benchmark 用例分析分支。端到端任务中由主 Workflow 在 L2 阶段调用,先判定 JIT / 非 JIT,再分流。

Agent 分派

下表按当前证据选择所需阶段,已有匹配产物可复用;Agent 列是职责,可由主 Agent 顺序承担,仅在宿主允许且有独立工作时委派。

阶段 Agent 技能
环境确认 cinderx-environment-verifier cinderx-smoke-check
worker 运行 cinderx-jit-analyst pyperformance-worker-run
进入 JIT 判定 cinderx-jit-analyst cinderx-jit-entry-check
JIT 用例 cinderx-jit-analyst cinderx-hir-dump、cinderx-hir-lir-analyze
解释执行用例 / 非 JIT cinderx-jit-analyst cinderx-interpreter-case-analyze
报告 cinderx-jit-analyst cinderx-optimization-report

Gate

未证明 benchmark 本体进入 CinderX JIT,不进入 HIR/LIR 优化结论。必须先由 cinderx-jit-entry-check 分流:

  • entered_cinderx_jit=true:进入 JIT 用例路径,查看 HIR、排查 deopt、分析 LIR / uop / 机器码和平台差异。
  • entered_cinderx_jit=false 或目标热函数不进入 gate:进入解释执行用例路径,使用 cinderx-interpreter-case-analyze 输出穿刺证据、分阶段平铺表、函数形状表和 gate 策略。

进入 JIT 和 HIR dump 前必须复用 ../using-cpython-optimize/references/pyperformance-env-contract.md,确认真实 worker 继承了目标 PYTHONPATH、JIT flags、hook 和非 debug/diagnostic 口径,并提供 .pth、pyvenv.cfg / include-system-site-packages、cinderx.is_initialized() 等 worker 内 CinderX JIT 证据。