원클릭으로 Manus에서 모든 스킬 실행

mgsc-table-probe

스타149

포크81

업데이트2026년 4월 27일 09:28

分析香山 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 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

OpenXiangShan

OpenXiangShan/GEM5

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

MGSC 表探测

概览

运行标准化的 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

快速检查单个 case：

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

仅重建报告（不重新运行 gem5）：

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

工作流

基线 + 单表隔离 profile

始终包含 off。
在检查 full 之前，先加入单表 profile（如 g_only、i_only）。

快速筛选有价值的测试

在 summary.csv 中，优先关注满足 condMiss_delta < 0 且 mgsc_net_use > 0 的 case。

筛选有价值的分支

在 branch_delta.csv 中，优先关注满足以下条件的行：
- delta_misp < 0
- focus_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.csv
debug/sc_table_probe/branch_delta.csv
debug/sc_table_probe/report.md
debug/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：仅生成报告，不执行运行。

注意事项

除非你明确要评估交互效应，否则在做 SC 子表归因时应保持 microtage 关闭。
不同 profile 之间必须使用同一组 checkpoint，否则 delta 无效。
做 branch PC 映射时，使用 mgsc_test 构建目录下的 *-riscv64-xs.txt 反汇编文件。

参考资料

关于面向 G/IMLI 的微测试模式，参见 references/test-patterns.md。

이 저장소의 다른 Skills

같은 저장소

cpu-performance-modeling

OpenXiangShan/GEM5

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

2026-05-28149

tage-trace-workflow

OpenXiangShan/GEM5

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

2026-05-20149

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

MGSC 表探测

概览

运行标准化的 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

快速检查单个 case：

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

仅重建报告（不重新运行 gem5）：

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

工作流

基线 + 单表隔离 profile

始终包含 off。
在检查 full 之前，先加入单表 profile（如 g_only、i_only）。

快速筛选有价值的测试

在 summary.csv 中，优先关注满足 condMiss_delta < 0 且 mgsc_net_use > 0 的 case。

筛选有价值的分支

在 branch_delta.csv 中，优先关注满足以下条件的行：
- delta_misp < 0
- focus_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.csv
debug/sc_table_probe/branch_delta.csv
debug/sc_table_probe/report.md
debug/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：仅生成报告，不执行运行。

注意事项

除非你明确要评估交互效应，否则在做 SC 子表归因时应保持 microtage 关闭。
不同 profile 之间必须使用同一组 checkpoint，否则 delta 无效。
做 branch PC 映射时，使用 mgsc_test 构建目录下的 *-riscv64-xs.txt 反汇编文件。

参考资料

关于面向 G/IMLI 的微测试模式，参见 references/test-patterns.md。