s2arm-rootfix SKILL.md skillA

s2arm-rootfix from jhaizhou-ops/s2arm is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add jhaizhou-ops/s2arm/s2arm-rootfix@git:20261108.3925321

Pins git:20261108.3925321 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: jhaizhou-ops/s2arm
Path: skills/s2arm-rootfix/SKILL.md
Versions recorded: 1
Latest version: git:20261108.3925321, committed Nov 8, 2026
Size: 4,908 bytes
Repository stars: 676
License: Apache-2.0

S2Arm 通用根修方法论：修任何缺陷、做任何会改行为的改动之前先读本 skill。规定从「这件事要证明什么」出发，先量再猜、找到给错值的机制、对齐 Ryujinx 上游真值、先写会红的单测、做负对照、报射程，最后按 PR 模板交付。具体症状的定位走 gfx-triage / native-triage 和 docs/排查/ 下的手册。.

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

# 通用根修（s2arm-rootfix）

你在为 S2Arm 修一个问题或做一处会改变行为的改动。本 skill 只管**方法和交付格式**；症状怎么定位见下面的「去哪查」。维护方审 PR 时就按这里逐条核。

## 0. 先回到本质

动手前用一两句话写下：**这次改动要证明什么、要让哪个读数从什么变成什么**。例如「让动森进局后帧率 ≥ 29.7 Hz（现在 24 Hz）」，而不是「优化一下渲染」。写不出来就是还没弄清问题，先去量。

## 1. 先量再猜

- 只信读数：`host.log` 的具体行、`frames.tsv`、功耗采样、工具报告（`docs/贡献者开发测试套件.md` 第 1 步的自查报告）。凭印象下的结论不算数。
- 一次只变一个量；A/B 两边只差你要验证的那一个改动。
- 偶发问题先复现到可重复（循环跑 N 次，记下 N 次里出现几次），再谈根因。

## 2. 找到给错值的机制，修机制不修症状

- 一直往上追，直到找到**第一个算错 / 给错值的地方**，在那里修。在下游加判断、吞异常、改阈值、加重试，都是改症状，不收。
- 服务、系统调用、着色器语义有疑问时，**以 Ryujinx 上游为真值**：先读上游同一处怎么做。我方偏离上游必须有理由，并写进 `compat/改动清单.md`；改 `compat/tree/` 要走 `compat/patches/` 新补丁（`bash compat/verify.sh` 一致）。
- 通用层零专用配置：不写死游戏地址，不按游戏名 / 程序号分支，未实现的服务报红、不返回成功兜底。

## 3. 先红后绿

1. 先写一条**在当前 main 上会红**的单测或判据，并把红日志原样存下（PR 里要贴）。
2. 期望值必须**不跑被测实现就能算出来**：手算、规格、上游行为。用被测代码自己的输出当期望，等于没测。
3. 再改代码，直到它变绿；原有单测全部照绿。
4. 能用规则或代码判定的，就不要用 LLM 判。

## 4. 负对照

把你的修复**回退**（或换成典型的错误写法），新单测必须重新变红；PR 里写明你做了哪种回退、红在哪一行。负对照不红，说明单测「绿着失效」，没有守住任何东西。

## 5. 报射程

任何「全绿 / 0 不符」都要同时写**分母**：扫了几个文件、跑了几局、多少帧、几款游戏、哪几种设备。例如「接线扫描 232 支，未接线 0」「3 款各 1 局，到 MARK，0 崩」。只写「通过」的读数，维护方按没跑处理。

## 6. 外科手术式改动

每一行改动都能追溯到这次要解决的问题。不顺手重构、不改无关文件、不重写整文件；发现别的问题写进 PR 的「限制 / 后续」，另开 issue。

## 7. 交付
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add jhaizhou-ops/s2arm/s2arm-rootfix@sha256:742a3ff02fa8ccf2

The line at the top of this page pins the label git:20261108.3925321, 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.

Badge

[![mdr](https://markdownregistry.com/badge/art_tgoxhqi7mckeryi5.svg)](https://markdownregistry.com/a/art_tgoxhqi7mckeryi5)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Nov 8, 2026.

version	committed	commit	size	audit
git:20261108.3925321 latest	2026-11-08	3925321	4,908 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (4908 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

GitHub

jhaizhou-ops/s2arm · 676 stars · license Apache-2.0 · pushed 2026-11-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tgoxhqi7mckeryi5
GET https://markdownregistry.com/api/v1/resolve?ref=jhaizhou-ops/s2arm/s2arm-rootfix
GET https://markdownregistry.com/api/v1/blob/742a3ff02fa8ccf2205e87055697df4e3518337c256100812e540199f0b672a2

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.