菜单
分析香山 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 表设计新的测试。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
由 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 等单切片对拍与首轮分叉定位。
用于比较 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 跑分变化来源时。
用于分析分支 PC 对应的 ELF / 函数 / 源码语义，并判断该分支更像是语义上天然难预测，还是更像预测器没有学好。适用于 SPEC06 checkpoint、benchmark ELF、topMispredictsByBranch.csv、单个 branch PC 归因。
| name | mgsc-table-probe |
| description | 分析香山 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 表设计新的测试。 |
运行标准化的 SC 表 A/B 实验，并产出分支级别的归因结果：
summary.csv：case 级别的 off 与各 profile 的 delta 汇总。branch_delta.csv：分支级别的误预测 delta，以及 SC 修复/伤害与表贡献比例。report.md：便于人工快速阅读的排序报告。这个 skill 的目标是快速迭代 SC 测试质量，而不是做完整的性能调优。
mgsc_test 二进制执行 probe：python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
--outdir debug/sc_table_probe \
--profiles off,l_only,g_only,i_only,full \
--max-workers 4
python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
--outdir debug/sc_table_probe_smoke \
--tests fp_sc_alias_pair \
--profiles off,g_only,i_only \
--max-workers 1
python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
--outdir debug/sc_table_probe \
--profiles off,l_only,g_only,i_only,full \
--skip-run
off。full 之前，先加入单表 profile（如 g_only、i_only）。summary.csv 中，优先关注满足 condMiss_delta < 0 且 mgsc_net_use > 0 的 case。branch_delta.csv 中，优先关注满足以下条件的行：
delta_misp < 0focus_decisive_ratio 较高focus_agree_fix_ratio 较高g_only 很少带来改善，且 focus_decisive_ratio(g) 很低，说明 global-history 模式较弱。i_only 从未带来帮助，说明循环/迭代相位信号暴露得还不够。references/test-patterns.md 里的模式来编写下一个测试。debug/sc_table_probe/summary.csvdebug/sc_table_probe/branch_delta.csvdebug/sc_table_probe/report.mddebug/sc_table_probe/report.json--profiles：从 off,l_only,g_only,i_only,full 中选择。--tests：逗号分隔的测试名（不带后缀），例如 fp_sc_alias_pair,imli_iter。--extra-param：透传额外的 gem5 --param。--copy-cpt-to-tmp：避免路径访问问题。--skip-run：仅生成报告，不执行运行。microtage 关闭。*-riscv64-xs.txt 反汇编文件。references/test-patterns.md。