一键在 Manus 中运行任何 Skill

tage-trace-workflow

星标149

分支81

更新时间2026年5月20日 08:24

用于编译 XiangShan RTL trace 版 emu、运行 RTL/gem5 的 TAGE trace、并对 gem5 stats/bp.db 与 RTL CondTrace 做共口径聚合比较。适用于 coremark、SPEC checkpoint slice、sjeng_22213 等单切片对拍与首轮分叉定位。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

OpenXiangShan

OpenXiangShan/GEM5

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

TAGE Trace Workflow

这个 skill 只做三件事：

编译能落 CondTrace_* / microTageTrace 的 RTL emu
运行 gem5 / RTL 的 trace，并固定到相同 instruction window
用脚本把 gem5 stats.txt / bp.db 和 RTL sqlite db 聚成同口径摘要

1. RTL 编译

在 XiangShan 目录下使用：

make clean
make emu \
  EMU_THREADS=8 \
  EMU_TRACE=fst \
  WITH_DRAMSIM3=1 \
  WITH_CONSTANTIN=1 \
  WITH_CHISELDB=1 \
  WITH_ROLLINGDB=1 \
  CONFIG=CHIFrontendDebugConfig \
  -j64

编完先做两个 sanity check：

rg -n "CHIFrontendDebugConfig" build/time.log
rg -n "CondTrace_0_write|BpuPredictionTrace_write|microTageTrace_write" build/chisel_db.cpp

如果 CondTrace_0_write() 仍然是空桩，就不要继续跑 trace。

2. RTL 运行

关键点：

--dump-select-db 必须是空格分隔的精确表名
优先只打 CondTrace_0..7，需要更细再加 microTageTrace
尽量先用 -I 把窗口限制住

示例：

./build/emu \
  --no-diff \
  -I 200000 \
  -i /nfs/home/share/gem5_ci/checkpoints/coremark-riscv64-xs.bin \
  --dump-db \
  --dump-select-db "CondTrace_0 CondTrace_1 CondTrace_2 CondTrace_3 CondTrace_4 CondTrace_5 CondTrace_6 CondTrace_7 microTageTrace" \
  > /tmp/coremark_tage.out 2>&1

对 .zstd GCPT slice，直接把路径传给 -i 即可。

3. gem5 运行

kmhv3.py 需要 diff 环境变量：

export GCBV_REF_SO=/nfs/home/yanyue/tools/gem5-tools/ref-h/riscv64-nemu-interpreter-so

示例：

./build/RISCV/gem5.opt \
  --outdir /tmp/debug/coremark_200k_basic \
  ./configs/example/kmhv3.py \
  -I 200000 \
  --generic-rv-cpt /nfs/home/share/gem5_ci/checkpoints/coremark-riscv64-xs.bin \
  --raw-cpt \
  --enable-bp-db tage basic

说明：

tage 会生成 TAGEMISSTRACE
basic 会额外生成 BPTRACE
先保证 gem5 和 RTL 用同一个 -I

4. 分析顺序

先看计数器，再看 trace：

gem5 stats.txt 中的 allocateNeeded / allocateSkipHighestProvider / resolveBranchHasProvider / resolveBranchUseProvider / resolveBranchHasAlt / resolveBranchUseAltTable / resolveBranchUseBaseTable / mispredictBranch*
RTL CondTrace_* 聚出来的同口径总量
再看热点 branch 的 provider/alt/useAlt/alloc

注意两个口径坑：

TAGEMISSTRACE.useAlt 表示 pred.useAlt，不等于 stats 里的 resolveBranchUseAltTable
要和 stats 对齐时，应该优先看 useAlt && altFound

5. 脚本

RTL 聚合： [scripts/aggregate_rtl_condtrace.py](scripts/aggregate_rtl_condtrace.py)
gem5/RTL 对拍： [scripts/compare_gem5_rtl_tage.py](scripts/compare_gem5_rtl_tage.py)
热点 branch 画像对拍： [scripts/compare_branch_profiles.py](scripts/compare_branch_profiles.py)
单个 branch 的顶层事件序列粗对拍： [scripts/compare_branch_event_sequences.py](scripts/compare_branch_event_sequences.py)
高表 alloc 生命周期分析： [scripts/analyze_alloc_lifecycle.py](scripts/analyze_alloc_lifecycle.py)
prediction-time PHR contributor 归类： [scripts/analyze_phist_contributor.py](scripts/analyze_phist_contributor.py)
RTL BpuTrainTrace 的 self / sibling / none block-level 贡献者归类： [scripts/analyze_rtl_train_contributor.py](scripts/analyze_rtl_train_contributor.py)

常用命令：

python3 docs/codex-skills/tage-trace-workflow/scripts/aggregate_rtl_condtrace.py \
  --rtl-db /path/to/rtl.db --top 12

python3 docs/codex-skills/tage-trace-workflow/scripts/compare_gem5_rtl_tage.py \
  --gem5-stats /tmp/debug/coremark_200k_basic/stats.txt \
  --gem5-bpdb /tmp/debug/coremark_200k_basic/bp.db \
  --gem5-top-branch-csv /tmp/debug/coremark_200k_basic/topMispredictsByBranch.csv \
  --rtl-db /nfs/home/yanyue/workspace/xs-env/XiangShan/build/2026-03-25-13-31-09.db \
  --top 12

同仓库更多 Skills

同仓库

cpu-performance-modeling

OpenXiangShan/GEM5

由 CPU 性能模拟器建模经验蒸馏而成的行为级建模规范。强调高性能实现、参数化资源模型、细粒度/粗粒度取舍、控制流抽象、复杂度约束和 stats 驱动验证。适用于新增或修改性能模型、把 RTL 机制抽象成模拟器模型、设计参数化微结构模型、决定哪些行为需要细粒度建模、评审 AI 生成的 CPU 性能模拟代码时。

2026-05-28149

mgsc-table-probe

OpenXiangShan/GEM5

分析香山 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 表设计新的测试。

2026-04-27149

rtl-tage-alignment

OpenXiangShan/GEM5

用于比较 XiangShan RTL 与 gem5 BTBTAGE/TAGE 在 allocation、useful、reset 和 update path 上的语义差异，并结合 CI、原始 stats 和 benchmark 结果定位性能变化来源。适用于用户要求检查“和 RTL 是否对齐”、分析 TAGE 相关性能变化、设计最小 A/B 验证时。

2026-04-27149

gem5-manual-perf-trigger

OpenXiangShan/GEM5

用于在本地通过 `gh` 远程触发 OpenXiangShan/GEM5 的 `manual-perf.yml`，并在触发后检查 run 是否正常创建。适用于用户明确要求触发 `manual-perf`、组装 `gh workflow run` 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。

2026-03-20149

ci-perf-analysis

OpenXiangShan/GEM5

用于从 GitHub Actions 的 gem5 性能 CI 中定位 summary、score.txt 和归档目录，并结合本地 gem5_data_proc 对 spec06/spec17 结果做 weighted score、benchmark 子项对比和通用 stats 归因。适用于用户给出 run URL/run id、commit、workflow run，或要求分析 CI 跑分变化来源时。

2026-03-16149

branch-predictability-triage

OpenXiangShan/GEM5

用于分析分支 PC 对应的 ELF / 函数 / 源码语义，并判断该分支更像是语义上天然难预测，还是更像预测器没有学好。适用于 SPEC06 checkpoint、benchmark ELF、topMispredictsByBranch.csv、单个 branch PC 归因。

2026-03-05149

name	tage-trace-workflow
description	用于编译 XiangShan RTL trace 版 emu、运行 RTL/gem5 的 TAGE trace、并对 gem5 stats/bp.db 与 RTL CondTrace 做共口径聚合比较。适用于 coremark、SPEC checkpoint slice、sjeng_22213 等单切片对拍与首轮分叉定位。

TAGE Trace Workflow

这个 skill 只做三件事：

编译能落 CondTrace_* / microTageTrace 的 RTL emu
运行 gem5 / RTL 的 trace，并固定到相同 instruction window
用脚本把 gem5 stats.txt / bp.db 和 RTL sqlite db 聚成同口径摘要

1. RTL 编译

在 XiangShan 目录下使用：

make clean
make emu \
  EMU_THREADS=8 \
  EMU_TRACE=fst \
  WITH_DRAMSIM3=1 \
  WITH_CONSTANTIN=1 \
  WITH_CHISELDB=1 \
  WITH_ROLLINGDB=1 \
  CONFIG=CHIFrontendDebugConfig \
  -j64

编完先做两个 sanity check：

rg -n "CHIFrontendDebugConfig" build/time.log
rg -n "CondTrace_0_write|BpuPredictionTrace_write|microTageTrace_write" build/chisel_db.cpp

如果 CondTrace_0_write() 仍然是空桩，就不要继续跑 trace。

2. RTL 运行

关键点：

--dump-select-db 必须是空格分隔的精确表名
优先只打 CondTrace_0..7，需要更细再加 microTageTrace
尽量先用 -I 把窗口限制住

示例：

./build/emu \
  --no-diff \
  -I 200000 \
  -i /nfs/home/share/gem5_ci/checkpoints/coremark-riscv64-xs.bin \
  --dump-db \
  --dump-select-db "CondTrace_0 CondTrace_1 CondTrace_2 CondTrace_3 CondTrace_4 CondTrace_5 CondTrace_6 CondTrace_7 microTageTrace" \
  > /tmp/coremark_tage.out 2>&1

对 .zstd GCPT slice，直接把路径传给 -i 即可。

3. gem5 运行

kmhv3.py 需要 diff 环境变量：

export GCBV_REF_SO=/nfs/home/yanyue/tools/gem5-tools/ref-h/riscv64-nemu-interpreter-so

示例：

./build/RISCV/gem5.opt \
  --outdir /tmp/debug/coremark_200k_basic \
  ./configs/example/kmhv3.py \
  -I 200000 \
  --generic-rv-cpt /nfs/home/share/gem5_ci/checkpoints/coremark-riscv64-xs.bin \
  --raw-cpt \
  --enable-bp-db tage basic

说明：

tage 会生成 TAGEMISSTRACE
basic 会额外生成 BPTRACE
先保证 gem5 和 RTL 用同一个 -I

4. 分析顺序

先看计数器，再看 trace：

gem5 stats.txt 中的 allocateNeeded / allocateSkipHighestProvider / resolveBranchHasProvider / resolveBranchUseProvider / resolveBranchHasAlt / resolveBranchUseAltTable / resolveBranchUseBaseTable / mispredictBranch*
RTL CondTrace_* 聚出来的同口径总量
再看热点 branch 的 provider/alt/useAlt/alloc

注意两个口径坑：

TAGEMISSTRACE.useAlt 表示 pred.useAlt，不等于 stats 里的 resolveBranchUseAltTable
要和 stats 对齐时，应该优先看 useAlt && altFound

5. 脚本

RTL 聚合： [scripts/aggregate_rtl_condtrace.py](scripts/aggregate_rtl_condtrace.py)
gem5/RTL 对拍： [scripts/compare_gem5_rtl_tage.py](scripts/compare_gem5_rtl_tage.py)
热点 branch 画像对拍： [scripts/compare_branch_profiles.py](scripts/compare_branch_profiles.py)
单个 branch 的顶层事件序列粗对拍： [scripts/compare_branch_event_sequences.py](scripts/compare_branch_event_sequences.py)
高表 alloc 生命周期分析： [scripts/analyze_alloc_lifecycle.py](scripts/analyze_alloc_lifecycle.py)
prediction-time PHR contributor 归类： [scripts/analyze_phist_contributor.py](scripts/analyze_phist_contributor.py)
RTL BpuTrainTrace 的 self / sibling / none block-level 贡献者归类： [scripts/analyze_rtl_train_contributor.py](scripts/analyze_rtl_train_contributor.py)

常用命令：

python3 docs/codex-skills/tage-trace-workflow/scripts/aggregate_rtl_condtrace.py \
  --rtl-db /path/to/rtl.db --top 12

python3 docs/codex-skills/tage-trace-workflow/scripts/compare_gem5_rtl_tage.py \
  --gem5-stats /tmp/debug/coremark_200k_basic/stats.txt \
  --gem5-bpdb /tmp/debug/coremark_200k_basic/bp.db \
  --gem5-top-branch-csv /tmp/debug/coremark_200k_basic/topMispredictsByBranch.csv \
  --rtl-db /nfs/home/yanyue/workspace/xs-env/XiangShan/build/2026-03-25-13-31-09.db \
  --top 12