القائمة
仅做 BPU 计数器提取与批量汇总（机器可读 JSON/CSV）。配置文件只需要写原始 stats 计数器名。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | frontend-pmu-analysis |
| description | 仅做 BPU 计数器提取与批量汇总（机器可读 JSON/CSV）。配置文件只需要写原始 stats 计数器名。 |
stats.txt。stats.txt 同目录的topMispredictsByBranch.csv, 记录了哪些分支被错误预测很多。--enable-bp-db tage 来打开tage 的trace db 分析。.codex/skills/frontend-pmu-analysis/scripts/analyze_bpu_counters.py.codex/skills/frontend-pmu-analysis/configs/bpu_counters.txtpython3 .codex/skills/frontend-pmu-analysis/scripts/analyze_bpu_counters.py \
--debug-dir /tmp/debug/tage-new8
指定自定义计数器文件：
python3 .codex/skills/frontend-pmu-analysis/scripts/analyze_bpu_counters.py \
--debug-dir /tmp/debug/tage-new8 \
--counters-file /path/to/my_counters.txt
bpu_counters_summary.jsonbpu_counters_summary.csv输出字段只包含：
values（命中的计数器和值）missing（缺失计数器）errors（解析错误）推荐 txt（每行一个）：
system.cpu.ipc
system.cpu.commit.branchMispredicts
system.cpu.commit.branches
如果要批量分析更多计数器，也可以添加到configs 的txt 中
也支持：
yaml：counters: [ ... ] 或直接列表csv：第一列或 counter 列为计数器名由 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 跑分变化来源时。