xiangshan-bug-analysis SKILL.md skillA
xiangshan-bug-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-bug-analysis@git:20260728.30913b6Pins git:20260728.30913b6 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-bugs-analyzer/xiangshan-bugs-analysis/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260728.30913b6, committed Jul 28, 2026
- Size
- 3,691 bytes
- Repository stars
- 62
- License
- none declared
Analyze XiangShan bug waveforms from FST/VCD/FSDB, logs, disassembly, and source. Use when root-causing frontend, backend, Load/Store, cache, MSHR, redirect/kill/replay, branch prediction, wrong-path, RVV, CSR, exception, interrupt, PMP/PMA, MMU, or 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 源码。 - 目标是定位 bug 根因，而不是生成新场景或重新跑仿真。 - 默认重点是前端、后端、访存、Cache、MMU、CSR 和异常路径。 - 需要精确 waveform 查询时，配合 `analyze-xiangshan-wavekit` 技能使用。 ## 工作流 1. 先归一化目标：PC、指令、寄存器、副作用、异常预期。 2. 再找波形锚点：先用日志/反汇编/commit 找到目标 PC，再沿流水线往前追。 3. 逐级看边界：每个 `valid/ready` 都要确认 `fire = valid && ready`。 4. 继续带着身份走：rename 后用 `robIdx`、`lqIdx`、`sqIdx`、物理寄存器继续追。 5. 分域追因果：前端预测/redirect、后端执行/提交、访存/cache/MSHR、MMU/PMP/PMA。 6. 最后回到架构态：commit、difftest、CSR、trap、异常目标、寄存器写回。 ## 证据规则 - 只写波形和源码共同证明的结论。 - 每个非显然判断都要有源码位置和波形周期。 - 只在波形证明时谈 redirect、kill、replay、wrong-path 或侧信道。 - 不要把 bubble 当根因；只有它解释功能现象时才记录。 ## 分域重点 ### 前端 - 关注 `FTQ -> BPU -> ICache/IFU -> ITLB -> IBuffer -> Decode`。 - 常看 `backendIPF/backendIAF/backendIGPF`、`satpFlush`、`flushPipe`、`miss`、`pf`、`af`、`gpf`。 - 重点问题：canonical address、错误路径取指、ITLB miss/PTW、redirect 后恢复、投机取指污染。 - 参考：`references/frontend-itlb.md` ### 后端 - 关注 `Decode -> Rename -> Dispatch -> ROB -> Issue -> Execute -> Writeback -> Commit`。 - 常看 `robIdx`、`ftqIdx`、`redirect`、`flushAfter`、`needFlush`、`exceptionVec`、`difftest_commit_*`。 - 重点问题：分支误判、执行单元异常、CSR/trap redirect、年轻指令清空、commit 不一致。 - 参考：`references/backend-redirect-csr.md` ### 访存 / Cache …
Read the whole file at its exact version.
How to install
mdr add openxiangshan/xiangshanlab/xiangshan-bug-analysis@sha256:47ec8eadb45a9636The line at the top of this page pins the label git:20260728.30913b6, 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_jqqpet2o7q65twth)
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 (3691 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_jqqpet2o7q65twth GET https://markdownregistry.com/api/v1/resolve?ref=openxiangshan/xiangshanlab/xiangshan-bug-analysis GET https://markdownregistry.com/api/v1/blob/47ec8eadb45a9636f8a5948b7424c9c665aad7679d494455784cd7bc44c536fe
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.