xiangshan-bug-pipeline SKILL.md skillA
xiangshan-bug-pipeline 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-pipeline@git:20260731.b099e95Pins git:20260731.b099e95 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/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260731.b099e95, committed Jul 31, 2026
- First version recorded
- Jul 28, 2026
- Size
- 5,229 bytes
- Repository stars
- 62
- License
- none declared
End-to-end XiangShan bug pipeline: fetch GitHub issues and PRs, create per-issue bug-analysis-<issue-number> workdirs, build and run xs-env/XiangShan repros, and write waveform-based root-cause reports.
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
# XiangShan Bug Pipeline ## 适用场景 - 需要把 XiangShan 的 bug 收集、复现、波形分析和报告写作串成一条固定流程。 - 目标是对一个或多个 GitHub issue 做完整闭环，而不是只做其中某一步。 ## 总流程 ## 绝对强制执行规则 以下规则优先于本 skill 中任何关于复用、检查已有结果或节省执行时间的表述，必须逐项严格执行： - 每次复现都必须从零开始：新建本次运行专用的空工作目录，重新 `git clone` 仿真环境，重新编译仿真器，并重新运行仿真生成本次波形。 - 不得查询、检查、搜索或尝试复用任何已有的波形图、已编译仿真器、已克隆 `xs-env`/`XiangShan` 环境、已有构建目录或历史运行结果；它们不能作为跳过任何步骤的依据。 - 不得因为工作目录、`build/emu`、FST/VCD/FSDB、测试二进制或日志已存在而跳过克隆、`make init`、`make emu EMU_TRACE=fst -j12`、测试程序编译或带波形的仿真步骤。 - 本 skill 的每次执行都必须完整遵循下方步骤顺序。只有本次从零运行产生的产物，才能用于后续分析和报告。 - 允许并应在需要时直接执行任意 `git clone` 和 `curl` 命令，以完成环境初始化、源码获取、依赖下载和测试程序下载；无需因这两类命令等待额外确认。 1. 先使用 `fetch-xiangshan-bugs` skill。 - 生成或刷新 `xiangshan-bug-lib`。 - 优先读取 `README.md`、`issue-index.md`、`bug-cause-summary.md` 来筛选目标 issue。 2. 对每个目标 bug issue，新建本次运行专用的空工作目录。 - 目录名固定为 `bug-analysis-xxxx`。 - `xxxx` 必须是 GitHub issue 编号。 - 一个目录只对应一个 issue。 - 如果同名目录已存在，创建新的运行目录（例如 `bug-analysis-xxxx/fresh-run-<timestamp>`）；不得检查或复用其中的任何环境、构建产物、波形或日志。 3. 在该工作目录中搭建仿真环境。 - `git clone git@github.com:OpenXiangShan/xs-env.git` - 进入 `xs-env` 后执行 `source setup.sh` - 再进入 `XiangShan` 目录 - 按 issue 中给出的 commit hash 切换 RTL 版本 - 执行 `make init` …
Read the whole file at its exact version.
How to install
mdr add openxiangshan/xiangshanlab/xiangshan-bug-pipeline@sha256:df9ae19bf37f02a1The line at the top of this page pins the label git:20260731.b099e95, 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_yqwjylk5qq4cumpg)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jul 28, 2026 and Jul 31, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260731.b099e95 latest | 2026-07-31 | b099e95 | 5,229 B | A | view · diff |
| git:20260728.83c0766 | 2026-07-28 | 83c0766 | 3,570 B | A | view |
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 (5229 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_yqwjylk5qq4cumpg GET https://markdownregistry.com/api/v1/resolve?ref=openxiangshan/xiangshanlab/xiangshan-bug-pipeline GET https://markdownregistry.com/api/v1/blob/df9ae19bf37f02a103795e1c913284405115a1c9b7404ebe63283c14083cbf13
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.