xiangshan-wave-analysis SKILL.md skillA
xiangshan-wave-analysis from openxiangshan/xiangshanlab is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add openxiangshan/xiangshanlab/xiangshan-wave-analysis@git:20260728.83c0766Pins git:20260728.83c0766 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- openxiangshan/xiangshanlab
- Path
tools/xiangshan-wave-analysis/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260728.83c0766, committed Jul 28, 2026
- Size
- 3,814 bytes
- Repository stars
- 62
- License
- none declared
Analyze XiangShan Kunminghu waveforms with disassembly, logs, and source. Use this skill for frontend, backend, Load/Store, cache, MSHR, redirect/kill/replay, branch prediction, wrong-path behavior, RVV, CSR, exceptions, interrupts, PMP/PMA, MMU, and page-table bugs.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 香山波形分析 ## 适用场景 - 目标是用波形定位香山昆明湖 bug 根因，而不是只读日志。 - 输入通常是 `FST/VCD/FSDB + 反汇编 + 仿真日志 + XiangShan 源码`。 - 默认使用 wavekit 读取波形，并以 `TOP.clock` 正沿采样，除非证据表明需要换边沿。 - 优先覆盖前端、后端、访存、Cache、MMU、CSR、异常与 RVV 问题。 ## 默认流程 1. 先归一化目标指令：PC、反汇编、寄存器、副作用、异常可能性。 2. 再找波形锚点：先从前端 PC 锚定，再沿流水线跟到 `robIdx`。 3. 逐级检查边界：每个 `valid/ready` 接口都要确认 `fire = valid && ready`。 4. 需要时分域跟踪：前端预测/redirect、后端提交/异常、访存/cache/MSHR、MMU/页表。 5. 最后回到架构态：commit、difftest、CSR、trap、寄存器写回、异常目标。 6. 结论必须由波形和源码共同证明；没有波形证据不要下结论。 ## 读波形的硬规则 - rename 之后不要只靠 PC；用 `robIdx`、`lqIdx`、`sqIdx`、物理寄存器继续跟踪。 - 访存指令要补齐 `addr/data/mask/size/signedness/aq/rl/amo`。 - redirect/kill/replay/nack/flush 都要记录源头、目标、时机和影响范围。 - wrong-path 和时序侧信道只在波形确实显示投机路径、恢复和共享资源竞争时再谈。 - 不要把性能 bubble 当成根因；只有在 bug 分析需要时才单独统计。 ## 前端重点 - 关注 `FTQ -> BPU -> ICache/IFU -> ITLB -> IBuffer -> Decode`。 - 常见信号：`backendIPF/backendIAF/backendIGPF`、`satpFlush`、`flushPipe`、`isMisPred`、`req/resp/miss/pf/af/gpf`。 - 常见问题：canonical address、错误路径取指、ITLB miss/PTW、页表刷新、重定向后恢复。 - 参考文档：`references/frontend-itlb.md`。 ## 后端重点 - 关注 `Decode -> Rename -> Dispatch -> ROB -> Issue -> Execute -> Writeback -> Commit`。 - 常见信号：`robIdx`、`ftqIdx`、`redirect`、`flushAfter`、`needFlush`、`exceptionVec`、`difftest_commit_*`。 …
Read the whole file at its exact version.
How to install
mdr add openxiangshan/xiangshanlab/xiangshan-wave-analysis@sha256:5859640554940b65The line at the top of this page pins the label git:20260728.83c0766, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fwj5aasgeeeyq5zg)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Jul 28, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3814 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
openxiangshan/xiangshanlab · 62 stars · license none declared · pushed 2026-11-06 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_fwj5aasgeeeyq5zg GET https://markdownregistry.com/api/v1/resolve?ref=openxiangshan/xiangshanlab/xiangshan-wave-analysis GET https://markdownregistry.com/api/v1/blob/5859640554940b658c5adb3b7efbecb9b5361630a546d8d5d75b63bd40600223
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.