菜单
用于分析分支 PC 对应的 ELF / 函数 / 源码语义，并判断该分支更像是语义上天然难预测，还是更像预测器没有学好。适用于 SPEC06 checkpoint、benchmark ELF、topMispredictsByBranch.csv、单个 branch PC 归因。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | branch-predictability-triage |
| description | 用于分析分支 PC 对应的 ELF / 函数 / 源码语义，并判断该分支更像是语义上天然难预测，还是更像预测器没有学好。适用于 SPEC06 checkpoint、benchmark ELF、topMispredictsByBranch.csv、单个 branch PC 归因。 |
libgcc、glibc、jemalloc）bbl / kernel / 高地址运行时/nfs/home/share/checkpoints_profiles/.../checkpoint-0-0-0/nfs/share/zyy/spec06_rv64gcb_O3_20m_gcc12.2.0-intFpcOff-jeMalloc/...输出一份面向分支预测分析的结论，而不是单纯做地址翻译。最终结论至少要回答：
优先收集以下信息：
topMispredictsByBranch.csv / topMisrateByBranch.csv如果用户只给了 PC，没有给切片名，也可以先按地址区间做粗分类。
先判断 PC 是否属于 benchmark ELF 的装载范围，不要一上来就找源码行。
.text常见表现：
0x10000 左右开始的静态可执行映像llvm-symbolizer / nm 能解析到 benchmark 函数处理策略：
0x8000xxxx常见表现：
bbl / opensbi / kernel / 其他 runtime处理策略：
/nfs/home/share/checkpoints_profiles/<profile>/checkpoint-0-0-0/nfs/home/share/checkpoints_profiles/<profile>/elf常见映射：
gcc_typeck / gcc_scilab / gcc_expr2 / gcc_200 -> elf/gccperlbench_splitmail / perlbench_diffmail -> elf/perlbenchbzip2_* -> elf/bzip2gobmk_* -> elf/gobmkastar_* -> elf/astargamess_* -> elf/gamessmcf -> elf/mcfsjeng -> elf/sjeng/nfs/share/zyy/spec06_rv64gcb_O3_20m_gcc12.2.0-intFpcOff-jeMallocelf/<bench>_base.riscv64-linux-gnu-gcc12.2.0bin/*-bbl-linux-spec.bin注意：
bin/*-bbl-linux-spec.bin 往往不是 ELF，不能直接 addr2lineelf/ 下的 benchmark ELF常见 SPEC2006 源码路径：
/nfs/home/yanyue/tools/cpu2006_analyze/benchspec/CPU2006例如：
400.perlbench/src403.gcc/src429.mcf/src458.sjeng/src优先使用：
filereadelf -Sreadelf -Wlnm -nllvm-symbolizerllvm-objdump -d --line-numbers --sourcerg必要时使用：
gdb -batch -ex 'info line *ADDR'readelf --debug-dump=decodedline不建议默认依赖系统自带 addr2line，因为某些 RISC-V + DWARF 组合下它可能只能给函数名，不能稳定给源码行。
先检查：
file <elf>
readelf -S <elf> | rg 'debug|symtab|strtab'
readelf -Wl <elf>
目标：
debug_info如果 PC 明显不在 LOAD 段范围内：
优先拿到函数名：
llvm-symbolizer --obj=<elf> 0xPC
nm -n <elf> | rg '<附近符号>'
如果只能到函数名，也不要停。函数级 + 本地源码通常已经足够做语义分析。
llvm-objdump -d --line-numbers --source \
--start-address=<pc附近起点> \
--stop-address=<pc附近终点> \
<elf>
重点看：
beqz/bnezblt/bge如果 line table 不够稳定：
示例：
rg -n '^.*\\bpush_slidE\\b\\s*\\(' /nfs/home/yanyue/tools/cpu2006_analyze/benchspec/CPU2006/458.sjeng/src/*.c
这一步的目标不是强行制造“精确某一行”，而是定位到：
if/else/loop每条分支至少归到以下一种：
loop-exitguard / fastpathpredicate-resultmax/min updatepointer/null/empty checkstate-machine / parser / regexruntime/helper结论至少包含：
下面是默认启发式，不是绝对规则。
for/while 循环退出条件npiece / frame / null-checkcaptures、mode、flag 长时间不变常见表现：
如果这类分支 mispredict 很高，更值得怀疑：
if (value > best) 这种“刷新最大值/最小值”类分支load 出来的动态值，再做分类/比较常见表现：
如果这类分支 mispredict 很高，不一定说明 predictor 有明显问题；可能是语义上本来就更难。
类似：
board[target] == npieceboard[target] != frame判断：
类似：
if (move_ordering[i] > best)判断：
类似：
if (!s) goto nope;if (CALLREGEXEC(...))判断：
对每个 branch PC，建议输出以下字段：
pcbenchmarkelfbelongs_to
benchmarkruntime/toolchainbbl/high-addressfunctionsource_candidatesemantic_patternpredictability
easymediumhardwhytage_interpretation
more_like_predictor_issuemore_like_semantically_hardmixed0x8000xxxx 这类地址，先排除 runtime/bbl，再谈源码。libgcc/glibc helper，要明确告诉用户：这不是 benchmark 自身算法分支。回答时优先给出：
由 CPU 性能模拟器建模经验蒸馏而成的行为级建模规范。强调高性能实现、参数化资源模型、细粒度/粗粒度取舍、控制流抽象、复杂度约束和 stats 驱动验证。适用于新增或修改性能模型、把 RTL 机制抽象成模拟器模型、设计参数化微结构模型、决定哪些行为需要细粒度建模、评审 AI 生成的 CPU 性能模拟代码时。
用于编译 XiangShan RTL trace 版 emu、运行 RTL/gem5 的 TAGE trace、并对 gem5 stats/bp.db 与 RTL CondTrace 做共口径聚合比较。适用于 coremark、SPEC checkpoint slice、sjeng_22213 等单切片对拍与首轮分叉定位。
分析香山 MGSC/SC 在前端微测试上的效果。适用于以下场景：(1) 用 off/l_only/g_only/i_only/full 等 A/B profile 批量运行 mgsc_test；(2) 比较不同 profile 下的 topMispredictsByBranch.csv 和 stats.txt；(3) 使用 bp.db 里的 MGSCTRACE 将每个分支的收益/损失归因到具体 SC 表；(4) 决定如何为 Global 或 IMLI 表设计新的测试。
用于比较 XiangShan RTL 与 gem5 BTBTAGE/TAGE 在 allocation、useful、reset 和 update path 上的语义差异，并结合 CI、原始 stats 和 benchmark 结果定位性能变化来源。适用于用户要求检查“和 RTL 是否对齐”、分析 TAGE 相关性能变化、设计最小 A/B 验证时。
用于在本地通过 `gh` 远程触发 OpenXiangShan/GEM5 的 `manual-perf.yml`，并在触发后检查 run 是否正常创建。适用于用户明确要求触发 `manual-perf`、组装 `gh workflow run` 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。
用于从 GitHub Actions 的 gem5 性能 CI 中定位 summary、score.txt 和归档目录，并结合本地 gem5_data_proc 对 spec06/spec17 结果做 weighted score、benchmark 子项对比和通用 stats 归因。适用于用户给出 run URL/run id、commit、workflow run，或要求分析 CI 跑分变化来源时。