メニュー
用于在本地通过 `gh` 远程触发 OpenXiangShan/GEM5 的 `manual-perf.yml`，并在触发后检查 run 是否正常创建。适用于用户明确要求触发 `manual-perf`、组装 `gh workflow run` 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | gem5-manual-perf-trigger |
| description | 用于在本地通过 `gh` 远程触发 OpenXiangShan/GEM5 的 `manual-perf.yml`，并在触发后检查 run 是否正常创建。适用于用户明确要求触发 `manual-perf`、组装 `gh workflow run` 命令、校验 workflow 输入项、或确认触发后的 Actions run 状态。 |
这个 skill 用于安全、可追溯地触发远端 GitHub Actions manual-perf.yml。核心目标不是只把命令发出去，而是先确认本地触发条件，再确认输入参数，再在触发后检查 run 是否真的正常创建。
当前约束：
manual-perf.yml 在本仓库上可通过 gh workflow run 触发。kmhv3.py。inputs 中存在，但当前没有实际跑通记录，触发前必须明确提醒用户这一点。优先检查 gh 是否可用：
gh --version
如果 gh 不可用：
gh。workflow_dispatch 的 curl 方案。curl 触发流程在当前仓库协作里未实际走通过，只能作为备选方案，可靠性不如 gh 已验证路径。不要在 gh 缺失时直接假设 curl 方案可用并继续执行。
检查 gh 是否已登录：
gh auth status
如果未登录，或者 token 无效：
gh auth loginrepo、workflow 权限的 token说明要点：
gh workflow run 时，推荐优先走 gh auth login在触发前，读取并核对 .github/workflows/manual-perf.yml 的 workflow_dispatch.inputs。
当前已知关键输入项：
configurationbenchmark_typespecific_benchmarksvector_typebranch当前已验证存在的配置选项：
kmhv2.pykmhv3.pyidealkmhv3.py但必须提醒用户：
manual-perf 已实际走通的是 kmhv3.py在真正触发前，必须向用户确认以下信息：
kmhv3.pygcc12-spec06-1.0cmcf,omnetppvector_type：默认 base如果用户没有给全：
如果用户要触发非 kmhv3.py 配置：
kmhv3.py 经过实际触发验证，其他配置暂未在此流程中验证”触发前先把准备执行的命令原样展示给用户，得到确认后再执行。
标准命令模板：
gh workflow run manual-perf.yml \
--repo OpenXiangShan/GEM5 \
--ref <branch> \
-f configuration=<configuration> \
-f benchmark_type=<benchmark_type> \
-f specific_benchmarks=<specific_benchmarks> \
-f vector_type=<vector_type> \
-f branch=<branch>
说明：
--ref 使用要触发的远端分支branch input 也通常填写同一个分支specific_benchmarks 可为空；为空表示按 workflow 跑该集合全部 benchmark只拿到 “Created workflow_dispatch event” 不够。触发成功后必须继续检查：
gh run view <run-id> 是否能正常读取queued、in_progress，而不是立刻 failure 或不存在建议的检查方式：
gh run view <run-id> --repo OpenXiangShan/GEM5
必要时可继续查看：
gh run view <run-id> --repo OpenXiangShan/GEM5 --json status,conclusion,url,name,headBranch,headSha
如果 run 创建失败、找不到、或立刻异常终止：
执行本 skill 时，回复应遵守以下格式约束：
gh 或认证，先阻断并提示用户处理manual-perf 当前实际走通过的是 kmhv3.py，其他配置暂未实际验证gh 未安装给出两条路径：
gh 后再触发workflow_dispatch但必须注明：
curl 路径当前未在本流程中实际走通过gh 已安装但未登录提示：
gh auth login
gh auth status
阻断执行，向用户补问：
优先检查：
workflow 权限mcf,omnetpp用户意图：
kmhv3.pygcc12-spec06-1.0cmcf,omnetppturbo-pfalign-dualPort-l2Bank-nopf先展示命令：
gh workflow run manual-perf.yml \
--repo OpenXiangShan/GEM5 \
--ref turbo-pfalign-dualPort-l2Bank-nopf \
-f configuration=kmhv3.py \
-f benchmark_type=gcc12-spec06-1.0c \
-f specific_benchmarks=mcf,omnetpp \
-f vector_type=base \
-f branch=turbo-pfalign-dualPort-l2Bank-nopf
触发后再检查 run 状态，并返回链接与状态。
当前 skill 不依赖额外 scripts/、references/、assets/。
由 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 验证时。
用于从 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 归因。